Garry Tan/document-release — Agent Skills | officialskills.sh
Back to skills

document-release

communitydocs

Runs after code ships to bring all project documentation in sync with what actually changed.

Setup & Installation

npx skills add https://github.com/garrytan/gstack --skill document-release
or paste the link and ask your coding assistant to install it
https://github.com/garrytan/gstack/tree/main/document-release
View on GitHub

What This Skill Does

Runs after code ships to bring all project documentation in sync with what actually changed. Reads the diff, then updates README, ARCHITECTURE, CONTRIBUTING, CLAUDE.md, and CHANGELOG to match the current state of the repo. Optionally bumps VERSION and cleans up completed TODOs.

Instead of manually diffing each doc against the code after every merge, this traces the exact changes and applies only what the diff actually warrants, without overwriting content or guessing at intent.

When to use it

  • Updating README feature tables after merging a new command
  • Fixing stale file paths in CONTRIBUTING after a repo restructure
  • Polishing CHANGELOG entries from commit-message tone to user-facing language
  • Marking TODO items as complete when the diff shows the work is done
  • Checking cross-doc consistency before a PR merges