# release-notes-generator

Turns completed tickets from Linear, Jira, or GitHub Issues into user-facing release notes saved as a Word file in Google Drive.

Skill by Amplitude. Category: Documents.

## Install

Project (for this project only):

```sh
npx skills add amplitude/builder-skills --skill release-notes-generator
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

Global (for every project on this machine):

```sh
npx skills add amplitude/builder-skills --skill release-notes-generator -g
```

Works with: Claude Code, Codex CLI, Cursor, Antigravity, Copilot CLI, opencode.

## Tags

- Runs on your computer: It runs as a program on your machine, with your access.

## Security audits

- Gen Agent Trust Hub: Pass
- Socket: Pass
- Snyk: Warn

Installs: 8. Installs counted by skills.sh. [Open on skills.sh](https://www.skills.sh/amplitude/builder-skills/release-notes-generator)

## Source

[Open the source](https://github.com/amplitude/builder-skills/tree/HEAD/execution-skills/skills/release-notes-generator). Checked 2026-10-10. This summary may contain AI-generated text, so it can be wrong. Check the source before you rely on it.

## SKILL.md

````markdown
---
name: release-notes-generator
description: Read completed tickets from Linear, Jira, or GitHub Issues, filter to user-visible changes, group by product area, and write polished user-facing release notes saved as a .docx to Google Drive. Use before each release or on a weekly cadence.
suggest_when: User says "release notes", "write changelog", "what shipped this sprint", "draft release notes", "summarize what we shipped", or needs to communicate recent product changes to customers or stakeholders.
---

# Release Notes Generator

**Turn a sprint's worth of closed tickets into polished, user-facing release notes — automatically.**

Writing release notes from raw tickets is tedious: filter out internal work, translate engineer-speak into user language, format consistently. This skill does all of it.

---

## Prompt Template

```
/schedule

### Step 1 — Gather completed tickets
Check {{TICKET_SOURCES}} for items marked done, shipped, merged, or closed in the past {{TIME_WINDOW}}.

Skip: in-progress, internal-only, pure bug fixes with no visible UX change, chores, refactors,
anything tagged "internal", "infra", or "ops".

### Step 2 — Group by product area
Use ticket labels or project names. Merge areas with fewer than 2 items into the closest group.

### Step 3 — Write the release notes
For each area:

**[Area Tag]**
**[Title]** — 2–5 words, present tense, feature name not a commit message.
Good: "Faster search results", "New billing dashboard". Never: "added", "fixed", "shipped".

[Description] — 1–3 sentences to the user. Lead with what changed and why it matters.
Use "you can now…" framing. No bullet points. No ticket IDs, sprint names, or engineer names.

### Step 4 — Save
Date at top: Month DD, YYYY. Entries grouped by area.
Save as ReleaseNotes_YYYY-MM-DD.docx to {{OUTPUT_FOLDER}}.
Do not publish — save for review only. If no tickets found, say which sources you checked.
```

---

## Setup

| Field | Value |
|-------|-------|
| **MCPs required** | Linear / Jira / GitHub Issues, Google Drive |
| **Output** | `ReleaseNotes_YYYY-MM-DD.docx` → `/Product/ReleaseNotes` |
| **Scheduler** | Manual before each release, or weekly |

## Placeholders to fill in

- `{{TICKET_SOURCES}}` — e.g. `Linear`, `Jira`, or `GitHub Issues`
- `{{TIME_WINDOW}}` — e.g. `the past 7 days`, `the past 2 weeks`, or `this sprint`
- `{{OUTPUT_FOLDER}}` — e.g. `/Product/ReleaseNotes`

## Tips

- Good ticket hygiene = better release notes. Descriptions that say "users can now..." produce the best output.
- Pair with `update-knowledge-base` to flag which help articles need updating after each release.
- For API/webhook changes, keep those tickets in a separate label — the skill gives them a distinct technical voice.
````

- Previous: [north-star-metric](https://syn4pse.dev/terminal/amplitude-north-star-metric.md)
- Next: [analyze-account-health](https://syn4pse.dev/terminal/amplitude-analyze-account-health.md)
- [Terminal](https://syn4pse.dev/terminal.md)
- [Suggest a change](mailto:terminal@syn4pse.dev?subject=Terminal%20suggestion)
