"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 materials from URLs.

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)