# Release Notes

> Write user-friendly release notes that communicate what changed, why it matters, and how to use new capabilities — not technical changelogs.

- Skill: `nandanosql/release-notes` (Agent Skill)
- Install (CLI): `npx skillmds@latest add nandanosql/release-notes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nandanosql/release-notes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: nandanosql (https://skillmd.com/u/nandanosql)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/nandanosql/release-notes

---


## Purpose

Write release notes that users actually **want to read** — communicating what changed, why it matters, and how to use new capabilities. Not a git log, not a technical changelog — a user-facing communication.

---

## Application

### Template

```markdown
# Release Notes: [Version/Date]

## 🎉 What's New

### [Feature Name]
[One sentence: what it does and why you'll care]
[One sentence: how to use it or where to find it]

## 🔧 Improvements

- **[Area]:** [What improved, in user terms]
- **[Area]:** [What improved]

## 🐛 Bug Fixes

- Fixed an issue where [user-visible symptom]
- Resolved [user-visible problem]

## 📋 Coming Soon
[Optional: what's next, to build anticipation]
```

### Writing Rules

| Do | Don't |
|----|-------|
| "You can now export reports as PDF" | "Added PDF export endpoint" |
| "Dashboard loads 3x faster" | "Optimized database queries" |
| "Fixed login issues on Safari" | "Fixed WebKit session storage bug" |

---

## Quality Rubric

| Dimension | 0 | 1 | 2 |
|-----------|---|---|---|
| **Language** | Technical/internal | Mostly user-friendly | Entirely user-perspective |
| **Value** | Feature names only | Features + descriptions | Features + why you'll care |
| **Completeness** | Partial | Most changes | All user-visible changes |
| **Tone** | Corporate/dry | Professional | Engaging and clear |

---

## References

### Related Skills
- `skills/launch/launch-checklist/SKILL.md` — Release notes are a launch step
- `skills/communication/executive-presentation/SKILL.md` — Internal announcement

---

**Skill type:** Component
**Domain:** Execution & Delivery