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/repoCommand 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)