claude-skill-find-skill

Multi-agent skill discovery and installation — search 4800+ skills from 14 sources and install into Claude Code, Codex, OpenCode, or Cursor from a single shared catalogue with automatic format conversion.

Install

Pick any method — they all end with /find-skill and /install-skill available in your AI agent.

Homebrew (macOS / Linux)

brew tap fockus/tap
brew install find-skill
find-skill              # runs the installer, auto-detects Claude Code / Codex / OpenCode / Cursor

pipx

pipx install find-skill
find-skill              # runs the installer

After install, find-skill also works as a standalone CLI:

find-skill              # install into detected agents (first run)
find-skill --target claude          # install for Claude Code only
find-skill --target all             # install for all 4 agents
find-skill update                   # refresh the skill catalogue
find-skill uninstall                # remove from all agents
find-skill version                  # show version

One-liner (curl)

curl -sSL https://raw.githubusercontent.com/fockus/claude-skill-find-skill/main/quick-install.sh | bash

Target a specific agent:

curl -sSL https://raw.githubusercontent.com/fockus/claude-skill-find-skill/main/quick-install.sh | bash -s -- --target claude
curl -sSL https://raw.githubusercontent.com/fockus/claude-skill-find-skill/main/quick-install.sh | bash -s -- --target opencode,cursor
curl -sSL https://raw.githubusercontent.com/fockus/claude-skill-find-skill/main/quick-install.sh | bash -s -- --target all

Manual

git clone https://github.com/fockus/claude-skill-find-skill.git ~/.claude/skills/claude-skill-find-skill
cd ~/.claude/skills/claude-skill-find-skill
./install.sh

Supported agents

All four versions read the same shared catalogue (~/.claude/skills/find-skill/cache/catalogue.json) — update once, every agent benefits.

Usage

Same commands in every agent:

/find-skill docker                     # search for "docker" (filters to current agent)
/find-skill docker --agent any         # search entire catalogue (all 4800+ skills)
/find-skill react --agent cursor       # only Cursor-compatible skills
/find-skill deploy --all               # show all matches, not just top 5
/find-skill python --limit 10 --page 2 # paginated

/install-skill fockus/skill-name                  # install into current agent
/install-skill owner/repo --target all            # install into all 4 agents
/install-skill mono-repo --name sub-skill         # pick sub-skill from mono-repo
/install-skill https://github.com/user/skill-repo # full URL
/install-skill memory-bank                         # by name (looked up in catalogue)

/find-skill flags

/install-skill flags

How it works

1. Local-first search — queries cache/catalogue.json (4835 skills, 2.5MB) offline
2. Agent filtering — each skill entry carries an agents: [...] array; results default to the current agent
3. Ranked by trust — source priority × GitHub stars (Anthropic 105K → SkillsMP marketplace at the bottom)
4. Live API fallback — if fewer than 2 local results, queries SkillsMP API (requires key)
5. Install with conversion — clones repo, detects SKILL.md (up to 4 levels deep for mono-repos), converts frontmatter per target agent

Sources (14, total: 4835 skills)

Agent distribution

Catalogue updates

Catalogue does not auto-update. Run manually:

~/.claude/skills/find-skill/update-skills-catalogue.sh

Or schedule monthly:

(crontab -l 2>/dev/null; echo "0 0 1 * * $HOME/.claude/skills/find-skill/update-skills-catalogue.sh") | crontab -

Check last update:

date -r "$(cat ~/.claude/skills/find-skill/cache/last_update.txt)"

API keys (optional)

The skill works fully offline with the local catalogue (4800+ skills). A SkillsMP key is only needed if you want:

• The live marketplace fallback (/find-skill auto-queries SkillsMP when the local catalogue has <2 results)
• 352 extra skills added to your local catalogue on the next update-skills-catalogue.sh run

How to get a SkillsMP key

1. Go to https://skillsmp.com → sign in (GitHub OAuth).
2. Open Settings → API keys → Create new key.
3. Copy the key (it looks like smp_xxxxxxxxxxxx).

How to give the key to the agent

Option A — during install. The installer (find-skill or ./install.sh) prompts you for the key in step [2/5] and writes it to the shared .env. Just paste it there.

Option B — after install (one command, works anytime):

echo 'export SKILLSMP_API_KEY="smp_YOUR_KEY_HERE"' >> ~/.claude/skills/find-skill/.env
chmod 600 ~/.claude/skills/find-skill/.env

How the agent uses it

• The key file (~/.claude/skills/find-skill/.env) is sourced automatically by update-skills-catalogue.sh before calling the SkillsMP API. You do not need to pass --api-key flags or export anything in your shell.
• The /find-skill slash-command reads the local catalogue first; it only falls through to the live API when results are thin.
• The key is stored only on your machine (chmod 600), never committed to git, and shared across all 4 agents (Claude Code, Codex, OpenCode, Cursor) from one file.

Rotating / removing the key

# Edit or remove the line manually:
$EDITOR ~/.claude/skills/find-skill/.env

# Or wipe just the key (keeps other env vars):
sed -i.bak '/SKILLSMP_API_KEY/d' ~/.claude/skills/find-skill/.env

What gets installed

Shared (single source of truth for all agents)

Per-agent (native commands/skills)

Uninstall

~/.claude/skills/claude-skill-find-skill/uninstall.sh

Options:

./uninstall.sh                          # remove from all 4 agents + shared cache
./uninstall.sh --target opencode        # remove from OpenCode only
./uninstall.sh --keep-cache             # preserve 4835-skill catalogue + SkillsMP key

Format conversion details

When /install-skill <x> --target all is run, the shared installer script converts Claude-style SKILL.md into each target's native format:

Body of the skill is preserved verbatim — only the frontmatter header is rewritten.

License

MIT