---

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

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

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

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 -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

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

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

<CRITICAL> Library content (`skills/`, `commands/`, `agents/`) triggers this skill. Repo content (`.claude/skills/`) does NOT. </CRITICAL>