changesets-release
Installation
SKILL.md
Changesets Release
Use this for consumer-installed packages. Do not require Changesets for a single deployed application unless its owner chooses release versions.
Decide Scope
- Use it for libraries, SDKs, CLIs, plugins, and packages published independently.
- In a monorepo, include every changed consumer package; let Changesets calculate internal dependency bumps.
- For internal-only work, use the repository's explicit
no-changesetconvention. Do not add an empty changeset merely to satisfy CI. - Before first adoption, confirm the owner wants Changesets, then initialize it with the repository's package manager. Do not introduce a release dependency unilaterally.
Add Release Intent
- Read
.changeset/config.json, package metadata, and the consumer contract before choosing a bump. - Use
patchfor compatible fixes,minorfor compatible capabilities, andmajorfor breaking behavior, removed APIs, or required consumer changes. - Run the configured
changesetcommand and commit its generated.changeset/<name>.mdwith the implementation PR. - Write the entry for consumers: what changed, why it matters, and migration steps when needed. Never copy a commit subject as the release note.