skill-finder — Claude Code skill: what it does, how to install
Finds and installs agent skills from GitHub while checking whether your task truly demands a skill over a simple prompt.
npx skills add aktsmm/Agent-Skills --skill skill-finder -a claude-codeWhat skill-finder does
This skill organizes discovery and setup for assistant capabilities across GitHub and local catalogs. It starts with an initial triage step. Before looking up packages, it verifies whether the goal actually calls for a skill or if a basic instruction fits better.
Searches scan keyword indexes and category tags using references/skill-index.json or live GitHub API lookups. The runner tags each result with an origin badge. Before saving anything locally, it inspects permissions and asks for explicit approval.
Running the scripts requires curl alongside GitHub CLI 2.0+. You will also need Python or PowerShell. Missing gh breaks repository fetching and index synchronization.
What it helps with
- locate agent skills matching a specific workflow or tag
- determine whether an instruction works better than a skill
- download vetted skill files into the local workspace
- track favorite extensions and update local index records
Example prompts for the agent
- Find a skill for managing Azure infrastructure
- Inspect the details for pdf-parser and install it locally
- Sync the skills index and list my starred items
How to install skill-finder
1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill skill-finder -a claude-code2Manually: put the files in place
~/.claude/skills/skill-finder/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/skill-finder/
1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill skill-finder -a codex2Manually: put the files in place
.agents/skills/skill-finder/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill skill-finder -a cursor2Manually: put the files in place
.cursor/skills/skill-finder/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aktsmm/Agent-Skills skill-finder2Manually: put the files in place
.github/skills/skill-finder/SKILL.md1Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill skill-finder -a gemini-cli2Platform CLI
gemini skills install https://github.com/aktsmm/Agent-Skills --path skill-finderManually: put the files in place
.devin/skills/skill-finder/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aktsmm/Agent-Skills --skill skill-finder -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-finder
How do I install skill-finder in Claude Code?
Run npx skills add aktsmm/Agent-Skills --skill skill-finder -a claude-code in your terminal. This saves the skill configuration to ~/.claude/skills/skill-finder/SKILL.md.
What does skill-finder do?
It searches catalogued agent skills, grades their source trust levels, and installs them locally. It also evaluates whether your task can be solved with a simple prompt instead of a new dependency.
What prerequisites are required for skill-finder?
You need curl, GitHub CLI version 2.0 or higher, and either Python or PowerShell available in your terminal path.
