aktsmm/agent-skillsCC BY-NC-SA 4.015 files

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.

Specification
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
How to use it

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 taskPrompt
Always-on or file-scoped guidanceInstruction
Persona, tool restrictions, delegationAgent
Deterministic enforcementHook
Reusable packaged workflowSkill

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

FeatureDescription
SearchLocal index + GitHub API + Web fallback
TagsFilter by category (#azure #bicep)
InstallDownload to local directory
StarMark and manage favorites
UpdateSync 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

CommandDescription
<query>Search skills by keyword
#tagFilter by category
--info SKILLShow skill details
--install SKILLDownload skill locally
--star SKILLAdd to favorites
--list-starredShow favorites
--similar SKILLFind similar skills
--updateUpdate index from sources
--add-source URLAdd new source repository
--statsShow index statistics
--checkVerify dependencies

Files

FileDescription
scripts/search_skills.pyPython script
scripts/Search-Skills.ps1PowerShell script
references/skill-index.jsonSkill index (220+ skills)
references/starred-skills.jsonYour starred skills

Requirements

→ [references/setup-guide.md](references/setup-guide.md) for installation

ToolRequired
GitHub CLI (gh)2.0+
curlAny
Python or PowerShellOne 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

TypeBadgeDescription
officialOfficialAnthropic / GitHub 公式
awesome-listCuratedキュレーションリスト
communityCommunityコミュニティ製(自己責任)

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)

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.

Use this skill