document-release

Update project documentation after a software release by analyzing release diffs.

Updated Jun 9, 2026
One-click install
npx skills add https://github.com/ericdahl-dev/coauthor-cleaner --skill document-release-ericdahl-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/ericdahl-dev/coauthor-cleaner/tree/main/.claude/skills/gstack/document-release
Command: npx skills add https://github.com/ericdahl-dev/coauthor-cleaner --skill document-release-ericdahl-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, grep, sed, bash, python, gstack, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the update of project documentation after a software release, ensuring that all relevant information is up-to-date and consistent across various documentation files.

Core Features & Use Cases

  • Documentation Audit: Audits all documentation files against the release changes.
  • Auto-Updates: Applies factual updates to documentation based on the release diff.
  • Risk Assessment: Flags and prompts for risky or questionable changes.
  • Voice Polishing: Enhances the CHANGELOG voice for clarity and impact.
  • Consistency Check: Ensures cross-document consistency and discoverability.
  • TODOS Cleanup: Updates or removes outdated TODO items.
  • VERSION Bump: Optionally adjusts the project version number.
  • Commit & PR Update: Commit updated documentation and modify PR body as needed.
  • Use Case: After a software release, use this Skill to automatically update the project's README, architecture, contributing guidelines, CHANGELOG, and TODOs to reflect the latest changes.

Quick Start

Run the document-release skill to update documentation after a ship event.

Frequently Asked Questions about document-release

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

FAQPage Schema
How do I automate documentation updates after a software release?

Automate documentation updates by analyzing release diffs, applying factual auto-updates to docs, flagging risky changes, and polishing the CHANGELOG voice for consistency. This ensures project documentation accurately reflects the latest shipped changes.

What is the best way to audit project documentation against a release diff?

Auditing documentation against a release diff involves parsing the changes, checking cross-document consistency, and cleaning up outdated TODOs. This process identifies factual updates needed in READMEs, architecture docs, and contributing guidelines.

How do I ensure cross-document consistency and discoverability post-ship?

Ensure cross-document consistency by applying auto-updates based on the release diff, polishing voice across files, and verifying discoverability. This flags questionable changes and aligns all project documentation with the new release.

Can I automatically bump the version number and update the PR body after a release?

Yes, you can optionally bump the version number, commit the updated documentation, and modify the PR body. This integrates the documentation audit and cleanup directly into your existing release workflow.

Do I need git and bash to automate post-ship documentation cleanup and TODO removal?

Yes, automating post-ship documentation cleanup requires git, bash, grep, sed, python, and gstack. These dependencies are used to parse release diffs, apply factual updates, and remove outdated TODO items across the project.

Why does my documentation audit flag risky changes during the release update?

A documentation audit flags risky changes to prompt manual review of questionable modifications found in the release diff. This precaution prevents incorrect auto-updates from propagating inconsistencies across project documentation.