document-release

Name: document-release
Availability: InStock
Author: andy-hnu

Synchronize Markdown docs with shipped changes after PR merges.

Updated Mar 9, 2026

Search Tags:#automation #changelog #documentation #diff #docs #polish #version

Ready to run

npx skills add https://github.com/Andy-HNU/AndyClaw --skill document-release-andy-hnu

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/Andy-HNU/AndyClaw/tree/main/skills/gstack-document-release
Command: npx skills add https://github.com/Andy-HNU/AndyClaw --skill document-release-andy-hnu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After shipping code, project documentation often drifts from what was actually released. This Skill automatically synchronizes core docs (README.md, ARCHITECTURE.md, CONTRIBUTING.md, CLAUDE.md), polishes changelog prose, and tidies TODOS to reflect shipped changes.

Core Features & Use Cases

Synchronize README.md, ARCHITECTURE.md, CONTRIBUTING.md, and CLAUDE.md with the latest shipped changes.
Polish CHANGELOG voice and clean up TODOS to improve readability and consistency.
Optionally bump VERSION after a release and surface proactive documentation hygiene prompts.

Quick Start

Run the document-release skill after shipping to synchronize docs, polish changelog prose, and optionally bump the VERSION.

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 shipping code?▼

Automate documentation updates by running a post-ship synchronization process that aligns README.md, ARCHITECTURE.md, CONTRIBUTING.md, and CLAUDE.md with the latest shipped changes using lightweight diffing.

How do I keep my CHANGELOG and TODOS consistent with merged PRs?▼

Keep your CHANGELOG and TODOS consistent by polishing the changelog voice and tidying TODOs automatically after PR merges, ensuring project documentation reflects the actual release state.

Can I automatically bump the VERSION file after a release?▼

Yes, you can optionally bump the VERSION file after a release as part of the post-ship documentation synchronization process to maintain version control accuracy.

Does this documentation sync tool edit Markdown files in place?▼

Yes, this documentation sync tool edits Markdown files in place, relying on lightweight diffing to ensure only relevant sections are updated based on shipped changes.

What is the best way to prevent project docs from drifting after a release?▼

Prevent project docs from drifting by applying an automated post-ship alignment that refreshes core documentation, polishes changelog prose, and bumps the version to match the shipped code.

How does frontmatter metadata control documentation synchronization activation?▼

Frontmatter metadata controls documentation synchronization activation by signaling the process to read the metadata and determine when to refresh docs, polish changelogs, and tidy TODOS after shipping.