SkillsAdd

dotnet/core · Archived

api-diff

Generate before/after .NET public API diff reports for a release milestone with `RunApiDiff.ps1`. Pure report generation only; to verify the diff against the shipped build (dotnet-inspect, revert detection) use the api-diff-validation skill.

First seen Apr 28, 2026

Installation

$ npx skills add dotnet/core --skill api-diff
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

release-notes Same source · more installs
dotnet/core

Generate and maintain .NET release notes from `features.json`.

4 installs
update-release-graph Same source
dotnet/core

Update the HAL+JSON release information graph when new .NET releases ship. Regenerates index fi…

3 installs
verify-releases Same source
dotnet/core

Validate releases and release links: URL liveness, file hashes, CDN latest.version files, and a…

3 installs
update-supported-os Same source
dotnet/core

Audit and update supported-os.json/md files to reflect current OS version support. Uses the rel…

3 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

terraform-azurerm-set-diff-analyzer Similar name
github/awesome-copilot

Analyze Terraform plan JSON output for AzureRM Provider to distinguish between false-positive d…

8.9K installs
diff-scanning-with-aws-security-agent Similar name
aws/agent-toolkit-for-aws

Run a fast AWS Security Agent diff scan on only the changed code since a git ref. Use when the …

1.1K installs
argent-screenshot-diff Similar name
software-mansion/argent

Compare saved or live app screenshots with the argent screenshot-diff tool. Use when testing vi…

14.5K installs
diff-intake Similar name
amplitude/mcp-marketplace

Reads a PR or branch diff and produces a structured YAML change brief for downstream analytics …

8.9K installs
differential-review Similar name
trailofbits/skills

Performs security-focused differential review of code changes. Adapts analysis depth to codebas…

6.4K installs
meticulous-simulate-and-diff Similar name
alwaysmeticulous/skills

Run a Meticulous session simulation against a live URL and analyze the visual output — either b…

5.8K installs

Also in this package

Other skills from dotnet/core · top by installs.

npx skills add dotnet/core
release-notes 4 update-release-graph 3 verify-releases 3 update-supported-os 3 update-os-packages 3 update-existing-branch 3 update-distro-packages 3 review-release-notes 3 publish-release-announcements 3 generate-features 3

Browse all from dotnet/core

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 22.0K
License LICENSE.TXT
Default branch main
Open issues 342
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,167 B
  • docs SUMMARY.md 257 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 3 installs

SKILL.md

API Diffing

Use this skill to produce the markdown-ready, repo-shaped API diff reports for a release milestone (previous milestone -> current). This skill is pure generation: it runs the diff tool and writes the reports. Verifying that the diffed APIs actually shipped, tracing them to PRs, and catching reverts is the separate [api-diff-validation](../api-diff-validation/SKILL.md) skill.

Generate the reports with RunApiDiff.ps1

Use release-notes/RunApiDiff.ps1. See [release-notes/RunApiDiff.md](../../../release-notes/RunApiDiff.md) for the full parameter reference.

Mapping natural language to parameters

User says Parameters
"generate the next API diff" (none)
".NET 10 GA vs .NET 11 Preview 1" -PreviousMajorMinor 10.0 -CurrentMajorMinor 11.0 -CurrentPrereleaseLabel preview.1
"net9.0-preview6 to net10.0-preview5" -PreviousMajorMinor 9.0 -PreviousPrereleaseLabel preview.6 -CurrentMajorMinor 10.0 -CurrentPrereleaseLabel preview.5
".NET 10 RC 2 vs .NET 10 GA" -PreviousMajorMinor 10.0 -PreviousPrereleaseLabel rc.2 -CurrentMajorMinor 10.0
"10.0.0-preview.7.25380.108 to 10.0.0-rc.1.25451.107" -PreviousVersion "10.0.0-preview.7.25380.108" -CurrentVersion "10.0.0-rc.1.25451.107"
  • GA or no qualifier -> omit the PrereleaseLabel parameter for RunApiDiff.ps1; if a downstream api-diff release label is needed, use ga
  • Preview N / previewN -> -PrereleaseLabel preview.N (for example, preview.4, not preview4)
  • RC N / rcN -> -PrereleaseLabel rc.N
  • Alpha N / Beta N -> -PrereleaseLabel <label>.N (for example, alpha.1, beta.2); RunApiDiff.ps1 accepts only the alpha, beta, preview, and rc prerelease labels
  • netX.Y-previewN (TFM format) -> -MajorMinor X.Y -PrereleaseLabel preview.N
  • Full NuGet version strings -> use -PreviousVersion / -CurrentVersion directly
  • The "previous" version is always the older version; "current" is the newer one

Running the script

.\release-notes\RunApiDiff.ps1 [mapped parameters]

Set an initial wait of at least 300 seconds — the script takes several minutes. After completion, summarize the results: how many diff files were generated and where.