Documentation

Set up an Agent Skill

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

View as Markdown
On this page

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.

Bash · macOS / Linux
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

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.

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

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.

Shell
purrkey keys add YOUR_API_KEY

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.

Prompt
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.