| name | skill-finder |
| description | Search, install, and manage Agent Skills locally and from GitHub, then help decide whether the task really needs a skill or another customization primitive. Use when looking for skills, installing skills, managing a skill collection, or choosing between a skill, prompt, instruction, or agent. |
| argument-hint | 探したい skill の用途やキーワード |
| user-invocable | true |
| license | CC BY-NC-SA 4.0 |
| metadata | {"author":"yamapan (https://github.com/aktsmm)"} |
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
python scripts/search_skills.py "pdf"
python scripts/search_skills.py "#azure #development"
python scripts/search_skills.py --info skill-name
python scripts/search_skills.py --install skill-name
python scripts/search_skills.py --star skill-name
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, or gist.github.com by 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.md requires, then wait for explicit approval.
Done Criteria
