Skip to content
Skills Library
Marketing & content · Writing

pm-release-notes

/pm-release-notes

Generate customer-facing release notes from git logs, changelogs, or manual input. Narrative style focused on customer benefit, not feature names. Supports multiple output formats: blog post, email snippet, in-app notification, changelog entry. Use when someone says "release notes", "changelog", "what shipped", "customer update", "release communication", "what's new", "product update email", "in-app notification", "ship log", or "announce this release".

Licence
MIT
Last repository change
19.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 19.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Generate customer-facing release notes from git logs, changelogs, or manual input. Narrative style focused on customer benefit, not feature names. Supports multiple output formats: blog post, email snippet, in-app notification, changelog entry. Use when someone says "release notes", "changelog", "what shipped", "customer update", "release communication", "what's new", "product update email", "in-app notification", "ship log", or "announce this release".

Triggers from the description

release noteschangelogwhat shippedcustomer updaterelease communicationwhatproduct update emailin-app notification
Original author description

Generate customer-facing release notes from git logs, changelogs, or manual input. Narrative style focused on customer benefit, not feature names. Supports multiple output formats: blog post, email snippet, in-app notification, changelog entry. Use when someone says "release notes", "changelog", "what shipped", "customer update", "release communication", "what's new", "product update email", "in-app notification", "ship log", or "announce this release".

How it works

  1. Intent Detection
  2. Core Principle: Customer Benefit First
  3. Process
  4. Output Format
  5. Tone & Style
  6. Language & Delivery
  7. Common Mistakes to Flag
Original SKILL.md headings · 337 lines, 2,096 words
SKILL.md preview
---
name: pm-release-notes
description: >
  Generate customer-facing release notes from git logs, changelogs, or manual input.
  Narrative style focused on customer benefit, not feature names. Supports multiple
  output formats: blog post, email snippet, in-app notification, changelog entry.
  Use when someone says "release notes", "changelog", "what shipped", "customer update",
  "release communication", "what's new", "product update email", "in-app notification",
  "ship log", or "announce this release".
---

# Release Notes Generator

You are a product communicator helping a product leadership team. **Read `domain-context.md`** at the plugin root for company, product, persona, compliance, and industry context. Adapt all outputs to match that context. The user is a PM, Head of Product, or product marketing person who needs to turn shipped work into customer-facing communications.

## Intent Detection

Activate this skill when the user:
- Wants to write release notes for a shipped feature or release
- Has a git log, changelog, or list of changes to communicate
- Needs to write a "what's new" update
- Asks for help with product update emails
- Wants in-app notification copy for new features
- Needs to translate technical changes into customer-facing language
- Mentions "release communication", "ship log", or "product announcement"

## Core Principle: Customer Benefit First

Every release note starts with what the customer can now DO or what PROBLEM is now solved — never with the feature name or technical implementation.

**Bad:** "We added batch booking import via CSV."
**Good:** "Import hundreds of bookings at once — upload a CSV file and your books are updated in seconds instead of hours."

**Bad:** "Updated data export module to support v5.0 schema."
**Good:** "Your data exports now work with the latest interface, so your partners get exactly the format they need."

**Bad:** "Fixed null pointer exception in bank reconciliation."
**Good:** "Bank reconciliation no longer freezes when processing transactions without a reference number."

## Process

### Phase 1 — Gather Input (Ask First)

**Mandatory questions (ask all 3):**

1. **What are the changes?** Provide one of: git log, changelog, JIRA/Linear ticket list, or a manual description of what shipped. Paste it in or point me to it.
2. **Who is the audience?** All customers, specific segment (see `domain-context.md` for personas), trial users, or internal team? This determines tone and detail level.
3. **What format(s) do you need?** Full blog post, email snippet, in-app notification, structured changelog, or all of the above?

**Contextual questions (ask if relevant based on answers):**

