name: release-notes description: Use this skill when asked to write versioned release notes and you need repo-specific structure, ordering, and scope filtering.
Release Notes Skill
Trigger
Use this skill when asked to write release notes.
Instructions
- Use
docs/release-notes-0-21-0.mdas the formatting template and section style baseline. - Present items in this exact order:
- User-facing features first.
- Operator behavior changes second.
- Other changes important for admins/operators third.
- User-facing bug fixes fourth.
- Upgrade instructions last.
- Add a dedicated
Behavior Changessection for changes that can alter existing deployment behavior or require operator action. - Include environment variables only when they are relevant to operator action, compatibility, or upgrade safety. Do not include exhaustive variable inventories.
- Skip chore/internal-only changes that do not affect users or admins (for example CI/workflow-only changes).
- Keep language outcome-focused (what changed for users/admins), not implementation-heavy.
- Include only changes in the requested version/tag diff range.
- Use the major.minor release version in release-note copy and image tags (for example
0.23). - Never mention release-candidate tags or patch versions in release notes, even when an RC commit or tag defines the diff endpoint.
- Every
DEKART_LICENSE_KEYmention must include the CTA:[Get a key free here](https://mailchi.mp/dekart/upgrade-to-sso).