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 Changes heading
  • 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.

Installs
5
Repository
medusajs/medusa
GitHub Stars
35.4K
First Seen
Jul 14, 2026
writing-releases — medusajs/medusa