pnp / pnp/cli-microsoft365

Add skill to facilitate SPFx version upgrades

Open
#7,435 0 comments 0 reactions 1 assignee View on GitHub

@brianpmccullough is already working on this.

Since Jul 8, 2026.

enhancement work in progress
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}.ts and doctor-{version}.ts
  • Updating supportedVersions in project-upgrade.ts and project-doctor.ts
  • Adding the entry to SpfxCompatibilityMatrix.ts for spfx 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.