技能寻求者

Video (YouTube, Vimeo, or local file — requires skill-seekers[video])

skill-seekers video --url https://www.youtube.com/watch?v=... --name mytutorial

Extract with visual frame analysis (requires video-full deps)

skill-seekers video --url https://www.youtube.com/watch?v=... --name mytutorial --visual

Use Vision API for low-confidence OCR frames (requires ANTHROPIC_API_KEY)

skill-seekers video --url https://www.youtube.com/watch?v=... --visual --vision-ocr

📋 Prerequisites

Before you start, make sure you have:

1. Python 3.10 or higher - Download | Check: python3 --version
2. Git - Download | Check: git --version
3. 15-30 minutes for first-time setup

First time user? → Start Here: Bulletproof Quick Start Guide 🎯

---

1. Install

pip install skill-seekers

First time? Auto-install GPU-aware visual deps:

skill-seekers video --setup

For AI Skill Builders (Claude, Gemini, OpenAI)

• 🎯 Production-grade Skills — 500+ line SKILL.md files with code examples, patterns, and guides
• 🔄 Enhancement Workflows — Apply security-focus, architecture-comprehensive, or custom YAML presets
• 🎮 Any Domain — Game engines (Godot, Unity), frameworks (React, Django), internal tools
• 🔧 Teams — Combine internal docs + code into a single source of truth
• 📚 Quality — AI-enhanced with examples, quick reference, and navigation guidance

For RAG Builders & AI Engineers

• 🤖 RAG-ready data — Pre-chunked LangChain Documents, LlamaIndex TextNodes, Haystack Documents
• 🚀 99% faster — Days of preprocessing → 15–45 minutes
• 📊 Smart metadata — Categories, sources, types → better retrieval accuracy
• 🔄 Multi-source — Combine docs + GitHub + PDFs + videos in one pipeline
• 🌐 Platform-agnostic — Export to any vector DB or framework without re-scraping

Install with Gemini support

pip install skill-seekers[gemini]

Install with OpenAI support

pip install skill-seekers[openai]

Install with MiniMax support

pip install skill-seekers[minimax]

Install with all LLM platforms

pip install skill-seekers[all-llms] ```

Install to Claude Code

cp -r output/skill-seekers ~/.claude/skills/ ```

What you get: - ✅ Complete skill documentation - All CLI commands and usage patterns - ✅ CLI command reference - Every tool and its options documented - ✅ Quick start examples - Common workflows and best practices - ✅ Auto-generated API docs - Code analysis, patterns, and examples

📦 Installation

```bash

Basic install (documentation scraping, GitHub analysis, PDF, packaging)

pip install skill-seekers

Installation Options

Video visual deps (GPU-aware): After installing skill-seekers[video-full], run skill-seekers video --setup to auto-detect your GPU and install the correct PyTorch variant + easyocr. This is the recommended way to install visual extraction dependencies.

---

🚀 One-Command Install Workflow

The fastest way to go from config to uploaded skill - complete automation:

```bash

Install React skill from official configs (auto-uploads to Claude)

skill-seekers install --config react

Install from local config file

skill-seekers install --config configs/custom.json

Install without uploading (package only)

skill-seekers install --config django --no-upload

Scanned PDFs (requires: pip install pytesseract Pillow)

skill-seekers pdf --pdf docs/scanned.pdf --name myskill --ocr ```

Install video support

pip install skill-seekers[video] # Transcripts + metadata pip install skill-seekers[video-full] # + Whisper + visual frame extraction

Auto-detect GPU and install visual deps (PyTorch + easyocr)

skill-seekers video --setup

Re-build skill from previously extracted data (skip download)

skill-seekers video --from-json output/mytutorial/video_data/extracted_data.json --name mytutorial ```

Full guide: See docs/VIDEO_GUIDE.md for complete CLI reference, visual pipeline details, AI enhancement options, and troubleshooting.

🤖 Installing to AI Agents

Skill Seekers can automatically install skills to 19 AI coding agents.

```bash

Install to specific agent

skill-seekers install-agent output/react/ --agent cursor

Install to IBM Bob (project-local .bob/skills/)

skill-seekers install-agent output/react/ --agent bob

Install to all agents at once

skill-seekers install-agent output/react/ --agent all

Preview without installing

skill-seekers install-agent output/react/ --agent cursor --dry-run ```

Getting Started

• BULLETPROOF_QUICKSTART.md - 🎯 START HERE if you're new!
• QUICKSTART.md - Quick start for experienced users
• TROUBLESHOOTING.md - Common issues and solutions
• docs/QUICK_REFERENCE.md - One-page cheat sheet

