skill-finder

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 ask really calls for a skill rather than a prompt, instruction, agent, or hook. If not, 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/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
• Run commands yourself instead of showing them to users
• Include the 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

• 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)