name: auto-skill-generator
description: >
Generate skills from web research. Given a topic like "how to use Stripe API"
or "Prisma ORM", this skill searches for authoritative documentation, crawls the best source,
and generates a ready-to-use .md skill file. Use when: (1) User wants to create a skill
about a library/tool/API, (2) User says "create a skill for X", "make a skill about X",
or "generate skill for X", (3) User wants to capture documentation as a reusable skill.

Auto Skill Generator

Generate skills by researching and crawling authoritative documentation.

Tool: fetch_docs.py

# Search - returns all URLs with snippets
python scripts/fetch_docs.py search "Modal GPU Python documentation"

# Crawl - with domain/path filtering to stay focused
python scripts/fetch_docs.py crawl \
  --url https://modal.com/docs/guide/gpu \
  --no-external \
  --select-paths "/docs/.*" \
  --instructions "Focus on GPU setup and code examples" \
  --limit 30

Workflow

1. Search for Documentation

python scripts/fetch_docs.py search "{topic} documentation"

Returns JSON with all URLs, titles, scores, and content snippets.

2. Select Best URL

Review search results and select based on:
- Official docs: *.com/docs/, docs.*.com, *.readthedocs.io
- Content relevance: Check snippets for API docs, code examples
- Avoid: Blog posts, changelogs, marketing, glossaries

3. Crawl with Filtering

python scripts/fetch_docs.py crawl \
  --url {selected_url} \
  --no-external \
  --select-paths "/docs/.*" "/guide/.*" \
  --instructions "Focus on API methods and code examples"

Core Parameters:
| Parameter | Description |
|-----------|-------------|
| --url | Required. URL to crawl |
| --instructions | Natural language guidance for crawler |
| --limit | Total pages (default: 50) |
| --max-depth | Link depth (default: 2) |

Domain/Path Filtering (Critical):
| Parameter | Description |
|-----------|-------------|
| --no-external | Block external domains |
| --select-paths | Regex patterns to include (e.g., /docs/.*) |
| --exclude-paths | Regex patterns to exclude (e.g., /blog/.*) |
| --select-domains | Regex for allowed domains |
| --exclude-domains | Regex for blocked domains |

Quality Options:
| Parameter | Description |
|-----------|-------------|
| --extract-depth | basic (1 credit/5 URLs) or advanced (2 credits/5 URLs) |
| --format | markdown or text |
| --timeout | Seconds (10-150, default: 150) |

4. Generate Skill File

From crawled content, create:

---
name: {topic-slug}ß
description: >
  {What the skill does}. Use when: {specific triggers}.
---

# {Topic Name}

## Quick Start
## Core API
## Common Patterns

Output

• Location: ~/.claude/skills/{topic-slug}/SKILL.md
• Extract ALL code blocks from crawled content
• Keep SKILL.md under 500 lines; split to references/ if longer