Skill Builder
This skill uses the Skill Seekers MCP server, which provides 40 tools for converting knowledge sources into AI-ready skills. If the MCP tools are not available, use the CLI fallback at the bottom of this file instead — do not stop.
Prerequisites
The MCP tools below only work when the Skill Seekers MCP server is connected:
- Install the package:
pip install "skill-seekers[mcp]"
- Connect the server:
- Installed as the Skill Seekers plugin? Nothing to do — the plugin's bundled
.mcp.json starts the server automatically (it still needs step 1).
- Installed standalone (e.g. copied into
~/.claude/skills/)? Register the server once: claude mcp add skill-seekers -- python -m skill_seekers.mcp.server_fastmcp
If tools like scrape_docs or package_skill are not in your tool list, the server is not connected. Tell the user about the two steps above, and use the CLI fallback in the meantime.
When to Use This Skill
Use this skill when the user:
- Wants to create an AI skill from a documentation site, GitHub repo, PDF, video, or other source
- Needs to convert documentation into a format suitable for LLM consumption
- Wants to update or sync existing skills with their source documentation
- Needs to export skills to vector databases (Weaviate, Chroma, FAISS, Qdrant)
- Asks about scraping, converting, or packaging documentation for AI
Source Type Detection
Automatically detect the source type from user input:
| Input Pattern |
Source Type |
Tool to Use |
https://... (not GitHub/YouTube) |
Documentation |
scrape_docs |
owner/repo or github.com/... |
GitHub |
scrape_github |
*.pdf |
PDF |
scrape_pdf |
| YouTube/Vimeo URL or video file |
Video |
scrape_video |
| Local directory path |
Codebase |
scrape_codebase |
*.ipynb, *.html, *.yaml (OpenAPI), *.adoc, *.pptx, *.rss, *.1-.8 |
Various |
scrape_generic |
| JSON config file |
Unified |
Use config with scrape_docs |
Recommended Workflow
- Detect source type from the user's input
- Generate or fetch config using
generate_config or fetch_config if needed
- Estimate scope with
estimate_pages for documentation sites
- Scrape the source using the appropriate scraping tool
- Enhance with
enhance_skill if the user wants AI-powered improvements
- Package with
package_skill for the target platform
- Export to vector DB if requested using
export_to_* tools
Available MCP Tools
Config Management
generate_config — Generate a scraping config from a URLlist_configs — List available preset configsvalidate_config — Validate a config file
Scraping (use based on source type)
scrape_docs — Documentation sitesscrape_github — GitHub repositoriesscrape_pdf — PDF filesscrape_video — Video transcriptsscrape_codebase — Local code analysisscrape_generic — Jupyter, HTML, OpenAPI, AsciiDoc, PPTX, RSS, manpage, Confluence, Notion, chat
Post-processing
enhance_skill — AI-powered skill enhancementpackage_skill — Package for target platformupload_skill — Upload to platform APIinstall_skill — End-to-end install workflow
Advanced
detect_patterns — Design pattern detection in codeextract_test_examples — Extract usage examples from testsbuild_how_to_guides — Generate how-to guides from testssplit_config — Split large configs into focused skillsexport_to_weaviate, export_to_chroma, export_to_faiss, export_to_qdrant — Vector DB export
CLI Fallback (MCP server not connected)
The same pipeline is available from the command line (requires pip install skill-seekers). Run it with the Bash tool:
skill-seekers create <source> # auto-detects: URL, owner/repo, ./path, file.pdf, video URL, ...
skill-seekers package <skill_dir> --target claude # or gemini/openai/langchain/chroma/...
create covers detection, scraping, and building in one step; add --enhance-level 0 to skip AI enhancement. After it finishes, read the generated SKILL.md and summarize what was created.
1---2name: skill-builder-43description: Automatically detect source types and build AI skills using Skill Seekers. Use when the user wants to create skills from documentation, repos, PDFs, videos, or other knowledge sources.4---56# Skill Builder78This skill uses the Skill Seekers MCP server, which provides 40 tools for converting knowledge sources into AI-ready skills. If the MCP tools are not available, use the CLI fallback at the bottom of this file instead — do not stop.910## Prerequisites1112The MCP tools below only work when the Skill Seekers MCP server is connected:13141. Install the package: `pip install "skill-seekers[mcp]"`152. Connect the server:16 - Installed as the Skill Seekers plugin? Nothing to do — the plugin's bundled `.mcp.json` starts the server automatically (it still needs step 1).17 - Installed standalone (e.g. copied into `~/.claude/skills/`)? Register the server once: `claude mcp add skill-seekers -- python -m skill_seekers.mcp.server_fastmcp`1819If tools like `scrape_docs` or `package_skill` are not in your tool list, the server is not connected. Tell the user about the two steps above, and use the CLI fallback in the meantime.2021## When to Use This Skill2223Use this skill when the user:24- Wants to create an AI skill from a documentation site, GitHub repo, PDF, video, or other source25- Needs to convert documentation into a format suitable for LLM consumption26- Wants to update or sync existing skills with their source documentation27- Needs to export skills to vector databases (Weaviate, Chroma, FAISS, Qdrant)28- Asks about scraping, converting, or packaging documentation for AI2930## Source Type Detection3132Automatically detect the source type from user input:3334| Input Pattern | Source Type | Tool to Use |35|---------------|-------------|-------------|36| `https://...` (not GitHub/YouTube) | Documentation | `scrape_docs` |37| `owner/repo` or `github.com/...` | GitHub | `scrape_github` |38| `*.pdf` | PDF | `scrape_pdf` |39| YouTube/Vimeo URL or video file | Video | `scrape_video` |40| Local directory path | Codebase | `scrape_codebase` |41| `*.ipynb`, `*.html`, `*.yaml` (OpenAPI), `*.adoc`, `*.pptx`, `*.rss`, `*.1`-`.8` | Various | `scrape_generic` |42| JSON config file | Unified | Use config with `scrape_docs` |4344## Recommended Workflow45461. **Detect source type** from the user's input472. **Generate or fetch config** using `generate_config` or `fetch_config` if needed483. **Estimate scope** with `estimate_pages` for documentation sites494. **Scrape the source** using the appropriate scraping tool505. **Enhance** with `enhance_skill` if the user wants AI-powered improvements516. **Package** with `package_skill` for the target platform527. **Export to vector DB** if requested using `export_to_*` tools5354## Available MCP Tools5556### Config Management57- `generate_config` — Generate a scraping config from a URL58- `list_configs` — List available preset configs59- `validate_config` — Validate a config file6061### Scraping (use based on source type)62- `scrape_docs` — Documentation sites63- `scrape_github` — GitHub repositories64- `scrape_pdf` — PDF files65- `scrape_video` — Video transcripts66- `scrape_codebase` — Local code analysis67- `scrape_generic` — Jupyter, HTML, OpenAPI, AsciiDoc, PPTX, RSS, manpage, Confluence, Notion, chat6869### Post-processing70- `enhance_skill` — AI-powered skill enhancement71- `package_skill` — Package for target platform72- `upload_skill` — Upload to platform API73- `install_skill` — End-to-end install workflow7475### Advanced76- `detect_patterns` — Design pattern detection in code77- `extract_test_examples` — Extract usage examples from tests78- `build_how_to_guides` — Generate how-to guides from tests79- `split_config` — Split large configs into focused skills80- `export_to_weaviate`, `export_to_chroma`, `export_to_faiss`, `export_to_qdrant` — Vector DB export8182## CLI Fallback (MCP server not connected)8384The same pipeline is available from the command line (requires `pip install skill-seekers`). Run it with the Bash tool:8586```bash87skill-seekers create <source> # auto-detects: URL, owner/repo, ./path, file.pdf, video URL, ...88skill-seekers package <skill_dir> --target claude # or gemini/openai/langchain/chroma/...89```9091`create` covers detection, scraping, and building in one step; add `--enhance-level 0` to skip AI enhancement. After it finishes, read the generated `SKILL.md` and summarize what was created.
gabrielmoreira