document-release

Update core repository docs after shipped PRs by scanning diffs.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Kakarottoooo/onegent --skill document-release-kakarottoooo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/Kakarottoooo/onegent/tree/main/.agents/skills/gstack/document-release
Command: npx skills add https://github.com/Kakarottoooo/onegent --skill document-release-kakarottoooo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-ship documentation updates automate the tedious task of aligning shipped code with project documentation. It scans the released changes, cross-references diffs, and updates key docs to reflect what shipped, while polishing the CHANGELOG voice and cleaning up TODOs.

Core Features & Use Cases

  • Synchronize README, ARCHITECTURE, CONTRIBUTING, and AGENTS.md to reflect what was released.
  • Polish CHANGELOG language and tidy up TODOS to maintain consistency across the repo.
  • Optionally bump VERSION when doc changes warrant a new release, or defer to later.

Quick Start

Run document-release after a ship to synchronize README, ARCHITECTURE, CONTRIBUTING, and AGENTS.md with the shipped changes.

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 changes?

Automating documentation updates after shipping requires scanning released diffs to synchronize README, ARCHITECTURE, CONTRIBUTING, and AGENTS.md files. This process cross-references code changes and automatically updates project documentation to reflect exactly what was released.

What is the best way to keep README and CHANGELOG files in sync with merged pull requests?

Keeping README and CHANGELOG files in sync with merged pull requests involves reading PR-driven diffs and polishing CHANGELOG language. This approach automatically adjusts core documentation and cleans up TODOS to maintain consistency across the repository.

Can I automatically bump the VERSION file when documentation changes warrant a new release?

You can automatically bump the VERSION file when documentation changes warrant a new release. This process performs optional version bumps during doc synchronization, or defers them to a later release if appropriate.

Does this documentation synchronization approach preserve existing content and file structure?

This documentation synchronization approach preserves existing content and file structure. It enforces end-to-end doc hygiene by reading diffs and updating key files while ensuring the original repository structure remains intact.

When should I run a post-ship documentation synchronization workflow?

You should run a post-ship documentation synchronization workflow immediately after a ship. It scans the shipped changes, cross-references diffs, and updates key docs to reflect what shipped, ensuring your repository documentation stays aligned with the latest code.

How does diff cross-referencing work for updating project documentation?

Diff cross-referencing for project documentation works by scanning shipped code changes and comparing them against existing docs. It automatically updates README, ARCHITECTURE, CONTRIBUTING, and AGENTS.md files to accurately reflect the released modifications.