| 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