Add changesets skill and update PR creation instructions#7825
Merged
Conversation
|
Contributor
There was a problem hiding this comment.
Pull request overview
Adds internal Copilot guidance for using Changesets in this repo, and updates Copilot PR-creation instructions so PRs include either a changeset file (when applicable) or the skip changeset label.
Changes:
- Added a new Copilot skill doc:
.github/skills/changesets/SKILL.md(what changesets are, how to create them, semver guidance, when to skip, release pipeline). - Updated
.github/copilot-instructions.mdto require PR authors to use the PR template and handle changesets consistently (add a changeset or applyskip changeset).
Show a summary per file
| File | Description |
|---|---|
.github/skills/changesets/SKILL.md |
Introduces a Changesets skill doc for Copilot to reference when advising on versioning/release notes. |
.github/copilot-instructions.md |
Updates PR creation instructions to require a changeset (or skip changeset label) in addition to using the PR template. |
Copilot's findings
- Files reviewed: 2/2 changed files
- Comments generated: 4
Comment on lines
+20
to
+21
| Changeset files live in `.changeset/` and have a random name with a `.md` extension. The file uses YAML frontmatter to specify the package and bump type, followed by a description: | ||
|
|
| - Remove a component | ||
| - Remove a prop | ||
| - Narrow the type of a prop (e.g., `string` → `'a' | 'b'`) | ||
| - Change the element that props are spread onto |
Comment on lines
+109
to
+110
| 2. **On merge to `main`**: The `changesets/action` GitHub Action automatically creates or updates a "Version Packages" release PR that bumps version numbers, updates `CHANGELOG.md`, and shows release notes. | ||
| 3. **On merging the release PR**: The action publishes the new version to npm and creates a GitHub Release. |
| When creating a pull request, you MUST: | ||
|
|
||
| 1. Use the template in `.github/pull_request_template.md` to structure the PR description. Read the template file, fill in all sections appropriately, and include it in the PR body. | ||
| 2. Include a changeset file in the PR if the change affects the published package (bug fix, new feature, breaking change, etc.). Create a `.changeset/<descriptive-name>.md` file with the appropriate semver bump type. Reference the `changesets` skill (`.github/skills/changesets/SKILL.md`) for detailed guidance on file format, choosing the correct bump type, and when a changeset can be skipped. |
joshblack
approved these changes
May 8, 2026
jonrohan
added
the
integration-tests: skipped manually
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds a new Copilot skill for working with changesets and updates the Pull Request Creation section in copilot-instructions.md to require changesets (or the
skip changesetlabel) for every PR.New file:
.github/skills/changesets/SKILL.mdA detailed skill covering:
contributor-docs/versioning.mdskip changesetlabelUpdated:
.github/copilot-instructions.mdThe
## Pull Request Creationsection now has a numbered list requiring:skip changesetlabel (when no changeset is needed)Changelog
New
.github/skills/changesets/SKILL.md— new Copilot skill for changeset guidanceChanged
.github/copilot-instructions.md— PR creation section updated to require changesetsRemoved
Rollout strategy
Documentation/instruction files only — no package code is changed and no release is needed.
Testing & Reviewing
Review the two files for accuracy and completeness:
.github/skills/changesets/SKILL.md— the new skill file.github/copilot-instructions.md— the updated PR creation section (lines 155-161)Merge checklist