docs: Update all remaining old command patterns to unified CLI

Updated 96 command examples across all documentation files:
- README.md: 54 updates
- QUICKSTART.md: 26 updates
- BULLETPROOF_QUICKSTART.md: 11 updates
- TROUBLESHOOTING.md: 5 updates

Changes:
- python3 cli/doc_scraper.py → skill-seekers scrape
- python3 cli/github_scraper.py → skill-seekers github
- python3 cli/pdf_scraper.py → skill-seekers pdf
- python3 cli/unified_scraper.py → skill-seekers unified
- python3 cli/enhance_skill*.py → skill-seekers enhance
- python3 cli/package_skill.py → skill-seekers package
- python3 cli/upload_skill.py → skill-seekers upload
- python3 cli/estimate_pages.py → skill-seekers estimate

Advanced tools (no entry points yet):
- python3 cli/split_config.py → python3 -m skill_seekers.cli.split_config
- python3 cli/generate_router.py → python3 -m skill_seekers.cli.generate_router
- python3 cli/package_multi.py → python3 -m skill_seekers.cli.package_multi

Result:  0 old patterns remaining in all documentation

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
yusyus
2025-11-10 21:38:11 +03:00
parent ccbf67bb80
commit 4080794eb7
4 changed files with 96 additions and 96 deletions

View File

@@ -236,7 +236,7 @@ Let's make sure everything works:
```bash
# Test the main script can run
python3 cli/doc_scraper.py --help
skill-seekers scrape --help
```
**✅ Success looks like:**
@@ -276,7 +276,7 @@ cat > configs/test.json << 'EOF'
EOF
# Run the scraper
python3 cli/doc_scraper.py --config configs/test.json
skill-seekers scrape --config configs/test.json
```
**What happens:**
@@ -299,7 +299,7 @@ Page 2/5: Editor Setup
```bash
# Use the React preset
python3 cli/doc_scraper.py --config configs/react.json --max-pages 50
skill-seekers scrape --config configs/react.json --max-pages 50
```
**⏱️ Time:** ~5 minutes
@@ -325,7 +325,7 @@ head output/test-skill/SKILL.md
```bash
# Package the skill
python3 cli/package_skill.py output/test-skill/
skill-seekers package output/test-skill/
```
**✅ Success looks like:**
@@ -363,20 +363,20 @@ You now have a working Skill Seeker installation! Here's what you can do:
ls configs/
# Try Vue.js
python3 cli/doc_scraper.py --config configs/vue.json --max-pages 50
skill-seekers scrape --config configs/vue.json --max-pages 50
# Try Django
python3 cli/doc_scraper.py --config configs/django.json --max-pages 50
skill-seekers scrape --config configs/django.json --max-pages 50
```
### Create Custom Skills
```bash
# Interactive mode - answer questions
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
# Or create config for any website
python3 cli/doc_scraper.py \
skill-seekers scrape \
--name myframework \
--url https://docs.myframework.com/ \
--description "My favorite framework"
@@ -457,7 +457,7 @@ pip3 install --user requests beautifulsoup4
**Solution:**
```bash
# Use smaller max_pages for testing
python3 cli/doc_scraper.py --config configs/react.json --max-pages 10
skill-seekers scrape --config configs/react.json --max-pages 10
# Check internet connection
ping google.com
@@ -493,10 +493,10 @@ curl -I https://docs.yoursite.com
# Your typical workflow:
# 1. Create/use a config
python3 cli/doc_scraper.py --config configs/react.json --max-pages 50
skill-seekers scrape --config configs/react.json --max-pages 50
# 2. Package it
python3 cli/package_skill.py output/react/
skill-seekers package output/react/
# 3. Upload output/react.zip to Claude

View File

