release-notes-writing

Writes customer-facing and internal release notes from shipped spec records.

3|2|Updated Aug 24, 2026
One-click install
npx skills add https://github.com/hero-engine/hero --skill release-notes-writing-hero-engine
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release-notes-writing
Source: https://github.com/hero-engine/hero/tree/main/domains/pm/skills/release-notes-writing
Command: npx skills add https://github.com/hero-engine/hero --skill release-notes-writing-hero-engine

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a shipped work window into release notes often degrades into pasting a changelog or commit log into a doc, leaving customers without a clear picture of what they can now do and teams without a traceable record of what shipped. This Skill provides the discipline for both cuts from the same shipped-window truth. ## Core Features & Use Cases - Customer-facing notes: Lead with user benefit, group items by theme, call out behavior changes affecting existing workflows, and link to docs; written to .hero/planning/release-notes/<window-or-tag>/customer.md. - Internal updates: Keep spec slugs, name owners, and link each shipped item back to its originating PRD or initiative; written to .hero/planning/release-notes/<window>/internal.md. - Shipped-status verification: Pulls what shipped from the graph (spec status is completed plus an engineering close-out in owner_history), surfacing orphan deliveries instead of including them. - Use Case: After a release window closes, ask for the week's release notes and receive a themed, benefit-led customer announcement plus an internal traceable record of who shipped what and why. ## Quick Start Ask the agent to draft release notes for everything shipped this week, producing both the customer-facing and internal versions.

Frequently Asked Questions about release-notes-writing

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

FAQPage Schema
How do I write release notes for a shipped window?▼

Pull what shipped from the graph where spec status is completed and owner_history shows engineering close-out, then write two cuts: a customer-facing note grouped by theme and led by user benefit, and an internal note keeping spec slugs, owners, and PRD links.

What is the difference between customer-facing and internal release notes?▼

Customer-facing notes lead with what users can now do, group items by capability theme, and link to docs. Internal notes keep spec slugs, name owners, and link each item back to its originating PRD or initiative for traceability.

How do I determine which specs count as shipped?▼

A spec is shipped only when its status is completed and the most recent owner_history row records engineering close-out. Specs that merged without a recorded close-out are orphan deliveries and should be surfaced as gaps, not included in the notes.

Where are the release note files written?▼

Customer-facing notes go to .hero/planning/release-notes/<window-or-tag>/customer.md and internal updates go to .hero/planning/release-notes/<window>/internal.md, keeping both cuts organized per release window.

What are common release notes mistakes to avoid?▼

Avoid changelog dumps with no narrative, notes that read like commit messages, overselling small fixes as headline launches, silent behavior changes that affect existing workflows, and including orphan deliveries that the graph does not record as shipped.