jmagly/aiwg/doc-splitter

# Quick estimation with skill-seekers
skill-seekers estimate configs/large-docs.json
 
# Output:
# 📊 ESTIMATION RESULTS
# ✅ Pages Discovered: 28,450
# 📈 Estimated Total: 32,000
# ⏱️  Time Elapsed: 2.1 minutes
# 💡 Recommended: Split into 6-7 sub-skills

# Identify natural category boundaries
skill-seekers analyze --config configs/large-docs.json --categories
 
# Output:
# Categories detected:
# - scripting: 8,200 pages
# - 2d: 5,400 pages
# - 3d: 9,100 pages
# - physics: 4,300 pages
# - networking: 2,800 pages
# - editor: 2,200 pages

# Category-based split
skill-seekers split --config configs/godot.json --strategy category
 
# Router-based split (recommended for large docs)
skill-seekers split --config configs/godot.json --strategy router
 
# Size-based split
skill-seekers split --config configs/godot.json --strategy size --pages-per-skill 5000

{
  "name": "godot",
  "max_pages": 40000,
  "split_strategy": "router",
  "split_config": {
    "target_pages_per_skill": 5000,
    "create_router": true,
    "categories": {
      "scripting": {
        "patterns": ["/scripting/", "/gdscript/", "/c_sharp/"],
        "max_pages": 8000
      },
      "2d": {
        "patterns": ["/2d/", "/sprite/", "/tilemap/"],
        "max_pages": 6000
      },
      "3d": {
        "patterns": ["/3d/", "/mesh/", "/spatial/"],
        "max_pages": 10000
      },
      "physics": {
        "patterns": ["/physics/", "/collision/", "/rigidbody/"],
        "max_pages": 5000
      }
    }
  }
}

# Scrape all sub-skills in parallel
for config in configs/godot-*.json; do
  skill-seekers scrape --config $config &
done
wait
 
# Or sequentially with progress
for config in configs/godot-*.json; do
  echo "Processing: $config"
  skill-seekers scrape --config $config
done

# Auto-generate router from sub-skills
skill-seekers generate-router configs/godot-*.json
 
# Creates godot-router skill that intelligently routes queries

# Check sub-skill sizes
for dir in output/godot-*/; do
  echo "$dir: $(find $dir -name "*.md" | wc -l) files"
done
 
# Verify router coverage
cat output/godot-router/SKILL.md | grep -A 50 "## Sub-Skills"

checkpoints/doc-splitter/
├── estimation.json         # Page count results
├── category_analysis.json  # Category breakdown
├── split_plan.json         # Planned split configuration
├── progress/
│   ├── godot-scripting.json
│   ├── godot-2d.json
│   └── ...
└── router_draft.md         # Router skill draft

configs/
├── godot.json              # Original config
├── godot-scripting.json    # Generated sub-config
├── godot-2d.json
├── godot-3d.json
├── godot-physics.json
└── godot-router.json       # Router config
 
output/
├── godot-scripting/        # Sub-skill
│   ├── SKILL.md
│   └── references/
├── godot-2d/               # Sub-skill
├── godot-3d/               # Sub-skill
├── godot-physics/          # Sub-skill
└── godot-router/           # Router skill
    ├── SKILL.md            # Routing logic
    └── references/
        └── routing-table.md

# Godot Documentation Router
 
## Purpose
Route queries to the appropriate specialized Godot sub-skill.
 
## Sub-Skills
 
| Topic | Skill | Coverage |
|-------|-------|----------|
| GDScript, C#, scripting patterns | godot-scripting | 8,200 pages |
| 2D graphics, sprites, tilemaps | godot-2d | 5,400 pages |
| 3D graphics, meshes, materials | godot-3d | 9,100 pages |
| Physics, collisions, rigid bodies | godot-physics | 4,300 pages |
 
## Routing Rules
 
1.**Scripting questions** → godot-scripting
   -Keywords: script, gdscript, c#, function, variable, class
 
2.**2D graphics questions** → godot-2d
   -Keywords: sprite, 2d, tilemap, animation2d, canvas
 
3.**3D graphics questions** → godot-3d
   -Keywords: mesh, 3d, spatial, material, shader, camera3d
 
4.**Physics questions** → godot-physics
   -Keywords: physics, collision, rigidbody, area, raycast
 
## Usage
 
Ask your question naturally. This router will direct you to the appropriate specialized skill.
 
Example:
-"How do I create a player movement script?" → godot-scripting
-"How do I set up tilemap collisions?" → godot-2d
-"How do I apply materials to a mesh?" → godot-3d