release-notes — Claude Code skill: what it does, how to install
Creates user-facing release notes from tickets, PRDs, and changelogs. Use it when announcing updates or summarising shipped work.
npx skills add phuryn/pm-skills --skill release-notes -a claude-codeWhat release-notes does
The skill reads supplied tickets, PRDs, JIRA or Linear exports, Git logs, and internal changelogs. It sorts changes into new features, improvements, bug fixes, breaking changes, and deprecations, then turns them into plain-language release note entries without internal ticket references.
Entries lead with the user benefit and can follow a professional, friendly, or API-focused product voice. Provided visuals or screenshots are included. The output is saved as a Markdown document, with conversion to HTML or another format available on request.
When given a product URL, the skill uses web search to understand the product and audience. That is a reason to check whether web search is acceptable for the task.
What it helps with
- turn tickets into release notes
- group shipped changes by category
- rewrite technical changes for users
- describe breaking changes and required actions
- convert Markdown notes to HTML
Example prompts for the agent
- "Create user-facing release notes from these tickets."
- "Summarise this PRD and Git log as a product update."
- "Write release notes that cover breaking changes and deprecations."
How to install release-notes
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill release-notes -a claude-code2Manually: put the files in place
~/.claude/skills/release-notes/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/release-notes/
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill release-notes -a codex2Manually: put the files in place
.agents/skills/release-notes/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill release-notes -a cursor2Manually: put the files in place
.cursor/skills/release-notes/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install phuryn/pm-skills release-notes2Manually: put the files in place
.github/skills/release-notes/SKILL.md1Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill release-notes -a gemini-cli2Platform CLI
gemini skills install https://github.com/phuryn/pm-skills --path pm-execution/skills/release-notesManually: put the files in place
.devin/skills/release-notes/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add phuryn/pm-skills --skill release-notes -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set61
The whole set →Similar
Questions about release-notes
How do I install release-notes in Claude Code?
Run npx skills add phuryn/pm-skills --skill release-notes -a claude-code, then run npx skills add phuryn/pm-skills --skill release-notes -a claude-code again. The skill file is placed at ~/.claude/skills/release-notes/SKILL.md.
What does release-notes do?
It turns technical tickets, PRDs, and changelogs into release notes written for users. It categorises the changes and removes internal jargon and ticket references.
What output format does release-notes create?
It saves release notes as a Markdown document. It can convert the result to HTML or another format when requested.
Source text
SKILL.md · MIT
--- name: release-notes description: "Generate user-facing release notes from tickets, PRDs, or changelogs. Creates clear, engaging summaries organized by category (new features, improvements, fixes). Use when writing release notes, creating changelogs, announcing product updates, or summarizing what shipped." --- ## Release Notes Generator Transform technical tickets, PRDs, or internal changelogs into polished, user-facing release notes. ### Context You are writing release notes for **$ARGUMENTS**. If the user provides files (JIRA exports, Linear tickets, PRDs, Git logs, or internal changelogs), read them first. If they mention a product URL, use web search to understand the product and audience. ### Instructions 1. **Gather raw material**: Read all provided tickets, changelogs, or descriptions. Extract: - What changed (feature, improvement, or fix) - Who it affects (which user segment) - Why it matters (the user benefit) 2. **Categorize changes**: - **New Features**: Entirely new capabilities - **Improvements**: Enhancements to existing features - **Bug Fixes**: Issues resolved - **Breaking Changes**: Anything that requires user action (migrations, API changes) - **Deprecations**: Features being sunset 3. **Write each entry** following these principles: - Lead with the user benefit, not the technical change - Use plain language — avoid jargon, internal codenames, or ticket numbers - Keep each entry to 1-3 sentences - Include visuals or screenshots if the user provides them **Example transformations**: - Technical: "Implemented Redis caching layer for dashboard API endpoints" - User-facing: "Dashboards now load up to 3× faster, so you spend less time waiting and more time analyzing." - Technical: "Fixed race condition in concurrent checkout flow" - User-facing: "Fixed an issue where some orders could fail during high-traffic periods." 4. **Structure the release notes**: ``` # [Product Name] — [Version / Date] ## New Features - **[Feature name]**: [1-2 sentence description of what it does and why it matters] ## Improvements - **[Area]**: [What got better and how it helps] ## Bug Fixes - Fixed [issue description in user terms] ## Breaking Changes (if any) - **Action required**: [What users need to do] ``` 5. **Adjust tone** to match the product's voice — professional for B2B, friendly for consumer, developer-focused for APIs. Save as a markdown document. If the user wants HTML or another format, convert accordingly.
© phuryn · MIT · phuryn/pm-skills