@@ -14,23 +14,23 @@ pip3 install requests beautifulsoup4
**Option A: Use a Preset (Easiest)**
```bash
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
```
**Option B: Interactive Mode**
```bash
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
```
**Option C: Quick Command**
```bash
python3 cli/doc_scraper.py --name react --url https://react.dev/
skill-seekers scrape --name react --url https://react.dev/
```
**Option D: Unified Multi-Source (NEW - v2.0.0)**
```bash
# Combine documentation + GitHub code in one skill
python3 cli/unified_scraper.py --config configs/react_unified.json
skill-seekers unified --config configs/react_unified.json
```
*Detects conflicts between docs and code automatically!*
@@ -38,7 +38,7 @@ python3 cli/unified_scraper.py --config configs/react_unified.json
```bash
# LOCAL enhancement (no API key, uses Claude Code Max)
python3 cli/enhance_skill_local.py output/godot/
skill-seekers enhance output/godot/
```
**This takes 60 seconds and dramatically improves the SKILL.md quality!**
@@ -46,7 +46,7 @@ python3 cli/enhance_skill_local.py output/godot/
### Step 4: Package the Skill
```bash
python3 cli/package_skill.py output/godot/
skill-seekers package output/godot/
```
**Done!** You now have `godot.zip` ready to use.
@@ -57,25 +57,25 @@ python3 cli/package_skill.py output/godot/
```bash
# Godot Engine
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# React
python3 cli/doc_scraper.py --config configs/react.json
skill-seekers scrape --config configs/react.json
# Vue.js
python3 cli/doc_scraper.py --config configs/vue.json
skill-seekers scrape --config configs/vue.json
# Django
python3 cli/doc_scraper.py --config configs/django.json
skill-seekers scrape --config configs/django.json
# FastAPI
python3 cli/doc_scraper.py --config configs/fastapi.json
skill-seekers scrape --config configs/fastapi.json
# Unified Multi-Source (NEW!)
python3 cli/unified_scraper.py --config configs/react_unified.json
python3 cli/unified_scraper.py --config configs/django_unified.json
python3 cli/unified_scraper.py --config configs/fastapi_unified.json
python3 cli/unified_scraper.py --config configs/godot_unified.json
skill-seekers unified --config configs/react_unified.json
skill-seekers unified --config configs/django_unified.json
skill-seekers unified --config configs/fastapi_unified.json
skill-seekers unified --config configs/godot_unified.json
```
---
@@ -85,7 +85,7 @@ python3 cli/unified_scraper.py --config configs/godot_unified.json
If you already scraped once:
```bash
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# When prompted:
✓ Found existing data: 245 pages
@@ -96,7 +96,7 @@ Use existing data? (y/n): y
Or use `--skip-scrape`:
```bash
python3 cli/doc_scraper.py --config configs/godot.json --skip-scrape
skill-seekers scrape --config configs/godot.json --skip-scrape
```
---
@@ -108,11 +108,11 @@ python3 cli/doc_scraper.py --config configs/godot.json --skip-scrape
pip3 install requests beautifulsoup4
# 2. Scrape React docs with LOCAL enhancement
python3 cli/doc_scraper.py --config configs/react.json --enhance-local
skill-seekers scrape --config configs/react.json --enhance-local
# Wait 15-30 minutes (scraping) + 60 seconds (enhancement)
# 3. Package
python3 cli/package_skill.py output/react/
skill-seekers package output/react/
# 4. Use react.zip in Claude!
```
@@ -120,13 +120,13 @@ python3 cli/package_skill.py output/react/
**Alternative: Enhancement after scraping**
```bash
# 2a. Scrape only (no enhancement)
python3 cli/doc_scraper.py --config configs/react.json
skill-seekers scrape --config configs/react.json
# 2b. Enhance later
python3 cli/enhance_skill_local.py output/react/
skill-seekers enhance output/react/
# 3. Package
python3 cli/package_skill.py output/react/
skill-seekers package output/react/
```
---
@@ -144,7 +144,7 @@ Edit config file:
### Rebuild Instantly
```bash
# After first scrape, you can rebuild instantly:
python3 cli/doc_scraper.py --config configs/react.json --skip-scrape
skill-seekers scrape --config configs/react.json --skip-scrape
```
### Create Custom Config
@@ -156,7 +156,7 @@ cp configs/react.json configs/myframework.json
nano configs/myframework.json
# Use it
python3 cli/doc_scraper.py --config configs/myframework.json
skill-seekers scrape --config configs/myframework.json
```
---
@@ -187,10 +187,10 @@ See **README.md** for:
```bash
# Godot
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# Or interactive
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
```
That's it! 🚀

108
README.md
View File

@@ -410,13 +410,13 @@ source venv/bin/activate # Run this each time you start a new terminal session
source venv/bin/activate
# Optional: Estimate pages first (fast, 1-2 minutes)
python3 cli/estimate_pages.py configs/godot.json
skill-seekers estimate configs/godot.json
# Use Godot preset
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# Use React preset
python3 cli/doc_scraper.py --config configs/react.json
skill-seekers scrape --config configs/react.json
# See all presets
ls configs/
@@ -425,13 +425,13 @@ ls configs/
### Interactive Mode
```bash
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
```
### Quick Mode
```bash
python3 cli/doc_scraper.py \
skill-seekers scrape \
--name react \
--url https://react.dev/ \
--description "React framework for UIs"
@@ -448,10 +448,10 @@ Once your skill is packaged, you need to upload it to Claude:
export ANTHROPIC_API_KEY=sk-ant-...
# Package and upload automatically
python3 cli/package_skill.py output/react/ --upload
skill-seekers package output/react/ --upload
# OR upload existing .zip
python3 cli/upload_skill.py output/react.zip
skill-seekers upload output/react.zip
```
**Benefits:**
@@ -466,7 +466,7 @@ python3 cli/upload_skill.py output/react.zip
```bash
# Package skill
python3 cli/package_skill.py output/react/
skill-seekers package output/react/
# This will:
# 1. Create output/react.zip
@@ -538,7 +538,7 @@ doc-to-skill/
### 1. Fast Page Estimation (NEW!)
```bash
python3 cli/estimate_pages.py configs/react.json
skill-seekers estimate configs/react.json
# Output:
📊 ESTIMATION RESULTS
@@ -558,7 +558,7 @@ python3 cli/estimate_pages.py configs/react.json
### 2. Auto-Detect Existing Data
```bash
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# If data exists:
✓ Found existing data: 245 pages
@@ -603,23 +603,23 @@ Automatically infers categories from:
```bash
# Scrape once
python3 cli/doc_scraper.py --config configs/react.json
skill-seekers scrape --config configs/react.json
# Later, just rebuild (instant)
python3 cli/doc_scraper.py --config configs/react.json --skip-scrape
skill-seekers scrape --config configs/react.json --skip-scrape
```
### 6. Async Mode for Faster Scraping (2-3x Speed!)
```bash
# Enable async mode with 8 workers (recommended for large docs)
python3 cli/doc_scraper.py --config configs/react.json --async --workers 8
skill-seekers scrape --config configs/react.json --async --workers 8
# Small docs (~100-500 pages)
python3 cli/doc_scraper.py --config configs/mydocs.json --async --workers 4
skill-seekers scrape --config configs/mydocs.json --async --workers 4
# Large docs (2000+ pages) with no rate limiting
python3 cli/doc_scraper.py --config configs/largedocs.json --async --workers 8 --no-rate-limit
skill-seekers scrape --config configs/largedocs.json --async --workers 8 --no-rate-limit
```
**Performance Comparison:**
@@ -641,16 +641,16 @@ python3 cli/doc_scraper.py --config configs/largedocs.json --async --workers 8 -
# Option 1: During scraping (API-based, requires API key)
pip3 install anthropic
export ANTHROPIC_API_KEY=sk-ant-...
python3 cli/doc_scraper.py --config configs/react.json --enhance
skill-seekers scrape --config configs/react.json --enhance
# Option 2: During scraping (LOCAL, no API key - uses Claude Code Max)
python3 cli/doc_scraper.py --config configs/react.json --enhance-local
skill-seekers scrape --config configs/react.json --enhance-local
# Option 3: After scraping (API-based, standalone)
python3 cli/enhance_skill.py output/react/
skill-seekers enhance output/react/
# Option 4: After scraping (LOCAL, no API key, standalone)
python3 cli/enhance_skill_local.py output/react/
skill-seekers enhance output/react/
```
**What it does:**
@@ -676,10 +676,10 @@ python3 cli/enhance_skill_local.py output/react/
```bash
# 1. Estimate first (discover page count)
python3 cli/estimate_pages.py configs/godot.json
skill-seekers estimate configs/godot.json
# 2. Auto-split into focused sub-skills
python3 cli/split_config.py configs/godot.json --strategy router
python3 -m skill_seekers.cli.split_config configs/godot.json --strategy router
# Creates:
# - godot-scripting.json (5K pages)
@@ -690,15 +690,15 @@ python3 cli/split_config.py configs/godot.json --strategy router
# 3. Scrape all in parallel (4-8 hours instead of 20-40!)
for config in configs/godot-*.json; do
python3 cli/doc_scraper.py --config $config &
skill-seekers scrape --config $config &
done
wait
# 4. Generate intelligent router/hub skill
python3 cli/generate_router.py configs/godot-*.json
python3 -m skill_seekers.cli.generate_router configs/godot-*.json
# 5. Package all skills
python3 cli/package_multi.py output/godot*/
python3 -m skill_seekers.cli.package_multi output/godot*/
# 6. Upload all .zip files to Claude
# Users just ask questions naturally!
@@ -748,7 +748,7 @@ python3 cli/package_multi.py output/godot*/
}
# If scrape is interrupted (Ctrl+C or crash)
python3 cli/doc_scraper.py --config configs/godot.json --resume
skill-seekers scrape --config configs/godot.json --resume
# Resume from last checkpoint
✅ Resuming from checkpoint (12,450 pages scraped)
@@ -756,7 +756,7 @@ python3 cli/doc_scraper.py --config configs/godot.json --resume
🔄 Continuing from where we left off...
# Start fresh (clear checkpoint)
python3 cli/doc_scraper.py --config configs/godot.json --fresh
skill-seekers scrape --config configs/godot.json --fresh
```
**Benefits:**
@@ -771,14 +771,14 @@ python3 cli/doc_scraper.py --config configs/godot.json --fresh
```bash
# 1. Scrape + Build + AI Enhancement (LOCAL, no API key)
python3 cli/doc_scraper.py --config configs/godot.json --enhance-local
skill-seekers scrape --config configs/godot.json --enhance-local
# 2. Wait for new terminal to close (enhancement completes)
# Check the enhanced SKILL.md:
cat output/godot/SKILL.md
# 3. Package
python3 cli/package_skill.py output/godot/
skill-seekers package output/godot/
# 4. Done! You have godot.zip with excellent SKILL.md
```
@@ -789,11 +789,11 @@ python3 cli/package_skill.py output/godot/
```bash
# 1. Use cached data + Local Enhancement
python3 cli/doc_scraper.py --config configs/godot.json --skip-scrape
python3 cli/enhance_skill_local.py output/godot/
skill-seekers scrape --config configs/godot.json --skip-scrape
skill-seekers enhance output/godot/
# 2. Package
python3 cli/package_skill.py output/godot/
skill-seekers package output/godot/
# 3. Done!
```
@@ -804,10 +804,10 @@ python3 cli/package_skill.py output/godot/
```bash
# 1. Scrape + Build (no enhancement)
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# 2. Package
python3 cli/package_skill.py output/godot/
skill-seekers package output/godot/
# 3. Done! (SKILL.md will be basic template)
```
@@ -830,22 +830,22 @@ python3 cli/package_skill.py output/godot/
```bash
# Godot
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# React
python3 cli/doc_scraper.py --config configs/react.json
skill-seekers scrape --config configs/react.json
# Vue
python3 cli/doc_scraper.py --config configs/vue.json
skill-seekers scrape --config configs/vue.json
# Django
python3 cli/doc_scraper.py --config configs/django.json
skill-seekers scrape --config configs/django.json
# FastAPI
python3 cli/doc_scraper.py --config configs/fastapi.json
skill-seekers scrape --config configs/fastapi.json
# Ansible
python3 cli/doc_scraper.py --config configs/ansible-core.json
skill-seekers scrape --config configs/ansible-core.json
```
## 🎨 Creating Your Own Config
@@ -853,7 +853,7 @@ python3 cli/doc_scraper.py --config configs/ansible-core.json
### Option 1: Interactive
```bash
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
# Follow prompts, it will create the config for you
```
@@ -867,7 +867,7 @@ cp configs/react.json configs/myframework.json
nano configs/myframework.json
# Use it
python3 cli/doc_scraper.py --config configs/myframework.json
skill-seekers scrape --config configs/myframework.json
```
### Config Structure
@@ -918,19 +918,19 @@ output/
```bash
# Interactive mode
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
# Use config file
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# Quick mode
python3 cli/doc_scraper.py --name react --url https://react.dev/
skill-seekers scrape --name react --url https://react.dev/
# Skip scraping (use existing data)
python3 cli/doc_scraper.py --config configs/godot.json --skip-scrape
skill-seekers scrape --config configs/godot.json --skip-scrape
# With description
python3 cli/doc_scraper.py \
skill-seekers scrape \
--name react \
--url https://react.dev/ \
--description "React framework for building UIs"
@@ -951,11 +951,11 @@ Edit `max_pages` in config to test:
```bash
# Scrape once
python3 cli/doc_scraper.py --config configs/react.json
skill-seekers scrape --config configs/react.json
# Rebuild multiple times (instant)
python3 cli/doc_scraper.py --config configs/react.json --skip-scrape
python3 cli/doc_scraper.py --config configs/react.json --skip-scrape
skill-seekers scrape --config configs/react.json --skip-scrape
skill-seekers scrape --config configs/react.json --skip-scrape
```
### 3. Finding Selectors
@@ -992,7 +992,7 @@ cat output/godot/references/index.md # Categories
```bash
# Force re-scrape
rm -rf output/myframework_data/
python3 cli/doc_scraper.py --config configs/myframework.json
skill-seekers scrape --config configs/myframework.json
```
### Categories Not Good?
@@ -1004,7 +1004,7 @@ Edit the config `categories` section with better keywords.
rm -rf output/godot_data/
# Re-scrape
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
```
## 📈 Performance
@@ -1061,13 +1061,13 @@ python3 cli/doc_scraper.py --config configs/godot.json
```bash
# Try Godot
python3 cli/doc_scraper.py --config configs/godot.json
skill-seekers scrape --config configs/godot.json
# Try React
python3 cli/doc_scraper.py --config configs/react.json
skill-seekers scrape --config configs/react.json
# Or go interactive
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
```
## 📝 License

View File

@@ -123,12 +123,12 @@ FileNotFoundError: configs/react.json
2. **Use full path:**
```bash
python3 cli/doc_scraper.py --config $(pwd)/configs/react.json
skill-seekers scrape --config $(pwd)/configs/react.json
```
3. **Create missing config:**
```bash
python3 cli/doc_scraper.py --interactive
skill-seekers scrape --interactive
```
---
@@ -223,7 +223,7 @@ nano ~/.config/claude-code/mcp.json
3. **Test CLI tools directly:**
```bash
python3 cli/doc_scraper.py --help
skill-seekers scrape --help
```
---
@@ -242,7 +242,7 @@ nano ~/.config/claude-code/mcp.json
2. **Use smaller max_pages for testing:**
```bash
python3 cli/doc_scraper.py --config configs/test.json --max-pages 5
skill-seekers scrape --config configs/test.json --max-pages 5
```
3. **Increase rate_limit in config:**
@@ -386,7 +386,7 @@ ls configs/
cat ~/.config/claude-code/mcp.json
# 5. Test scraper
python3 cli/doc_scraper.py --help
skill-seekers scrape --help
# 6. Test MCP server
timeout 3 python3 mcp/server.py || echo "Server OK"