Summary
A meta skill for managing skills themselves. Search across 220+ indexed skills from local and GitHub sources, filter by tags, install directly to your project, and star favorites for later. The smart part is the recommendation gate: before showing results, it checks whether you actually need a skill or should use a prompt, instruction, agent, or hook instead. Requires GitHub CLI and either Python or PowerShell. Useful when you're building workflows and need to discover what's already out there, or when you keep forgetting which customization primitive fits your use case. The bilingual interface and trust badges for official versus community skills are nice touches.
Install to Claude Code
npx -y skills add aktsmm/agent-skills --skill skill-finder --agent claude-codeInstalls into .claude/skills of the current project.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Files
SKILL.mdView on GitHub
Skill Finder
Full-featured Agent Skills management tool.
When to Use
- Find skill, search skill, install skill, スキル検索
- Looking for skills for a specific task or domain
- Finding and installing skills locally
- Managing favorites with star feature
- Checking whether the ask really calls for a skill before recommending one
Recommendation Gate
Before searching, check whether the user really wants a skill.
| If the ask sounds like... | Prefer... |
|---|---|
| Single slash task | Prompt |
| Always-on or file-scoped guidance | Instruction |
| Persona, tool restrictions, delegation | Agent |
| Deterministic enforcement | Hook |
| Reusable packaged workflow | Skill |
If the answer is not Skill, explain that first instead of forcing a skill recommendation.
上表は「skill を勧めるべきか」の即時ゲート。primitive 選択の詳細 SSOT は agentic-workflow-guide skill。
→ references/customization-routing.md for routing patterns
Features
| Feature | Description |
|---|---|
| Search | Local index + GitHub API + Web fallback |
| Tags | Filter by category (#azure #bicep) |
| Install | Download to local directory |
| Star | Mark and manage favorites |
| Update | Sync all sources from GitHub |
Quick Start
# Search
python scripts/search_skills.py "pdf"
python scripts/search_skills.py "#azure #development"
# Management
python scripts/search_skills.py --info skill-name
python scripts/search_skills.py --install skill-name
python scripts/search_skills.py --star skill-name
# Index
python scripts/search_skills.py --update
python scripts/search_skills.py --add-source https://github.com/owner/repo
Command Reference
| Command | Description |
|---|---|
<query> | Search skills by keyword |
#tag | Filter by category |
--info SKILL | Show skill details |
--install SKILL | Download skill locally |
--star SKILL | Add to favorites |
--list-starred | Show favorites |
--similar SKILL | Find similar skills |
--update | Update index from sources |
--add-source URL | Add new source repository |
--stats | Show index statistics |
--check | Verify dependencies |
Files
| File | Description |
|---|---|
scripts/search_skills.py | Python script |
scripts/Search-Skills.ps1 | PowerShell script |
references/skill-index.json | Skill index (220+ skills) |
references/starred-skills.json | Your starred skills |
Requirements
→ references/setup-guide.md for installation
| Tool | Required |
|---|---|
GitHub CLI (gh) | 2.0+ |
| curl | Any |
| Python or PowerShell | One of them |
Agent Instructions
→ references/agent-instructions.md for complete guide
Core Rules
- Use "Do it? Yes/No?" style proposals
- NEVER show commands to users - execute silently
- ALWAYS include proposal block after search results
Search Response Format
{N} repos, {M} skills searched (last updated: {date})
| Skill | Description | Source | Trust |
| ----- | ----------- | ------ | ----- |
| ... | ... | ... | ... |
**Next?**
1. Install?
2. Details?
3. Update index? (last: {date})
4. Web search?
Trust Levels
| Type | Badge | Description |
|---|---|---|
official | Official | Anthropic / GitHub 公式 |
awesome-list | Curated | キュレーションリスト |
community | Community | コミュニティ製（自己責任） |
Source policy:
- Install skill sources over HTTPS from
github.com,raw.githubusercontent.com, orgist.github.comby default. Any other host needs explicit user approval scoped to the current session. - Before install, show the source URL, host, and the tools and network access the fetched
SKILL.mdrequires, then wait for explicit approval.
Done Criteria
- Skill vs non-skill fit checked first
- Search query returns results
- Tool and network requirements surfaced before install
- Skill installed to local directory (if requested)
- Index updated successfully (if requested)
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