🚀 Quick Start (3 Commands)

```bash

Copy to your project (example for Cursor)

cp output/django-claude/SKILL.md my-project/.cursorrules

Usage Examples

Guides

• docs/LARGE_DOCUMENTATION.md - Handle 10K-40K+ page docs
• ASYNC_SUPPORT.md - Async mode guide (2-3x faster scraping)
• docs/ENHANCEMENT_MODES.md - AI enhancement modes guide
• docs/MCP_SETUP.md - MCP integration setup
• docs/UNIFIED_SCRAPING.md - Multi-source scraping
• docs/VIDEO_GUIDE.md - Video extraction guide

Integration Guides

• docs/integrations/LANGCHAIN.md - LangChain RAG
• docs/integrations/CURSOR.md - Cursor IDE
• docs/integrations/WINDSURF.md - Windsurf IDE
• docs/integrations/CLINE.md - Cline (VS Code)
• docs/integrations/RAG_PIPELINES.md - All RAG pipelines

---

Option 1: Official Anthropic API (default)

export ANTHROPIC_API_KEY=sk-ant-...

Option 2: GLM-4.7 Claude-compatible API

export ANTHROPIC_API_KEY=your-glm-47-api-key export ANTHROPIC_BASE_URL=https://glm-4-7-endpoint.com/v1

All AI enhancement features will use the configured endpoint

skill-seekers enhance output/react/ skill-seekers analyze --directory . --enhance

**Note**: Setting `ANTHROPIC_BASE_URL` allows you to use any Claude-compatible API endpoint, such as GLM-4.7 (智谱 AI) or other compatible services.

</details>

**Installation:**

Configure in ~/.continue/config.json

```

Integration Hub: All AI System Integrations

---

🔐 Smart Rate Limit Management & Configuration

• ✅ Multi-Token Configuration System - Manage multiple GitHub accounts (personal, work, OSS)
• Secure config storage at ~/.config/skill-seekers/config.json (600 permissions)
• Per-profile rate limit strategies: prompt, wait, switch, fail
• Configurable timeout per profile (default: 30 min, prevents indefinite waits)
• Smart fallback chain: CLI arg → Env var → Config file → Prompt
• API key management for Claude, Gemini, OpenAI
• ✅ Interactive Configuration Wizard - Beautiful terminal UI for easy setup
• Browser integration for token creation (auto-opens GitHub, etc.)
• Token validation and connection testing
• Visual status display with color coding
• ✅ Intelligent Rate Limit Handler - No more indefinite waits!
• Upfront warning about rate limits (60/hour vs 5000/hour)
• Real-time detection from GitHub API responses
• Live countdown timers with progress
• Automatic profile switching when rate limited
• Four strategies: prompt (ask), wait (countdown), switch (try another), fail (abort)
• ✅ Resume Capability - Continue interrupted jobs
• Auto-save progress at configurable intervals (default: 60 sec)
• List all resumable jobs with progress details
• Auto-cleanup of old jobs (default: 7 days)
• ✅ CI/CD Support - Non-interactive mode for automation
• --non-interactive flag fails fast without prompts
• --profile flag to select specific GitHub account
• Clear error messages for pipeline logs

Quick Setup: ```bash

One-time configuration (5 minutes)

skill-seekers config --github

🔐 Private Config Repositories

• ✅ Git-Based Config Sources - Fetch configs from private/team git repositories
• ✅ Multi-Source Management - Register unlimited GitHub, GitLab, Bitbucket repos
• ✅ Team Collaboration - Share custom configs across 3-5 person teams
• ✅ Enterprise Support - Scale to 500+ developers with priority-based resolution
• ✅ Secure Authentication - Environment variable tokens (GITHUB_TOKEN, GITLAB_TOKEN)
• ✅ Intelligent Caching - Clone once, pull updates automatically
• ✅ Offline Mode - Work with cached configs when offline

Quick scrape without config

skill-seekers scrape --url https://react.dev --name react

Use existing unified configs

skill-seekers unified --config configs/react_unified.json skill-seekers unified --config configs/django_unified.json

Or create unified config

cat > configs/myframework_unified.json << 'EOF' { "name": "myframework", "merge_mode": "rule-based", "sources": [ { "type": "documentation", "base_url": "https://docs.myframework.com/", "max_pages": 200 }, { "type": "github", "repo": "owner/myframework", "code_analysis_depth": "surface" } ] } EOF

skill-seekers unified --config configs/myframework_unified.json ```

