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.
- Skill ID
- aktsmm/agent-skills/skill-finder
- Publisher
- aktsmm
- Repository
- agent-skills
- Installs
- 0
- Files
- 15
- License
- CC BY-NC-SA 4.0
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
aktsmm/agent-skills/skill-finderInstalls these files- LICENSE.txt
- SKILL.md
- assets/demo-en.mp4
- assets/demo-ja.mp4
- references/agent-instructions.md
- references/customization-routing.md
- references/setup-guide.md
- references/skill-index.json
- references/skill-index.schema.json
- references/starred-skills.json
- references/vscode-extension-design.md
- scripts/Search-Skills.ps1
- scripts/search_skills.py
- scripts/update_other_descriptions.py
- scripts/update_scientific_descriptions.py
What this skill tells the agent
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
# 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](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
{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)
More from aktsmm
Use this skill in a project
Open any RiverX project, search the Skills panel for aktsmm/agent-skills/skill-finder, and install it in one click.
