SKILL.md
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 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/repoCommand Reference
| Command | Description |
|---|---|
| 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 | コミュニティ製（自己責任） |
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)