Fetch and display full SKILL.md content

python scripts/find.py "python" --fetch --limit 2


## Output

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

silence-detect Location: https://github.com/user/audio-tools Description: Detects silence gaps in audio files using ffmpeg...
audio-silence Location: ~/skills/audio-silence Description: Find silent regions in recordings...


## Configuration

Edit `scripts/config.json`:

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

Config Options

Field	Description
`local_paths`	Local folders to search for skills
`github.enabled`	Enable/disable GitHub search
`github.topic`	Topic to search for (default: `agentskills`)
`github.repos`	Your personal skill repos (always searched first)

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 file in the project root:

GITHUB_TOKEN=ghp_xxxxxxxxxxxx

Or set environment variables: GITHUB_TOKEN or GH_TOKEN

To create a token:

Go to GitHub → Settings → Developer settings → Personal access tokens
Generate new token with repo scope (for private repos) or public_repo (for public only)

What It Searches

Local folders — Scans configured paths for directories containing SKILL.md
Your repos — Searches repos listed in github.repos config (fast, reliable)
Topic search — Searches public repos with topic agentskills
Code search — Finds SKILL.md files containing your search terms

After Finding

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

Options

Flag	Effect
`--local-only`	Skip GitHub, search only local folders
`--json`	Output as JSON for parsing
`--fetch`	Fetch and display full SKILL.md content
`--limit N`	Maximum results (default: 10)

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

find-skill

Find Skill

When to Use

Usage