document-release

Synchronize project documentation with shipped code using git diffs.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/a29paul/hexlens --skill document-release-a29paul
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/a29paul/hexlens/tree/main/.claude/skills/gstack/document-release
Command: npx skills add https://github.com/a29paul/hexlens --skill document-release-a29paul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After shipping code, project documentation (READMEs, changelogs, architecture guides, etc.) often falls out of sync with what was actually deployed, leading to confusion for users and contributors, wasted time debugging mismatched docs, and reduced trust in project resources.

Core Features & Use Cases

  • Automated Doc Alignment: Cross-references git diffs from shipped code to identify all changes that need to be reflected in project documentation.
  • Multi-Doc Updates: Updates README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md files to match shipped functionality, polishes CHANGELOG entry voice, and cleans up outdated TODOs.
  • Optional Version Bump: Can automatically increment version numbers in project files to match new releases.
  • Use Case: After merging a PR that adds new enemy ultimate cooldown tracking to a League of Legends overlay, run this skill to automatically update the feature list in the README, add the new feature to the CHANGELOG, and remove the old TODO note about unimplemented cooldown tracking.

Quick Start

Use the document-release skill to sync all project documentation with the code changes from your latest shipped PR.

Frequently Asked Questions about document-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically update my README and changelog after shipping code?

Automating post-ship documentation synchronization cross-references git diffs to identify shipped changes and updates README and changelog files to match the deployed functionality. It eliminates stale project docs by aligning supporting documentation with the latest code deployments.

What is the best way to sync project documentation with a git diff?

Syncing project documentation with a git diff involves cross-referencing the shipped code changes to identify required updates in supporting files. This process automatically aligns READMEs, architecture docs, and contribution guides with the actual deployed code.

Can I automatically clean up outdated TODOs in my documentation after a release?

Yes, you can automatically clean up outdated TODOs in your documentation after a release. Post-ship doc synchronization tools identify resolved issues from git diffs and remove the corresponding outdated TODO notes from your project files.

Does post-ship documentation synchronization work for architecture docs and contribution guides?

Yes, post-ship documentation synchronization works for architecture docs and contribution guides. It updates multiple documentation files including README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md to accurately reflect newly shipped functionality.

How do I bump version numbers in project files to match a new release?

To bump version numbers in project files to match a new release, you can use an automated post-ship documentation tool. It optionally increments version numbers across project files while synchronizing your changelog and README with the latest git changes.

When should I not use automated doc alignment for my software project?

You should avoid using automated doc alignment when a software project has no shipped code changes or lacks existing documentation files to sync. The tool requires a git diff from a recent deployment to identify changes and update relevant project docs.