Conflict Detection automatically finds: - 🔴 Missing in code (high): Documented but not implemented - 🟡 Missing in docs (medium): Implemented but not documented - ⚠️ Signature mismatch: Different parameters/types - ℹ️ Description mismatch: Different explanations

Full Guide: See docs/UNIFIED_SCRAPING.md for complete documentation.

Private Config Repositories

Share custom configs across teams using private git repositories:

```bash

Option 1: Using MCP tools (recommended)

Fetch config from team repo

fetch_config(source="team", config_name="internal-api") ```

Supported Platforms: - GitHub (GITHUB_TOKEN), GitLab (GITLAB_TOKEN), Gitea (GITEA_TOKEN), Bitbucket (BITBUCKET_TOKEN)

Full Guide: See docs/GIT_CONFIG_SOURCES.md for complete documentation.

Option 1: Automatic Upload (API-based)

```bash

Option 2: Manual Upload (No API Key)

```bash

Option 3: MCP (Claude Code)

In Claude Code, just ask:
"Package and upload the React skill"

---

Auto-configure all agents at once

./setup_mcp.sh ```

All 26 tools available: - Core (9): list_configs, generate_config, validate_config, estimate_pages, scrape_docs, package_skill, upload_skill, enhance_skill, install_skill - Extended (10): scrape_github, scrape_pdf, unified_scrape, merge_sources, detect_conflicts, add_config_source, fetch_config, list_config_sources, remove_config_source, split_config - Vector DB (4): export_to_chroma, export_to_weaviate, export_to_faiss, export_to_qdrant - Cloud (3): cloud_upload, cloud_download, cloud_list

Full Guide: docs/MCP_SETUP.md

---

⚙️ Configuration

Creating Your Own Config

```bash

Option 1: Interactive

skill-seekers scrape --interactive

Option 2: Copy and edit a preset

cp configs/react.json configs/myframework.json nano configs/myframework.json skill-seekers scrape --config configs/myframework.json ```

Config File Structure

{
  "name": "myframework",
  "description": "When to use this skill",
  "base_url": "https://docs.myframework.com/",
  "selectors": {
    "main_content": "article",
    "title": "h1",
    "code_blocks": "pre code"
  },
  "url_patterns": {
    "include": ["/docs", "/guide"],
    "exclude": ["/blog", "/about"]
  },
  "categories": {
    "getting_started": ["intro", "quickstart"],
    "api": ["api", "reference"]
  },
  "rate_limit": 0.5,
  "max_pages": 500
}

Where to Store Configs

The tool searches in this order: 1. Exact path as provided 2. ./configs/ (current directory) 3. ~/.config/skill-seekers/configs/ (user config directory) 4. SkillSeekersWeb.com API (preset configs)

---

Or configure multiple profiles

skill-seekers config --github ```

---

OpenAPI spec

skill-seekers create openapi.yaml

🌐 Documentation Scraping

• ✅ Smart SPA Discovery - Three-layer discovery for JavaScript SPA sites (sitemap.xml → llms.txt → headless browser rendering)
• ✅ llms.txt Support - Automatically detects and uses LLM-ready documentation files (10x faster)
• ✅ Universal Scraper - Works with ANY documentation website
• ✅ Smart Categorization - Automatically organizes content by topic
• ✅ Code Language Detection - Recognizes Python, JavaScript, C++, GDScript, etc.
• ✅ 24+ Ready-to-Use Presets - Godot, React, Vue, Django, FastAPI, and more

🔄 Unified Multi-Source Scraping

• ✅ Combine Multiple Sources - Mix documentation + GitHub + PDF in one skill
• ✅ Conflict Detection - Automatically finds discrepancies between docs and code
• ✅ Intelligent Merging - Rule-based or AI-powered conflict resolution
• ✅ Transparent Reporting - Side-by-side comparison with ⚠️ warnings
• ✅ Documentation Gap Analysis - Identifies outdated docs and undocumented features
• ✅ Single Source of Truth - One skill showing both intent (docs) and reality (code)
• ✅ Backward Compatible - Legacy single-source configs still work

→ output/django-markdown/SKILL.md + references/

```

Complete RAG Pipeline Guide: RAG Pipelines Documentation

---

Documentation Scraping

```bash

Basic repository scraping

skill-seekers github --repo facebook/react

Unified Multi-Source Scraping

Combine documentation + GitHub + PDF into one unified skill with conflict detection:

