Find Skill

Search for Agent Skills across local folders and GitHub.

When to Use

You need a capability. Before building it, search. Someone may have already made it.

Usage

# Search for a skill
python scripts/find.py "detect silence in audio"

# Local only (offline)
python scripts/find.py "resize images" --local-only

# JSON output for programmatic use
python scripts/find.py "send email" --json

# Fetch and display full SKILL.md content
python scripts/find.py "python" --fetch --limit 2

Output

Found 2 skill(s) for "silence detection":

1. silence-detect
   Location: https://github.com/user/audio-tools
   Description: Detects silence gaps in audio files using ffmpeg...

2. audio-silence
   Location: ~/skills/audio-silence
   Description: Find silent regions in recordings...

Configuration

Edit

scripts/config.json

{
  "local_paths": ["~/skills/", "./skills/"],
  "github": {
    "enabled": true,
    "topic": "agentskills",
    "repos": [
      "your-username/your-skills-monorepo"
    ]
  }
}

Config Options

local_paths

github.enabled

github.topic

agentskills

github.repos

GitHub Token (Recommended)

A GitHub token provides higher rate limits (5000/hour vs 60/hour) and is required for searching private repos.

Create a

.env

GITHUB_TOKEN=ghp_xxxxxxxxxxxx

Or set environment variables:

GITHUB_TOKEN

GH_TOKEN

To create a token:

1. Go to GitHub → Settings → Developer settings → Personal access tokens
2. Generate new token with

   repo

   scope (for private repos) or

   public_repo

   (for public only)

What It Searches

1. Local folders — Scans configured paths for directories containing SKILL.md
2. Your repos — Searches repos listed in

   github.repos

   config (fast, reliable)
3. Topic search — Searches public repos with topic

   agentskills

4. Code search — Finds SKILL.md files containing your search terms

After Finding

1. Read the description—is this what you need?
2. Clone or fetch the skill
3. Read the full SKILL.md before executing
4. Run in your environment

Options

--local-only

--json

--fetch

--limit N

Notes

• This skill searches only; it does not execute found skills
• GitHub search requires network access
• With token: 5000 requests/hour. Without: 60 requests/hour
• Local search works offline