What problem does it solve?
Documentation drifts from reality after code ships, leaving READMEs, architecture docs, and changelogs stale and misleading. This Skill eliminates the tedious manual work of reconciling docs with shipped code.
Core Features & Use Cases
- Cross-Reference Diff Analysis: Reads all project documentation and compares it against the actual code changes that shipped.
- Multi-File Documentation Updates: Automatically updates README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md to reflect what actually shipped.
- Changelog Polish & Cleanup: Refines CHANGELOG voice for consistency and cleans up outdated TODOS across the codebase.
- Optional Version Bump: Can automatically increment VERSION files to match the new release.
- Use Case: After merging a feature PR that adds OAuth authentication, this Skill updates the README with new setup steps, revises the ARCHITECTURE doc to include the auth flow, and polishes the CHANGELOG entry.
Quick Start
Use the document-release skill to update all project documentation to match the latest shipped code and polish the changelog.