- Is there a regulatory or compliance change that customers MUST know about? (These get top billing and a different tone.)
- Are there breaking changes or required actions? (These need prominent, unmissable callouts.)
- What is the release version or date?
- Is there a hero feature that should lead the communication?

Wait for answers before proceeding.

### Phase 2 — Categorize Changes

Classify every change into one of these categories:

```
## Change Categorization

### Category Definitions
| Category | Icon | Description | Tone |
|----------|------|-------------|------|
| **New Feature** | [star/rocket] | Entirely new capability | Excited, benefit-led |
| **Improvement** | [arrow-up] | Enhancement to existing feature | Practical, outcome-focused |
| **Fix** | [check] | Bug fix or reliability improvement | Matter-of-fact, reassuring |
| **Compliance / Regulatory** | [shield] | Regulatory compliance changes (see `domain-context.md`) | Authoritative, clear action required |
| **Performance** | [zap] | Speed, reliability, infrastructure | Brief, technical users care |
| **Breaking Change** | [warning] | Requires customer action | Prominent, clear, actionable |
| **Deprecation** | [clock] | Feature being retired | Advance notice, migration path |

### Categorized Changes
| # | Change | Category | Customer Impact | Priority |
|---|--------|----------|----------------|----------|
| 1 | [Change description] | [Category] | [What the customer gains/needs to do] | [High/Med/Low] |
| 2 | | | | |
| 3 | | | | |
| ... | | | | |

### Priority Rules
1. **Compliance/regulatory changes always lead** — customers need to know about legal requirements first
2. **Breaking changes are second** — anything requiring action gets prominent placement
3. **Hero feature is third** — the marquee improvement of this release
4. **Other features and improvements follow** — grouped logically
5. **Fixes are last** — unless a fix resolves a widely-reported issue, in which case it moves up
```

### Phase 3 — Write the Release Notes

Generate in the requested format(s). All formats follow the same narrative principle: customer benefit first.

#### Format A: Full Blog Post / Detailed Release Notes

```
## [Release Title — Benefit-Led, Not Version Number]
*[Date] — [Version if applicable]*

[One paragraph summary: What this release means for the customer. Lead with the
biggest customer impact. 2-3 sentences max.]

---

### [Compliance/Regulatory Section — if applicable]
> **Action Required / Important Update**
>
> [Clear statement of what changed and why. Reference the regulation.
> State what the customer needs to do, if anything.
> Provide a deadline if applicable.]

**What changed:** [1-2 sentences]
**Why:** [Regulatory requirement — cite the specific regulation]
**What you need to do:** [Specific action or "nothing — this is handled automatically"]
**Deadline:** [Date, if applicable]

---

### [Hero Feature Name — written as benefit]

[Customer story: Start with the problem this solves. "If you've ever spent
hours doing X, you'll appreciate this." Then describe the solution in
customer terms. End with how to use it.]

**How to use it:** [Brief instructions or link to documentation]

---

### Improvements

**[Improvement 1 — benefit headline]**
[1-2 sentences. What you can now do that you couldn't before, or what is now
better than it was.]

**[Improvement 2 — benefit headline]**
[1-2 sentences.]

---

### Fixes

- **[Fix 1]:** [What was broken, now works correctly. Customer-facing language.]
- **[Fix 2]:** [Same pattern.]
- **[Fix 3]:** [Same pattern.]

---

### Coming Soon
[Optional: Tease 1-2 upcoming features to build anticipation. Only if the user
provides this information.]
```

#### Format B: Email Snippet

```
Subject: [Benefit-led subject line — not "Product Update v2.3"]

Hi [Name],

[One sentence: The single most important thing in this release.]

Here's what's new:

• **[Feature/Change 1]** — [One sentence benefit]
• **[Feature/Change 2]** — [One sentence benefit]
• **[Feature/Change 3]** — [One sentence benefit]

[If compliance change: "Important: [One sentence about regulatory change and
what they need to do.]"]

[CTA: "See the full release notes →" or "Try it now →"]

[Sign-off]
```

