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".
- Author
- marfoerst ↗
- Repository
- the-pragmatic-pm ↗
- Licence
- MIT
- Last repository change
- 19.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 19.10.2026, without references to retired models or APIs.
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
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
- Intent Detection
- Core Principle: Customer Benefit First
- Process
- Output Format
- Tone & Style
- Language & Delivery
- Common Mistakes to Flag
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.