document-release

Sync README and related docs with shipped code diffs.

6|2|Updated Oct 18, 2021
One-click install
npx skills add https://github.com/jerrywu001/jerrywu001 --skill document-release-jerrywu001
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: document-release
Source: https://github.com/jerrywu001/jerrywu001/tree/main/.claude/skills/document-release
Command: npx skills add https://github.com/jerrywu001/jerrywu001 --skill document-release-jerrywu001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps post-ship project documentation accurate and consistent with what actually shipped, so users and contributors don’t get out-of-date setup steps, APIs, or descriptions.

Core Features & Use Cases

  • Cross-doc diff syncing: Reads all project docs and aligns README/architecture/contributing/project instructions with the changes introduced by the shipped code.
  • Evidence-based updates: Cross-references the diff to update only what’s warranted (paths, capabilities, commands, and factual statements).
  • Release hygiene: Polishes CHANGELOG voice, cleans up TODOs, and can optionally bump the project VERSION when docs warrant a release.
  • Use Case: After merging a feature PR that changes commands, configuration, or structure, run this to ensure the docs and changelog reflect the new reality instead of relying on manual edits.

Quick Start

Ask your AI to run the document-release workflow to update the repository documentation to match what shipped on the current feature branch.

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 merging a code change?

Automate documentation updates by cross-referencing the shipped code diff to align README and architecture files with new features or command behavior. This ensures post-ship docs accurately reflect project changes without manual edits.

What is the best way to keep a CHANGELOG and VERSION file synced with git diffs?

Keeping a CHANGELOG and VERSION synced involves deterministic doc audits that polish changelog voice, clean up TODOs, and optionally bump the VERSION. This requires cross-referencing the git diff to constrain edits around factual release modifications.

How does cross-doc diff syncing work for project onboarding guides?

Cross-doc diff syncing works by reading all project docs and updating contributor guides based on evidence from the code diff. It modifies only paths, capabilities, and commands warranted by the shipped changes to maintain accurate onboarding instructions.

Can I automatically generate a PR body documentation diff preview after updating docs?

You can generate a PR body documentation diff preview as a final step after committing synchronized docs. This provides a visible summary of how README and related documentation were updated to match the shipped code changes.

When should I use automated release management for repository documentation?

Use automated release management for repository documentation when shipped changes include new features, command behavior updates, removed functionality, or infrastructure adjustments. It ensures deterministic doc audits and constrained edits for accurate post-ship synchronization.

Does document-release require manual confirmation to bump a project VERSION?

Document-release requires optional user confirmation to bump the project VERSION when docs warrant a release. This ensures deterministic versioning control while automating the rest of the documentation synchronization workflow.