Skills Scraper
skills-builder
Build Claude Code skills from documentation websites. Scrapes Mintlify, ReadTheDocs/Sphinx, Docusaurus, GitBook, and static HTML sites. Generates properly formatted skills with SKILL.md and reference files. Use when: creating skills from docs, scraping documentation, generating reference material...
SKILL.md
Full skill instructions
Skills Scraper
Build Claude Code skills directly from documentation websites.
Quick Start
pip install requests beautifulsoup4 lxml playwright
playwright install chromium
python scripts/build.py https://mintlify.com/docs mintlify-docs
Supported Platforms
| Platform | Description | Browser |
|---|---|---|
mintlify | Mintlify-powered docs | Yes |
readthedocs | ReadTheDocs/Sphinx sites | No |
docusaurus | Docusaurus/React docs | Yes |
gitbook | GitBook-powered sites | Yes |
generic | Static HTML sites | No |
auto | Auto-detect (default) | - |
Usage
python scripts/build.py <url> <name> [options]
Options:
-o, --output- Output directory (default: ./skills)-p, --platform- Platform (default: auto)--max-pages N- Limit pages (0 = unlimited)--max-depth N- Max crawl depth (default: 10)--no-browser- Disable Playwright--no-sitemap- Disable sitemap discovery-v, --verbose- Verbose output
Examples
# Mintlify
python scripts/build.py https://resend.com/docs resend-api
# ReadTheDocs/Sphinx
python scripts/build.py https://flask.palletsprojects.com/en/stable/ flask-docs
# Docusaurus
python scripts/build.py https://reactnative.dev/docs/getting-started react-native
# GitBook
python scripts/build.py https://docs.cortex.io cortex-docs
# Static HTML
python scripts/build.py https://docs.python.org/3/ python-docs -p generic
Output Structure
skill-name/
├── SKILL.md # Metadata + instructions
└── references/ # Documentation files
├── api.md
├── getting-started.md
└── ...
Requirements
- Python 3.10+
- requests, beautifulsoup4, lxml
- playwright (for JS-rendered sites)
