What problem does it solve?
Shipping code is only half the battle. Documentation quickly becomes stale, misleading users and wasting time on outdated instructions. This Skill automates the post-ship documentation update process, reading your project docs, cross-referencing the git diff, and updating README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md files to match what actually shipped.
Core Features & Use Cases
- Diff-aware doc updates: Analyzes recent code changes and updates documentation sections that reference modified features, APIs, or architecture.
- Multi-file synchronization: Updates README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md in one pass to maintain consistency.
- Changelog and TODO cleanup: Polishes CHANGELOG voice for clarity and removes completed TODOs from the codebase.
- Optional version bumping: Automatically increments VERSION files to match the new release state.
- Use Case: After merging a PR that adds WebSocket-based live monitoring to the backend, this Skill updates the architecture diagram in the README, adds the new endpoint to the API docs, and bumps the version from 1.2.0 to 1.3.0.
Quick Start
Use the document-release skill to update all project documentation to match your latest shipped code.