Docs refresh
Refresh documentation with deterministic generation from source files. Use when user says /docs-refresh.From its SKILL.md
npx -y skills add genlayerlabs/skills --skill docs-refreshAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 19 stars19 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
1.6 KB, as published. Nobody here has run it
Docs Refresh
Purpose
Keep generated documentation in sync with source files. Manages skill reference documentation and project-level Claude instructions.
Quick Reference
- Manages:
docs/skills/REFERENCE.md,CLAUDE.md(skills table) - Sources:
.claude/skills/*/skill.yaml - Stop hook:
task claude:validate-skill -- --skill docs-refresh
Commands
# Regenerate all documentation
task docs:refresh
# Check if docs are in sync (CI mode)
task docs:refresh-check
# Regenerate skills reference only
task claude:skills-reference
Outputs
| Artifact | Purpose |
|---|---|
docs/skills/REFERENCE.md | Generated skill inventory with patterns and ownership |
CLAUDE.md | Project instructions for Claude (includes skills table) |
CLAUDE.md Skills Table
The skills table in CLAUDE.md lists all skills and when to use them. When adding/removing skills:
- Update the skills table in
CLAUDE.md - Run
task docs:refreshto regenerate REFERENCE.md - Commit both files together
When It Fails
- Skill reference out of sync: Run
task docs:refreshto regenerate - Skill YAML invalid: Fix syntax errors in skill.yaml files
Automation
See skill.yaml for the full procedure and patterns.
See sharp-edges.yaml for common failure modes.