```bash

Set your API key (one-time)

export ANTHROPIC_API_KEY=sk-ant-...

Check if API key is set

echo $ANTHROPIC_API_KEY

Try LOCAL mode instead (uses Claude Code Max, no API key needed)

skill-seekers enhance output/react/ --mode LOCAL

3. Package for your AI platform

skill-seekers package output/django --target claude

**That's it!** You now have `output/django-claude.zip` ready to use.

Local HTML file (auto-detected by extension)

skill-seekers create page.html

Package for multiple platforms

for platform in claude gemini openai langchain; do skill-seekers package output/django --target $platform done ```

🔗 RAG Framework Integrations

• ✅ LangChain Documents - Direct export to Document format with page_content + metadata
• Perfect for: QA chains, retrievers, vector stores, agents
• Example: LangChain RAG Pipeline
• Guide: LangChain Integration

• ✅ LlamaIndex TextNodes - Export to TextNode format with unique IDs + embeddings
• Perfect for: Query engines, chat engines, storage context
• Example: LlamaIndex Query Engine
• Guide: LlamaIndex Integration

• ✅ Pinecone-Ready Format - Optimized for vector database upsert
• Perfect for: Production vector search, semantic search, hybrid search
• Example: Pinecone Upsert
• Guide: Pinecone Integration

Quick Export: ```bash

🧠 AI Coding Assistant Integrations

Transform any framework documentation into expert coding context for 4+ AI assistants:

• ✅ Cursor IDE - Generate .cursorrules for AI-powered code suggestions
• Perfect for: Framework-specific code generation, consistent patterns
• Works with: Cursor IDE (VS Code fork)
• Guide: Cursor Integration
• Example: Cursor React Skill

• ✅ Windsurf - Customize Windsurf's AI assistant context with .windsurfrules
• Perfect for: IDE-native AI assistance, flow-based coding
• Works with: Windsurf IDE by Codeium
• Guide: Windsurf Integration
• Example: Windsurf FastAPI Context

• ✅ Cline (VS Code) - System prompts + MCP for VS Code agent
• Perfect for: Agentic code generation in VS Code
• Works with: Cline extension for VS Code
• Guide: Cline Integration
• Example: Cline Django Assistant

• ✅ Continue.dev - Context servers for IDE-agnostic AI
• Perfect for: Multi-IDE environments (VS Code, JetBrains, Vim), custom LLM providers
• Works with: Any IDE with Continue.dev plugin
• Guide: Continue Integration
• Example: Continue Universal Context

Quick Export for AI Coding Tools: ```bash

🔄 Enhancement Workflow Presets

Reusable YAML-defined enhancement pipelines that control how AI transforms your raw documentation into a polished skill.

• ✅ 5 Bundled Presets — default, minimal, security-focus, architecture-comprehensive, api-documentation
• ✅ User-Defined Presets — add custom workflows to ~/.config/skill-seekers/workflows/
• ✅ Multiple Workflows — chain two or more workflows in one command
• ✅ Fully Managed CLI — list, inspect, copy, add, remove, and validate workflows

```bash

Apply a single workflow

skill-seekers create ./my-project --enhance-workflow security-focus

Chain multiple workflows (applied in order)

skill-seekers create ./my-project \ --enhance-workflow security-focus \ --enhance-workflow minimal

📦 Marketplace Pipeline

• ✅ Publish to Marketplace - Publish skills to Claude Code plugin marketplace repos
• ✅ End-to-End Pipeline - From documentation source to published marketplace entry

Preview workflow without executing

skill-seekers install --config react --dry-run

**Time:** 20-45 minutes total | **Quality:** Production-ready (9/10) | **Cost:** Free

**Phases executed:**

Requirements: - ANTHROPIC_API_KEY environment variable (for auto-upload) - Claude Code Max plan (for local AI enhancement), or use --agent to select a different AI agent

---

Package and upload automatically

skill-seekers package output/react/ --upload

Package skill

skill-seekers package output/react/

🔌 MCP Integration (26 Tools)

Skill Seekers ships an MCP server for use from Claude Code, Cursor, Windsurf, VS Code + Cline, or IntelliJ IDEA.

```bash

Quick Platform Comparison

---

stdio mode (Claude Code, VS Code + Cline)

python -m skill_seekers.mcp.server_fastmcp

Set a GitHub token (5000 req/hour vs 60/hour anonymous)

export GITHUB_TOKEN=ghp_your_token_here

🐛 Troubleshooting