# Set up an Agent Skill

Give an agent a repeatable process for discovery, price checks, execution and recovery.

## Install the CLI

The Skill uses the Purrkey CLI on the machine where your agent runs. Install it first and make sure the agent can find purrkey on PATH.

```
installer="$(mktemp)" &&
curl -fsSL https://github.com/purrkey-ai/cli/releases/latest/download/install.sh -o "$installer" &&
bash "$installer" &&
rm -f "$installer" &&
export PATH="${ATX_INSTALL_DIR:-$HOME/.local/bin}:$PATH" &&
purrkey version
```

- [Windows installation](/docs/quickstart/cli#windows): Use PowerShell or download a verified release archive.

## Add the Skill to your agent

Read https://purrkey.app/SKILL.md and save it as purrkey/SKILL.md in your client's supported user Skill directory. The file is public and contains instructions, not credentials.

For Claude Code, the directory is ~/.claude/skills/purrkey/. Other clients may use a different Skill location; use the directory supported by your client.

```
mkdir -p "$HOME/.claude/skills/purrkey"
curl -fsSL 'https://purrkey.app/SKILL.md' -o "$HOME/.claude/skills/purrkey/SKILL.md"
```

- [Read the Skill](https://purrkey.app/SKILL.md): The canonical instructions shipped with Purrkey.

## Connect your account

Create a key in API keys. Replace YOUR_API_KEY with that key and run the complete command locally. The CLI verifies access before saving it. Use purrkey config instead if you prefer hidden input.

Keep real keys out of chat messages and committed files. Installing a Skill does not grant account access or authorize wallet payments.

```
purrkey keys add YOUR_API_KEY
```

- [Create an API key](/keys): Choose the tool permissions your agent needs.

## Ask for a bounded task

Discovery and inspection do not consume tool credits. Executing a selected tool may charge your balance; define the task and any spending limit you want your agent to follow.

```
Use Purrkey to find a tool for public video comments. Inspect its required inputs, price and limitations. Show me what information you need before running it.
```