| name | changesets-prerelease |
| description | Create and apply a prerelease bump using Changesets CLI, with the new changeset markdown summarizing the actual changes since the last shipped release. |
Changesets Prerelease Skill
Use this skill when preparing the next prerelease version in a project that uses Changesets.
Steps
-
Add a new changeset:
npx @changesets/cli add --empty --message "<summary>"
- update the generated
.changeset/*.md frontmatter with the correct target package and bump type used by the repository.
- replace the placeholder body with a concise summary of the actual user-facing changes since the last shipped release, not just a generic "prepare prerelease" note.
- if the immediately previous prerelease number (for example
.24) has not been released yet and you are preparing .25, the new markdown should still describe the cumulative changes that matter for the next published prerelease.
-
Bump versions/changelog:
npx @changesets/cli version
-
Commit the resulting changes (package.json, CHANGELOG.md, and consumed .changeset files).
Writing the new .changeset/*.md body
- Summarize the functional changes that should appear in the changelog for the next published prerelease.
- Prefer short release-note language such as:
- fixed SQL snapshot translation for directly mapped complex mirror properties
- clarified provider documentation for scalar value object query behaviour
- aligned repo-local agent skills and instructions
- Do not leave the body as a procedural placeholder such as
Prepare next prerelease unless there were truly no meaningful changes.
- If multiple unreleased prerelease bumps exist locally, write the new file so the generated changelog entry remains useful to an external consumer reading the next shipped release.
Notes
- If the repository uses prerelease mode, check
.changeset/pre.json for the active prerelease tag.
- Ensure release notes/changelog are generated from actual changes, not placeholder text.
- In prerelease mode,
changeset version can record a changeset in .changeset/pre.json even if the new file was created with placeholder/empty content first. If that happens, correct the .md frontmatter/body before finalizing the release notes so the next shipped prerelease entry is accurate.