skill-finder
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.
By aktsmm · 651 installs
npx skills add aktsmm/agent-skills --skill skill-finder
Source repository · Upstream listing
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](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
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
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)