Add skill to facilitate SPFx version upgrades
@brianpmccullough is already working on this.
Since Jul 8, 2026.
- Dominant language
- TypeScript
- Stars
- 1.5k
- Forks
- 413
- Avg merge
- 5d 6h
- Merged PRs (30d)
- 21
Description
Summary
Adding support for a new SPFx version (e.g. spfx project upgrade, spfx project doctor, spfx doctor) is a recurring, well-structured task that follows the same pattern each time. A Claude Code skill would allow contributors to execute this workflow consistently and efficiently without having to rediscover the steps.
What the skill would cover
- Researching the new version (release notes, what changed, skipped/delisted versions)
- Creating
upgrade-{version}.tsanddoctor-{version}.ts - Updating
supportedVersionsinproject-upgrade.tsandproject-doctor.ts - Adding the entry to
SpfxCompatibilityMatrix.tsforspfx doctor - Guiding the contributor through manual test project scaffolding with
yo @microsoft/sharepoint(including which project types to create and how) - Adding e2e tests with correct finding counts (determined by running the test suite)
- Validating finding counts against equivalent previous patch upgrades for consistency
- Updating docs and opening the PR with a standardized description
Why a skill
The workflow has a natural human-in-the-loop step (scaffolding test projects requires the correct generator version installed locally), making it a good fit for a skill that can pause, hand off, and resume. The code changes themselves are mechanical and well-suited for AI assistance.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.