--- name: .NET Performance Engineering slug: net-performance-engineering category: Quality description: Evidence-first performance engineering workflow for coding agents that combines portable .NET diagnostics with platform-native profiling, BenchmarkDotNet, application benchmarking, and statistical validation across deployment, container, graphics, and GPU procedures. github: "https://github.com/wieslawsoltes/Performance-Skill" language: Python stars: 32 forks: 0 install: "npx degit https://github.com/wieslawsoltes/Performance-Skill ~/.claude/skills/Performance-Skill" installs_to: ~/.claude/skills/Performance-Skill source_path: SKILL.md collection_size: 1 category_size: 1354 added: 2026-08-11T07:21:50.986Z last_synced: 2026-08-11T07:21:50.986Z canonical_url: "https://dirskills.com/skills/net-performance-engineering" --- # .NET Performance Engineering Evidence-first performance engineering workflow for coding agents that combines portable .NET diagnostics with platform-native profiling, BenchmarkDotNet, application benchmarking, and statistical validation across deployment, container, graphics, and GPU procedures. **Install:** ```bash npx degit https://github.com/wieslawsoltes/Performance-Skill ~/.claude/skills/Performance-Skill ``` ## README # Performance Skill A single, modular coding-agent skill for rigorous cross-platform .NET performance engineering. The repository exposes one installable skill through [`SKILL.md`](./SKILL.md). Detailed procedures are organized by domain and platform: ```text SKILL.md references/ index.md command-reference.md core/ index.md guide.md runtime/ index.md guide.md memory/ index.md guide.md latency/ index.md guide.md startup/ index.md guide.md benchmarking/ index.md guide.md production/ index.md guide.md gpu/ index.md guide.md platforms/ index.md macos.md windows.md linux.md scripts/ validate-skill.py xctrace-export.py ``` Each `index.md` is a compact router. The detailed guides preserve operational procedures and are loaded only when the investigation crosses that domain or platform boundary. [`references/command-reference.md`](references/command-reference.md) is the authoritative command-syntax layer and contains official documentation footnotes.[^command-reference] ## Coverage | Area | Operational coverage | |---|---| | Managed runtime | `dotnet-counters`, `dotnet-trace`, `dotnet-stack`, `dotnet-gcdump`, `dotnet-dump`, SOS, allocation, GC, JIT, tiering, exceptions, ThreadPool, locks | | Memory | Managed retention, native heaps, VM mappings, RSS/PSS/private memory, LOH, pinning, finalization, interop ownership, GPU residency | | Concurrency and latency | Async critical paths, starvation, contention, queues, backpressure, timers, file/network/database I/O, distributed tracing, UI dispatcher latency | | Startup and deployment | Cold/warm startup, first frame/request, loader, ReadyToRun, trimming, single-file, NativeAOT, first-use regressions | | .NET benchmarking | BenchmarkDotNet configuration, micro/component/macro/load/soak design, async and multithreaded benchmarks, allocations, disassembly, hardware counters, SIMD, JIT/PGO/R2R/AOT comparisons, paired runs, statistics, CI regression gates, and application validation | | Production | `dotnet-monitor`, diagnostic ports, containers, Kubernetes, triggered/bounded collection, permissions, privacy, and artifact handling | | Platform tooling | Instruments/`xctrace`; WPR/WPA, ETW, PerfView, WinDbg; `perf`, eBPF, procfs, native allocators | | GPU/rendering | Metal, D3D11/12, Vulkan, OpenGL, WebGPU/wgpu-native, timestamps, queues, barriers, shaders, uploads, memory, compositor, and presentation | ## Installation Copy or link this repository into the skills directory used by your coding agent: ```text /dotnet-performance/SKILL.md ``` Keep the complete `references` directory beside `SKILL.md` so relative links remain valid. ## Command correctness policy Before executing a documented command: 1. read [`references/command-reference.md`](references/command-reference.md); 2. record the installed tool version; 3. query the tool's `--help`, profiles, templates, or supported capabilities; 4. preserve the exact command beside the raw artifact; 5. prefer primary documentation linked through the footnotes. The command audit specifically corrects current `dotnet-trace` profile names, version-dependent `xctrace export` input syntax, `xctrace record` launch separators, absolute launch-target resolution, `perf sched` subcommand semantics, PresentMon options, BenchmarkDotNet runtime constants, and distribution-dependent BCC command names.[^dotnet-trace][^xctrace][^perf-sched][^presentmon][^benchmarkdotnet][^bcc] ## Validation Run the repository validator after structural or documentation changes: ```bash python3 scripts/validate-skill.py ``` It checks the single-skill contract, front matter, relative Markdown links, stale legacy paths, missing domain indexes/guides, documentation-footnote coverage, and common command-profile regressions. ## Example prompts ```text Profile this .NET application and find the dominant CPU bottleneck. ``` ```text Investigate why RSS grows while the managed heap stays stable. ``` ```text Diagnose ThreadPool starvation and p99 request latency under load. ``` ```text Compare JIT, ReadyToRun, trimmed single-file, and NativeAOT startup behavior. ``` ```text Create production-grade BenchmarkDotNet benchmarks for this hot path, inspect generated assembly and allocations, and validate the result in the real application. ``` ```text Profile this WebGPU renderer end-to-end and prove whether it is CPU, driver, GPU, compositor, or presentation bound. ``` ```text Collect bounded production evidence from this Kubernetes workload without destabilizing it. ``` ## Design principles - One skill with selectively loaded domain and platform references. - Evidence before optimization. - Exact capture and benchmark commands with analysis procedures. - Explicit ownership across managed, native, kernel, scheduler, I/O, dependency, driver, GPU, compositor, and display layers. - Reproducible inputs, workloads, and raw artifact preservation. - Equivalent before/after validation with tail metrics and variance. - Automated structural checks for links, routing, footnotes, and stale command guidance. ## License Licensed under the [MIT License](LICENSE). ## Documentation footnotes [^command-reference]: [`references/command-reference.md`](references/command-reference.md). [^dotnet-trace]: Microsoft, [`dotnet-trace`](https://learn.microsoft.com/dotnet/core/diagnostics/dotnet-trace). [^xctrace]: Apple/Xcode, [`xctrace(1)`](https://keith.github.io/xcode-man-pages/xctrace.1.html). [^perf-sched]: Linux, [`perf-sched(1)`](https://man7.org/linux/man-pages/man1/perf-sched.1.html). [^presentmon]: GameTechDev, [PresentMon console application](https://github.com/GameTechDev/PresentMon/blob/main/README-ConsoleApplication.md). [^benchmarkdotnet]: BenchmarkDotNet, [official documentation](https://benchmarkdotnet.org/). [^bcc]: iovisor, [BCC](https://github.com/iovisor/bcc).