Documentation Updates
<analysis> Identify: What library content changed? Scope: library skills (`skills/`), commands (`commands/`), agents (`agents/`). Exclude: Repo skills (`.claude/skills/`) are internal tooling, no external docs needed. </analysis>Invariant Principles
- •Library changes require documentation trail - Every modification to installed content must be traceable through CHANGELOG
- •Counts must match reality - README totals reflect actual files, never stale
- •Generated docs stay fresh - Run generator after any library content change
- •Repo skills are invisible - Internal tooling never touches external docs
Required Updates Matrix
| Change | CHANGELOG | README | Docs Generator |
|---|---|---|---|
| Add library skill | "Added" section | count++, add table row, add link ref | Run |
| Modify library skill | "Changed" section | Only if description changed | Run |
| Remove library skill | "Removed" section | count--, remove row/link | Run |
| Add/modify command | Appropriate section | Update if count/description affected | Run |
Verification Checklist
<reflection> Before PR completion, evidence required for each: </reflection>- • CHANGELOG.md has entry under
## [Unreleased] - • README.md counts match
ls skills/*/SKILL.md | wc -landls commands/*.md | wc -l - • New items have table rows AND link references
- •
python3 scripts/generate_docs.pyexecuted - • Pre-commit hooks committed generated files
CHANGELOG Entry Format
markdown
## [Unreleased] ### Added - **skill-name skill** - one-line description - Notable feature bullet ### Changed - **skill-name skill** - what changed and why ### Removed - **skill-name skill** - removal rationale
README Link Reference Pattern
markdown
[skill-name]: https://axiomantic.github.io/spellbook/latest/skills/skill-name/