github.com/dotnet/skills
| Skill | Added | Review |
|---|---|---|
agentic-workflows .github/skills/agentic-workflows/SKILL.md Route gh-aw design, creation, diagnosis, patching, active debugging, and upgrade requests to the right strategies. | 59 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
analyzing-dotnet-performance plugins/dotnet-diag/skills/analyzing-dotnet-performance/SKILL.md Scans .NET code for ~50 performance anti-patterns across async, memory, strings, collections, LINQ, regex, serialization, and I/O with tiered severity classification. Use when analyzing .NET code for optimization opportunities, reviewing hot paths, or auditing allocation-heavy patterns. | 73 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
android-tombstone-symbolication plugins/dotnet-diag/skills/android-tombstone-symbolication/SKILL.md Symbolicate the .NET runtime frames in an Android tombstone file. Extracts BuildIds and PC offsets from the native backtrace, downloads debug symbols from the Microsoft symbol server, and runs llvm-symbolizer to produce function names with source file and line numbers. USE FOR triaging a .NET MAUI or Mono Android app crash from a tombstone, resolving native backtrace frames in libmonosgen-2.0.so or libcoreclr.so to .NET runtime source code, or investigating SIGABRT, SIGSEGV, or other native signals originating from the .NET runtime on Android. DO NOT USE FOR pure Java/Kotlin crashes, managed .NET exceptions that are already captured in logcat, or iOS crash logs. INVOKES Symbolicate-Tombstone.ps1 script, llvm-symbolizer, Microsoft symbol server. | 76 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
apple-crash-symbolication plugins/dotnet-diag/skills/apple-crash-symbolication/SKILL.md Symbolicate .NET runtime frames in Apple platform .ips crash logs (iOS, tvOS, Mac Catalyst, macOS). Extracts UUIDs and addresses from the native backtrace, locates dSYM debug symbols, and runs atos to produce function names with source file and line numbers. Automatically downloads .dwarf symbols from the Microsoft symbol server using Mach-O UUIDs. USE FOR triaging a .NET MAUI or Mono app crash from an .ips file on any Apple platform, resolving native backtrace frames in libcoreclr or libmonosgen-2.0 to .NET runtime source code, retrieving .ips crash logs from a connected iOS device or iPhone, or investigating EXC_CRASH, EXC_BAD_ACCESS, SIGABRT, or SIGSEGV originating from the .NET runtime. DO NOT USE FOR pure Swift/Objective-C crashes with no .NET components, or Android tombstone files. INVOKES Symbolicate-Crash.ps1 script, atos, dwarfdump, idevicecrashreport. | 73 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
assertion-quality plugins/dotnet-test/skills/assertion-quality/SKILL.md Analyze assertion quality, depth, variety, and false confidence in existing tests. ALWAYS USE when asked about weak, shallow, trivial, always-true, self-referential, assertion-free, presence/truthiness-only, or insufficiently diverse assertions, including MSTest, Jest, pytest, and Go. DO NOT USE for direct fixes: writing-mstest-tests owns supplied MSTest assertions; code-testing owns new cases. Use test-gap-analysis when asked whether tests would catch a production change, and test-anti-patterns for general severity-ranked audits. | 72 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
author-component plugins/dotnet-blazor/skills/author-component/SKILL.md Create or review Blazor components (.razor files) with correct architecture. USE FOR: writing new Blazor components that do NOT involve JavaScript interop, implementing parameters and EventCallback, RenderFragment slots, component lifecycle (OnInitializedAsync, OnParametersSet), async patterns, IAsyncDisposable, CancellationToken, CSS isolation, code-behind. DO NOT USE FOR: creating new projects (use create-blazor-project), JavaScript interop or calling browser APIs from Blazor (use use-js-interop), forms and validation (use collect-user-input), prerendering issues (use support-prerendering), HTTP data fetching patterns (use fetch-and-send-data), coordinating state between unrelated components (use coordinate-components). | 72 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
authoring-github-workflows .agents/skills/authoring-github-workflows/SKILL.md Author and review GitHub Actions workflow YAML safely so syntactically-valid YAML can't ship a workflow that GitHub Actions refuses to run. USE FOR: editing, adding, or reviewing any file under .github/workflows/, writing run-name/name/if/env/run values that contain ${{ }} expressions, diagnosing a run that fails with 'This run likely failed because of a workflow file issue' and no jobs starting, deciding when a workflow scalar must be quoted, validating workflows with actionlint. DO NOT USE FOR: authoring application YAML unrelated to GitHub Actions, Azure Pipelines, GitLab CI, or non-workflow YAML. SCOPE: this skill covers *syntactic/structural* correctness of workflow YAML (quoting, parsing, actionlint); for *semantic and functional* workflow design (what a workflow should do, agentic-workflow behavior), see .github/agents/agentic-workflows.agent.md — the two are complementary. INVOKES: actionlint (downloaded pinned binary) plus git/grep for inspection. | 75 Impact — No eval scenarios have been run Securityby Low Low-risk findings worth noting Version: 2877c71 | |
binlog-failure-analysis plugins/dotnet-msbuild/skills/binlog-failure-analysis/SKILL.md Analyze MSBuild binary logs to diagnose build failures. USE FOR: build errors that are unclear from console output, diagnosing cascading failures across multi-project builds, tracing MSBuild target execution order, and generally any MSBuild build issues. Requires an existing .binlog file. DO NOT USE FOR: generating binlogs (use binlog-generation), binlog MCP startup or connection failures (use troubleshoot-binlog-mcp), non-MSBuild build systems. | 73 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
binlog-generation plugins/dotnet-msbuild/skills/binlog-generation/SKILL.md Generate MSBuild binary logs (binlogs) for build diagnostics and analysis. USE FOR: adding /bl:{} to any dotnet build, test, pack, publish, or restore command to capture a full build execution trace, prerequisite for binlog-failure-analysis and build-perf-diagnostics skills, enabling post-build investigation of errors or performance. Requires MSBuild 17.8+ / .NET 8 SDK+ for {} placeholder; PowerShell must quote the complete switch as '-bl:{}'. DO NOT USE FOR: non-MSBuild build systems (npm, Maven, CMake), analyzing an existing binlog (use binlog-failure-analysis instead), binlog MCP startup failures (use troubleshoot-binlog-mcp). | 75 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
build-parallelism plugins/dotnet-msbuild/skills/build-parallelism/SKILL.md Analyze MSBuild scheduling across at least two distinct projects in a solution/filter/Build.proj. USE FOR: measured idle workers, -m not scaling, serial ProjectReference critical paths, graph builds, MSBuild Projects-list scheduling. DO NOT USE FOR: duplicate executions or invariant-generation races (find-repeated-work-within-one-build), non-MSBuild systems. | 64 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
build-perf-baseline plugins/dotnet-msbuild/skills/build-perf-baseline/SKILL.md Establish MSBuild/.NET baselines before optimizing. USE FOR: unranked slow builds; cold/warm/incremental/no-op measurements; before/after comparisons; CI caching; static graph, artifacts output, dependency graph trimming. DO NOT USE FOR: measured bottlenecks (build-perf-diagnostics), known repeated restores (eliminate-redundant-restores), within-build duplicate calls (find-repeated-work-within-one-build), non-MSBuild builds. | 72 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
build-perf-diagnostics plugins/dotnet-msbuild/skills/build-perf-diagnostics/SKILL.md Diagnose MSBuild bottlenecks from binlog timelines and Target/Task Performance Summaries after baseline measurements. USE FOR: unknown build slowness, RAR >5s, analyzers >30% of Csc, a target >50% of build, node utilization below 80%, excessive Copy, restore overhead. DO NOT USE FOR: within-build duplicates (find-repeated-work-within-one-build), known repeated restores (eliminate-redundant-restores), initial baselines (build-perf-baseline), incremental rebuilds (incremental-build), parallelism tuning (build-parallelism), non-MSBuild builds. | 65 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
check-bin-obj-clash plugins/dotnet-msbuild/skills/check-bin-obj-clash/SKILL.md Find OutputPath/IntermediateOutputPath collisions between distinct projects or required property/TFM variants. USE FOR: missing/overwritten bin/obj or project.assets.json, parallel 'Cannot create a file when that file already exists' or 'file is being used by another process', shared paths, missing AppendTargetFrameworkToOutputPath, PublishReadyToRun, SetTargetFramework on single-target references. DO NOT USE FOR: duplicates or invariant-generation races (find-repeated-work-within-one-build), OS locking, single-instance builds, non-MSBuild systems. | 71 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
clr-activation-debugging plugins/dotnet-diag/skills/clr-activation-debugging/SKILL.md Diagnoses .NET Framework CLR activation issues using CLR activation logs (CLRLoad logs) produced by mscoree.dll. Use when: the shim picks the wrong runtime, fails to load any runtime, shows unexpected .NET 3.5 Feature-on-Demand (FOD) dialogs, unexpectedly does NOT show FOD dialogs, loads both v2 and v4 into the same process causing failures, or any time someone is wondering "what is happening with .NET Framework activation?" | 73 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
code-testing plugins/dotnet-test/skills/code-testing/SKILL.md ALWAYS USE for test work that requires changes: write, add, generate, repair, or strengthen tests for existing code in xUnit, MSTest, NUnit, pytest, Vitest/Jest, Go, or another framework. Includes regression cases, failing or flaky tests, coverage-driven additions, and audit-then-fix requests. Focused work stays direct; broad or multi-stage work invokes test-engineer. DO NOT USE for only running tests, analysis-only audits, framework/platform migrations, a test blocked on a missing production seam (testability-obstacle), or MSTest API/configuration corrections that do not design new cases (writing-mstest-tests). Within an active test-engineer pipeline, reuse supplied guidance and do not re-enter this skill. | 64 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
code-testing-agent plugins/dotnet-test/skills/code-testing-agent/SKILL.md Legacy compatibility alias for the code-testing skill. Do not self-activate for user requests and do not treat this name as a custom agent. When invoked explicitly by older instructions, load code-testing and follow it instead. | 73 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
code-testing-extensions plugins/dotnet-test/skills/code-testing-extensions/SKILL.md Provides file paths to language-specific extension files for the code-testing pipeline. Read this reference-only catalog for extension guidance files (e.g., dotnet.md for .NET, cpp.md for C++). Agents and skills read its bundled files directly; do not invoke this catalog through the model's skill tool. | 64 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
collect-user-input plugins/dotnet-blazor/skills/collect-user-input/SKILL.md Build forms, validate data, and react to user input in Blazor. USE FOR adding forms, search boxes, filter panels, inline editing, data-entry UI, file uploads, validation (annotations or custom), handling form submissions, and binding input controls. Covers EditForm, built-in input components, DataAnnotationsValidator, custom validation, SSR form patterns (SupplyParameterFromForm, FormName, AntiforgeryToken, Enhance), and @bind for simple interactive controls. DO NOT USE for project scaffolding (see create-blazor-project) or prerendering issues (see support-prerendering). | 74 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
configure-auth plugins/dotnet-blazor/skills/configure-auth/SKILL.md Add authentication and authorization to a Blazor Web App, accounting for the app's render mode. USE WHEN the user needs [Authorize] on pages, AuthorizeView, role or policy-based access, login/logout Identity pages, or AuthenticationStateProvider. Also USE WHEN auth state is null after WebAssembly loads, SignInManager throws in an interactive component, NotAuthorized content never renders in static SSR, or HttpContext.User is null in an interactive component. DO NOT USE for general component authoring (see author-component), for prerendering concerns unrelated to auth (see support-prerendering), or for managing non-auth cascading state (see coordinate-components). | 74 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 | |
convert-blazor-server-to-webapp plugins/dotnet-aspnetcore/skills/convert-blazor-server-to-webapp/SKILL.md Guides conversion of a pre-.NET 8 Blazor Server app into a .NET 8+ Blazor Web App. USE FOR: migrating apps that use AddServerSideBlazor and MapBlazorHub to the AddRazorComponents/MapRazorComponents model, converting _Host.cshtml to an App.razor root component, replacing blazor.server.js with blazor.web.js, migrating CascadingAuthenticationState to a service, adopting new Blazor Web App features like enhanced navigation and streaming rendering. DO NOT USE FOR: apps that are already Blazor Web Apps (already use AddRazorComponents and MapRazorComponents), Blazor WebAssembly or hosted Blazor WebAssembly apps (different migration path), apps that should stay on the Blazor Server hosting model without converting, or apps still targeting .NET Framework. | 76 Impact — No eval scenarios have been run Securityby Passed No findings from the security scan Version: 2877c71 |