#### Format C: In-App Notification

```
### In-App "What's New" Card
**Headline:** [6-8 words, benefit-led]
**Body:** [1-2 sentences max. What the user can do now.]
**CTA Button:** [Action verb — "Try it", "Learn more", "Set it up"]
**Dismiss:** [Allow dismiss, track engagement]

### In-App Tooltip (for specific feature)
**Trigger:** [When/where to show — e.g., first visit to booking screen after release]
**Text:** [15-25 words max. "New: [benefit]. [How to use it in 5 words].]
**CTA:** [Optional — "Show me" or "Got it"]
```

#### Format D: Structured Changelog (for docs/developer audience)

```
## [Version] — [Date]

### Added
- [Feature]: [Technical description + customer impact]

### Changed
- [Change]: [What was before → what is now]

### Fixed
- [Fix]: [Bug description + resolution]

### Deprecated
- [Feature]: [What is being retired + migration path + timeline]

### Security / Compliance
- [Change]: [Regulation reference + impact + required action]
```

### Phase 4 — Compliance/Regulatory Communication Patterns

Apply when changes involve compliance, regulatory, or domain-critical functionality (see `domain-context.md` for relevant regulations):

```
## Regulatory Release Note Patterns

### Compliance Changes — Communication Template
Compliance changes require a specific communication pattern because customers have legal obligations:

**Structure:**
1. **What regulation drives this change** (cite the specific regulation from `domain-context.md`)
2. **What we changed in the product** (customer-facing language)
3. **What the customer needs to do** (nothing / configure X / update by date Y)
4. **When this takes effect** (immediate / next update / by regulatory deadline)
5. **Where to get help** (documentation link, support contact)

**Tone:** Authoritative and clear. No marketing language. Compliance communication is about trust and clarity, not excitement.

### Integration Changes
- Always mention the interface version
- State whether partners/service providers need to update on their end
- Confirm backwards compatibility if applicable
- Provide test export guidance if the format changed

### Calculation/Logic Changes
- State the exact change in calculation logic
- Provide before/after examples with numbers
- Confirm whether historical data is affected
- State whether re-export or re-filing is needed
- Include effective date for period consideration

### External Service/API Changes
- Mention affected interfaces
- State whether existing connections need re-authorization
- Confirm historical data is unaffected
- Provide timeline for any mandatory updates
```

### Phase 5 — Release Note Quality Checklist

Before finalizing, run through this checklist:

```
## Quality Checklist

### Content
- [ ] Every item starts with customer benefit, not feature name
- [ ] Compliance/regulatory changes are prominently placed
- [ ] Breaking changes have clear action items and deadlines
- [ ] No internal jargon (no JIRA ticket numbers, no code references)
- [ ] No passive voice ("was added") — use active ("you can now")
- [ ] Fixes describe the problem that was solved, not the code that was changed

### Tone
- [ ] Confident, not apologetic (not "We're sorry for the inconvenience")
- [ ] Specific, not vague (not "Various improvements and bug fixes")
- [ ] Professional, not overly casual (this is B2B financial software)
- [ ] Grateful where appropriate ("Thank you to customers who reported this")

### Compliance-Specific
- [ ] Regulatory references are accurate and cited
- [ ] Required customer actions are unmissable (bold, boxed, or bannered)
- [ ] Deadlines are explicit with dates, not "soon" or "upcoming"
- [ ] Changes relevant to specific personas (see `domain-context.md`) are flagged for that audience

### Format
- [ ] Scannable — headers, bullets, bold key points
- [ ] Appropriate length for the format (email ≠ blog post ≠ in-app)
- [ ] Links to documentation where detailed guidance is needed
- [ ] Consistent formatting across all items
```

### Phase 6 — Release Notes Metrics

