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.

→ 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

コミュニティ製（自己責任）

Done Criteria

• Skill vs non-skill fit checked first

• Search query returns results

• Skill installed to local directory (if requested)

• Index updated successfully (if requested)