skill-finder

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

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

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