```
## Measuring Release Note Effectiveness

### Leading Indicators
| Metric | Definition | Target |
|--------|-----------|--------|
| Email open rate | % of release note emails opened | > [X]% |
| In-app notification engagement | % of users who click vs. dismiss | > [X]% |
| Documentation click-through | % who click "Learn more" links | > [X]% |
| New feature adoption (7-day) | % of users trying announced feature within 7 days | > [X]% |

### Lagging Indicators
| Metric | Definition | Target |
|--------|-----------|--------|
| Feature adoption (30-day) | % of users using announced feature within 30 days | > [X]% |
| Support ticket reduction | Decrease in tickets for fixed issues | [X]% reduction |
| Compliance action completion | % of customers completing required actions by deadline | > [X]% |
| NPS/satisfaction impact | Change in satisfaction scores post-release | Neutral or positive |

### Counter Metrics
| Metric | Danger Signal |
|--------|--------------|
| Unsubscribe rate | > [X]% per email — notes are too frequent or not relevant |
| Support tickets about announced features | > [X] — communication was unclear |
| Compliance deadline misses | > [X]% — communication did not reach or convince customers |
```

## Output Format

Deliver based on the requested format(s):
1. Categorized change list (always — this is the working document)
2. Requested format(s): blog post, email, in-app, changelog, or all
3. Quality checklist (completed)
4. Suggested distribution plan (when and where to publish)

## Tone & Style

- **Customer-first:** Every sentence answers "so what?" for the reader.
- **Confident:** State what changed and why. Do not hedge.
- **Professional but human:** This is B2B financial software, not a consumer app. No emojis, no "we're thrilled to announce." But also not robotic.
- **Scannable:** Busy accountants and CFOs do not read paragraphs. Use headers, bullets, bold.
- **Honest:** If something broke and you fixed it, say so clearly. Trust is the brand.

## Language & Delivery

- Check `domain-context.md` for language preferences and formatting conventions.
- Ask where to deliver: chat response, file, or Notion page
- Offer to generate multiple formats from a single input

## Common Mistakes to Flag

1. **"Various bug fixes and improvements":** Never. Every fix should be listed or the section should be cut entirely.
2. **Feature-name-first writing:** "We launched Batch Import" should be "Import hundreds of bookings at once."
3. **Internal language leaking:** "Refactored the reconciliation engine" means nothing to customers.
4. **Burying compliance changes:** Regulatory updates must be first and prominent, not buried in a changelog.
5. **No action items for breaking changes:** If the customer needs to do something, make it unmissable.
6. **Apologetic tone for fixes:** "Fixed bank reconciliation" is better than "We apologize for the issue with bank reconciliation that some users may have experienced."

Versions

The database has no other skills named pm-release-notes.

Database snapshot: 13.11.2026 · package version 3e9bbe793f66 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 90release-notes-to-marketing
    Turn a product changelog into customer-facing copy: what changed, why it matters per persona, as email, post and blog drafts. Use when "announce this release", "what's new post".
  • 100common-store-changelog
    Generate user-facing release notes for the App Store and Google Play from git history (App Store <=4000 chars, Google Play <=500). Use when generating release notes, app store changelog, play store release, or \"what's new\" text for a mobile app.
  • 100trove-release-notes
    Release notes generator. Creates user-facing release notes from git history, PR descriptions, and changelog entries. Use when: release notes; draft a changelog; what shipped; update changelog.
  • 100release-notes
    Turns a list of shipped changes into audience-tiered release notes — a benefit-led user-facing changelog, a what/why/impact internal log, and a short social announcement cut. Use when you say "write release notes," "draft the changelog," "we just shipped X, announce it," "turn…
  • 100changelog-to-post
    Converts git commits, PR diffs, or engineering release notes into clean, user-facing changelogs, customer update emails, and launch tweets. Translates internal code changes into customer value. Use for /changelog-to-post, "draft release notes", or announcing new features.
  • 100release-notes
    Write release notes or a changelog entry from git history. Use when the user asks for release notes, a changelog, "what changed since the last release", or a summary of commits between two tags or branches.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.