Skills

/release-notes: user-facing release notes between two git refs

A Claude Code slash command that turns the changes between two tags or commits into release notes written for end users and admins: highlights, improvements, fixes, and any action they must take to upgrade.

Skill in Writing by AISkillHub Library

What it does

Changelogs are for maintainers; release notes are for the people who use the product. `/release-notes` reads the commits and diffs between two refs and writes notes that explain changes in terms of what users can now do, what behaves differently, and what they need to do.

**What it does** - Takes two refs (for example `v1.8.0 v1.9.0`, or one ref meaning "from there to HEAD"). - Reads commit messages, merge commit PR titles, and diffs for user-facing code: UI, public API, CLI, configuration, documentation. - Groups notes into **Highlights** (at most three), **Improvements**, **Fixes**, and **Action required** (upgrade steps, config changes, deprecations with timelines only if those appear in the code or docs). - Writes in plain language with no internal jargon, ticket IDs or class names unless the audience is developers (pass `audience=developers`). - Leaves out refactors, test changes, CI and internal tooling.

**What it will not do** It does not invent benefits or numbers ("2x faster") unless the commit or PR states a measured result. It does not publish anywhere. If a change's user impact is unclear from the code, it lists it under "Needs confirmation" instead of guessing.

**Example (excerpt)** ``` ## Highlights - Invoices can now be sent in the customer's language. Set the language on the customer record.

## Action required - The `REPORTS_LEGACY_EXPORT` setting has been removed. Exports always use the new format. ```

How to use it

1. Save the file below as `.claude/commands/release-notes.md`. 2. Run `/release-notes v1.8.0 v1.9.0`, or `/release-notes v1.8.0` to compare with `HEAD`. 3. Optional: add `audience=developers` for an SDK or API product, or `audience=admins` for self-hosted operators. 4. Paste the output into your release page, email or in-app announcement, and resolve anything under "Needs confirmation" first.

Files

Save each file at the path shown, relative to your project root.

  • .claude/commands/release-notes.md2.2 KB

More skills

See all
  • Skill· EngineeringFree

    One-at-a-time dependency upgrade skill with changelog review

    A Claude Code skill that upgrades a single dependency (or a short list, one by one), reads its release notes for breaking changes, updates affected call sites, and verifies with your typecheck, tests and build.

    Coding agentsClaude

    ALAISkillHub Library

  • Skill· EngineeringFree

    Incident debugging runbook skill: evidence first, read-only

    A Claude Code skill for active production incidents that builds a timeline, ties symptoms to recent changes in the repo, ranks hypotheses, and suggests read-only checks, while keeping a running incident log you can paste into Slack or a postmortem.

    Coding agentsClaude

    ALAISkillHub Library

  • Skill· DesignFree

    Accessibility check for UI components against WCAG 2.2 AA

    A Claude Code skill that reviews React, Vue, Svelte or HTML components for common WCAG 2.2 AA failures (labels, keyboard access, focus handling, ARIA misuse, contrast, target size) and reports or fixes them with file and line references.

    Coding agentsClaude

    ALAISkillHub Library

Get AISkillHub updates in your inbox.

New features as they ship, AI live chat improvements, and the best new listings in the catalog.

Product updates, new features, and guides. Unsubscribe any time.