Docs Refresh
Purpose
Auto-generate docs/skills/REFERENCE.md from skill.yaml files and keep the CLAUDE.md skills table in sync between <!-- SKILLS_TABLE_START --> / <!-- SKILLS_TABLE_END --> markers.
Quick Reference
task docs:refresh # Generate REFERENCE.md + update CLAUDE.md table
task docs:refresh-check # Verify docs are in sync (CI gate)
task claude:skills-reference # Generate REFERENCE.md only
Pipeline
generate-skill-reference.shreads all.claude/skills/*/skill.yamland writesdocs/skills/REFERENCE.mdupdate-claude-md.shreads skill.yaml files and updates the table between CLAUDE.md markersdocs-refresh-check.shregenerates both to temp and diffs against committed versions
When to Run
- After creating, renaming, or removing a skill
- After changing a skill's
description,kind, orwhen_to_usein skill.yaml - Before committing skill changes (Stop hook runs automatically)
Automation
See skill.yaml for patterns, ownership, and anti-patterns.
See sharp-edges.yaml for common failure modes.