writing-releases
Installation
SKILL.md
Writing Medusa Release Notes
Generates GitHub release notes from commit/PR data in the established Medusa style.
Constraints
- Full Changelog link is mandatory — always the last line:
**Full Changelog**: [vPREV...vNEW](compare-url) - No top-level Breaking Changes section — breaking changes are embedded inside their Highlight subsection with
🚧 Breaking change, never in a separate## Breaking Changesheading - Bullet format is strict — every entry in Features/Bugs/Chores/etc. must include author link and PR link (see
reference/format.md) - Highlights are not a summary of all PRs — only significant changes qualify; routine additions go in Features/Bugs bullets only (see
reference/release-types.md) - No emojis — the only permitted emoji is
🚧on breaking change highlights; use none anywhere else - Code block required for actionable steps — if a highlight requires the developer to install a package, run a command, or update config, include a fenced code block with the exact command(s)
Load Reference Files When Needed
Load at least one reference file before writing.