---

name: documentation-updates description: "Use after modifying library skills, library commands, or agents to ensure CHANGELOG, README, and docs are updated"

Documentation Updates

Invariant Principles

1. Library changes require documentation trail - Every modification to installed content must be traceable through CHANGELOG
2. Counts must match reality - README totals reflect actual files, never stale
3. Generated docs stay fresh - Run generator after any library content change
4. Repo skills are invisible - Internal tooling never touches external docs

Required Updates Matrix

Verification Checklist

• CHANGELOG.md has entry under ## [Unreleased]
• README.md counts match ls skills/*/SKILL.md | wc -l and ls commands/*.md | wc -l
• New items have table rows AND link references
• python3 scripts/generate_docs.py executed
• Pre-commit hooks committed generated files

CHANGELOG Entry Format

Copy## [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

Copy[skill-name]: https://axiomantic.github.io/spellbook/latest/skills/skill-name/