document-release

Synchronize project documentation with shipped changes by scanning diffs and updating Markdown files.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/2300031147/clawopencode --skill document-release-2300031147
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/2300031147/clawopencode/tree/main/skills/document-release
Command: npx skills add https://github.com/2300031147/clawopencode --skill document-release-2300031147

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Post-ship documentation frequently drifts out of date as code and releases evolve. This skill reads project docs, cross-references the shipped changes, and updates essential files such as README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md to reflect what shipped, while polishing the CHANGELOG and TODOS.

Core Features & Use Cases

  • Synchronizes documentation across README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md to reflect the shipped release.
  • Refines CHANGELOG wording, aligns with release notes, and cleans up outstanding TODOS.
  • Optionally bumps the version metadata when appropriate and reports the outcome of the update.

Quick Start

Run the document-release workflow after a PR is merged to refresh all shipped docs and keep the repository aligned with the release.

Frequently Asked Questions about document-release

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

FAQPage Schema
How do I automate post-ship documentation updates after a release?

Automate post-ship documentation updates by scanning project docs, cross-referencing code diffs, and modifying Markdown files to reflect shipped changes. This keeps your repository aligned with the latest release without manual edits.

What is the best way to keep my README and CHANGELOG synchronized with shipped code changes?

Keeping README and CHANGELOG files synchronized involves cross-referencing shipped diffs against existing documentation and refining the wording to match release notes. This ensures your project docs accurately reflect the current state of the codebase.

How do I update CONTRIBUTING and ARCHITECTURE docs to match a new version bump?

Updating CONTRIBUTING and ARCHITECTURE docs to match a version bump requires reading the repository state and editing the Markdown files. The process optionally bumps version metadata and reports the outcome of the documentation update.

Can I automatically clean up outstanding TODOS when refreshing project documentation?

Yes, you can clean up outstanding TODOS when refreshing project documentation. The workflow reads repo state and refines documentation files, ensuring that completed items are addressed while polishing the CHANGELOG and aligning it with release notes.

When should I run an automated documentation synchronization workflow for my project?

Run an automated documentation synchronization workflow immediately after a PR is merged. This timing ensures that README, ARCHITECTURE, CONTRIBUTING, and CLAUDE.md files consistently reflect the newly shipped release without manual intervention.