Skill v1.0.0
currentAutomated scan100/100version: "1.0.0" name: skill-finder description: "Search, install, and manage Agent Skills, and help decide whether the user actually needs a skill before recommending one. Use when looking for skills, installing skills, managing your skill collection, or deciding between a skill and another customization primitive." 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.
→ [references/customization-routing.md](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
# Searchpython scripts/search_skills.py "pdf"python scripts/search_skills.py "#azure #development"# Managementpython scripts/search_skills.py --info skill-namepython scripts/search_skills.py --install skill-namepython scripts/search_skills.py --star skill-name# Indexpython scripts/search_skills.py --updatepython 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](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](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 | コミュニティ製（自己責任） |
Done Criteria
- [ ] Skill vs non-skill fit checked first
- [ ] Search query returns results
- [ ] Skill installed to local directory (if requested)
- [ ] Index updated successfully (if requested)