Breaking Change Documentation Skill

Generate high-quality breaking change documentation for merged dotnet/runtime pull requests and file it as an issue in dotnet/docs.

Overview

When a PR in dotnet/runtime introduces a breaking change, the docs team needs a structured issue in dotnet/docs describing the change, its impact, and migration guidance. This skill automates that process:

1. Gather PR context — read the PR, its diff, related issues, comments, and reviews.
2. Detect version — run the helper script to determine which .NET release the change lands in.
3. Check for duplicates — search dotnet/docs for existing breaking-change issues for this PR.
4. Fetch reference material — read the issue template and recent example issues from dotnet/docs.
5. Author the documentation — produce the issue body following the template structure and example quality.
6. Publish — write output files and optionally comment on the source PR.

Trigger modes