Maintain DisCatSharp
Aiko-IT-Systems/DisCatSharp
Guides changes to the DisCatSharp C# Discord library: tracing a payload field through parsing, serialization and caches, then validating across target frameworks.
Generates before and after .NET public API diff reports for a release milestone by running RunApiDiff.ps1, including a table mapping plain-language requests to its parameters.
Install .NET API Diff Reports
$ npx skills add dotnet/core --skill api-diff -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install dotnet/core api-diff --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/dotnet/core.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.github/skills/api-diff .claude/skills/api-diff && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "api-diff" agent skill from https://github.com/dotnet/core/tree/main/.github/skills/api-diff into .claude/skills/api-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-diff", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/dotnet/core/tree/main/.github/skills/api-diffType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add dotnet/core --skill api-diff -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install dotnet/core api-diff --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/core.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.github/skills/api-diff .agents/skills/api-diff && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "api-diff" agent skill from https://github.com/dotnet/core/tree/main/.github/skills/api-diff into .agents/skills/api-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-diff", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dotnet/core --skill api-diff -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install dotnet/core api-diff --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/core.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.github/skills/api-diff .cursor/skills/api-diff && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "api-diff" agent skill from https://github.com/dotnet/core/tree/main/.github/skills/api-diff into .cursor/skills/api-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-diff", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/dotnet/core.git --path .github/skills/api-diff--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add dotnet/core --skill api-diff -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install dotnet/core api-diff --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/core.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.github/skills/api-diff .gemini/skills/api-diff && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "api-diff" agent skill from https://github.com/dotnet/core/tree/main/.github/skills/api-diff into .gemini/skills/api-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-diff", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install dotnet/core api-diffInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add dotnet/core --skill api-diff -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/dotnet/core.git skills-src && mkdir -p .github/skills && cp -r skills-src/.github/skills/api-diff .github/skills/api-diff && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "api-diff" agent skill from https://github.com/dotnet/core/tree/main/.github/skills/api-diff into .github/skills/api-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-diff", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add dotnet/core --skill api-diff -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install dotnet/core api-diff --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/dotnet/core.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.github/skills/api-diff .opencode/skills/api-diff && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "api-diff" agent skill from https://github.com/dotnet/core/tree/main/.github/skills/api-diff into .opencode/skills/api-diff/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "api-diff", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
api-diff- GitHub stars
- 22k
- Token cost
- ~792 tokens
- SKILL.md length
- 241 words
- Files
- 1
- Skills in repo
- 15
- Repo updated
- First seen
- Licence
- MIT
At a glance
Generates before and after .NET public API diff reports for a release milestone by running RunApiDiff.ps1, including a table mapping plain-language requests to its parameters.
- Producing API diff reports for the next .NET preview or release
- SKILL.md covers Generate the reports with…, Mapping natural language to… and Running the script
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
- Comparing two specific .NET builds by version string
What it does
The skill produces markdown-ready API diff reports shaped for the repository, comparing the previous milestone with the current one. It is pure generation: it runs the diff tool and writes the reports through release-notes/RunApiDiff.ps1, whose full parameter reference lives in RunApiDiff.md. Checking that the diffed APIs actually shipped, tracing them to pull requests and catching reverts is left to the separate api-diff-validation skill.
A mapping table turns phrases into parameters. Next diff means no parameters, .NET 10 GA versus .NET 11 Preview 1 sets previous and current major-minor values plus a preview.1 label, net9.0-preview6 to net10.0-preview5 style names use the same pattern, and exact version strings go through the version parameters. GA omits the prerelease label, previews are written preview.4 and not preview4, and only alpha, beta, preview and rc labels are accepted.
When your agent uses it
- Producing API diff reports for the next .NET preview or release
- Comparing two specific .NET builds by version string
- Turning a phrase like .NET 10 RC 2 versus GA into script parameters
Example prompts
- “Generate the next API diff.”
- “Create the API diff for .NET 10 GA versus .NET 11 Preview 1.”
- “Diff net9.0-preview6 against net10.0-preview5.”
Requirements
- PowerShell to run RunApiDiff.ps1
- A checkout of the dotnet/core repository
What it can do on your machine
Read from SKILL.md and the folder at commit 44927bc. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are powershell).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
.NET API Diff Reports loads about 792 tokens when it runs. Until then it costs about 63 tokens; SKILL.md has 241 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from dotnet/core at commit 44927bc, republished under its MIT licence (© dotnet). 241 words, ~792 tokens.
Download SKILL.mdSave it as
.claude/skills/api-diff/SKILL.md (or your agent's skills folder).- name
- api-diff
- description
- 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.
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 skill.
Generate the reports with RunApiDiff.ps1
Use release-notes/RunApiDiff.ps1. See 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
PrereleaseLabelparameter forRunApiDiff.ps1; if a downstream api-diff release label is needed, usega - Preview N / previewN ->
-PrereleaseLabel preview.N(for example,preview.4, notpreview4) - RC N / rcN ->
-PrereleaseLabel rc.N - Alpha N / Beta N ->
-PrereleaseLabel <label>.N(for example,alpha.1,beta.2);RunApiDiff.ps1accepts only thealpha,beta,preview, andrcprerelease labels - netX.Y-previewN (TFM format) ->
-MajorMinor X.Y -PrereleaseLabel preview.N - Full NuGet version strings -> use
-PreviousVersion/-CurrentVersiondirectly - 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.
© dotnet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .github/skills/api-diff of dotnet/core.
Open the folder on GitHubat commit 44927bc
Compare with similar skills
.NET API Diff Reports next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| .NET API Diff Reports this skilldotnet/core | 22k | — | ~792 | Automated safety check: Pass | MIT | |
| Maintain DisCatSharpAiko-IT-Systems/DisCatSharp | 140 | — | ~1.2k | Automated safety check: Pass | MIT | |
| Student First Runwengan-li/ncku-thesis-template-latex | 151 | — | ~1.5k | Automated safety check: Pass | Custom licence | |
| Code Reviewpnp/powershell | 905 | — | ~385 | Automated safety check: Pass | MIT | |
| Documentcodewhale-hq/Codewhale | 41k | — | ~170 | Automated safety check: Pass | MIT | |
| Markdown WriterDevolutions/devolutions-gateway | 162 | — | ~290 | Automated safety check: Pass | Apache-2.0 |
Similar skills
Student First Run
wengan-li/ncku-thesis-template-latex
Design every student-facing change from the viewpoint of a graduate student meeting this repository for the first time.
Code Review
pnp/powershell
Reviews changes to PnP PowerShell, a .NET 8 module of 800+ cmdlets for Microsoft 365.
Document
codewhale-hq/Codewhale
Write or update repository/product documentation: README, user guides, API docs, architecture, migration notes, and changelog material.
Markdown Writer
Devolutions/devolutions-gateway
Write clean, readable Markdown with concise prose and maintainable source formatting.
Simple English
moeru-ai/airi
Write or rewrite technical text with the rules of ASD-STE100 Simplified Technical English so it is clear, unambiguous, and free of AI slop.
More from dotnet/core
All 15 skills in this repo- Official
Update .NET OS Packages
dotnet/core
Audits and updates os-packages.json files listing the Linux packages each .NET release needs per distro, then regenerates the Markdown from the JSON.
- Official
Update .NET Supported OS Matrix
dotnet/core
Audits and updates the supported-os.json files for .NET releases, checking them against upstream lifecycle data and regenerating the markdown with the release-notes tool.
- Official
.NET Release Verification
dotnet/core
Validates .NET release data with the release-notes CLI: download URL liveness, SHA512 hashes, CDN latest.version files and aka.ms redirects.
- Official
Generate .NET Release changes.json
dotnet/core
Produces the changes.json manifest for a .NET preview, RC or GA milestone by choosing the right VMR base and head refs and running release-notes generate changes.
- Official
Release Feature Scoring
dotnet/core
Ranks the changes in a release manifest and writes a scored features file that release notes, docs and blog posts can each cut at their own threshold.
- Official
Release Notes Editorial Review
dotnet/core
Audits a scored features.json file and its draft release notes against editorial examples to catch over-scored, under-scored, or missing entries.
Related
Works with
Categories
Questions about .NET API Diff Reports
What does .NET API Diff Reports do?
Generates before and after .NET public API diff reports for a release milestone by running RunApiDiff.ps1, including a table mapping plain-language requests to its parameters. The skill produces markdown-ready API diff reports shaped for the repository, comparing the previous milestone with the current one.md.
When should I use .NET API Diff Reports?
.NET API Diff Reports fits situations like: producing API diff reports for the next .NET preview or release; comparing two specific .NET builds by version string; turning a phrase like .NET 10 RC 2 versus GA into script parameters.
How do I install .NET API Diff Reports in Claude Code?
Run `npx skills add dotnet/core --skill api-diff -a claude-code`. Or copy the skill folder (.github/skills/api-diff in dotnet/core) into .claude/skills/api-diff in your project. Claude Code loads it when a task matches its description.
How do I install .NET API Diff Reports in Codex?
Run `npx skills add dotnet/core --skill api-diff -a codex`. Or copy the skill folder (.github/skills/api-diff in dotnet/core) into .agents/skills/api-diff in your project. Codex loads it when a task matches its description.
Can I use .NET API Diff Reports in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dotnet/core --skill api-diff -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/api-diff, .gemini/skills/api-diff, .github/skills/api-diff and .opencode/skills/api-diff in your project.
What does .NET API Diff Reports need to run?
SKILL.md names no scripts, command-line tools or credentials: .NET API Diff Reports is instructions for the agent only. Our summary lists: PowerShell to run RunApiDiff.ps1; A checkout of the dotnet/core repository.
Does .NET API Diff Reports access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is .NET API Diff Reports safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does .NET API Diff Reports use?
.NET API Diff Reports is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does .NET API Diff Reports use?
About 792 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to .NET API Diff Reports?
Skills that share tags, products or a category with .NET API Diff Reports: Maintain DisCatSharp (Aiko-IT-Systems/DisCatSharp, 140 stars), Student First Run (wengan-li/ncku-thesis-template-latex, 151 stars), Code Review (pnp/powershell, 905 stars) and Document (codewhale-hq/Codewhale, 41k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains .NET API Diff Reports?
dotnet (a GitHub organization, an official publisher) maintains it in dotnet/core, which has 22,038 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.
Source: dotnet/core on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.