Aaronontheweb/dotnet-skills

A comprehensive AI coding plugin with **30 skills** and **5 specialized agents** for professional .NET development. Battle-tested patterns from production systems covering C#, Akka.NET, Aspire, EF Core, testing, and performance optimization.
Installation
This plugin works with multiple AI coding assistants that support skills/agents.
Claude Code (CLI)
Official Docs
Run these commands inside the Claude Code CLI (the terminal app, not the VSCode extension):
To update:
Codex (OpenAI)
Official Docs
Add the marketplace, then install the plugin:
Verify the install:
Skills are auto-discovered from the plugin's skills/ directory. Invoke one with /skills or $skill-name in the Codex CLI or IDE extension. Note: the specialized agents are Claude Code-specific and are not included in the Codex plugin.
GitHub Copilot
Official Docs
Clone or copy skills to your project or global config:
**Project-level** (recommended):
**Global** (all projects):
OpenCode
Official Docs
---
Suggested AGENTS.md / CLAUDE.md Snippets
These snippets go in your **project root** (the root directory of your codebase, next to your .git folder):
- Claude Code: CLAUDE.md
- OpenCode: AGENTS.md
Prerequisite: install/sync the dotnet-skills plugin in your assistant runtime (Claude Code or OpenCode) so the skill IDs below resolve.
To get consistent skill usage in downstream repos, add a small router snippet in AGENTS.md (OpenCode) or CLAUDE.md (Claude Code). These snippets tell the assistant which skills to use for common tasks.
Readable snippet (copy/paste)
Compressed snippet (generated)
Run ./scripts/generate-skill-index-snippets.sh --update-readme to refresh the block below.
Specialized Agents
Agents are AI personas with deep domain expertise. They're invoked automatically when Claude Code detects relevant tasks.
| Agent | Expertise |
| --------------------------------- | ---------------------------------------------------------------------- |
| **akka-net-specialist** | Actor systems, clustering, persistence, Akka.Streams, message patterns |
| **dotnet-concurrency-specialist** | Threading, async/await, race conditions, deadlock analysis |
| **dotnet-benchmark-designer** | BenchmarkDotNet setup, custom benchmarks, measurement strategies |
| **dotnet-performance-analyst** | Profiler analysis, benchmark interpretation, regression detection |
| **docfx-specialist** | DocFX builds, API documentation, markdown linting |
---
Skills Library
Akka.NET
Production patterns for building distributed systems with Akka.NET.
| Skill | What You'll Learn |
| -------------------------- | --------------------------------------------------------------------------- |
| **best-practices** | EventStream vs DistributedPubSub, supervision strategies, actor hierarchies |
| **testing-patterns** | Akka.Hosting.TestKit, async assertions, TestProbe patterns |
| **hosting-actor-patterns** | Props factories, IRequiredActor , DI scope management in actors |
| **aspire-configuration** | Akka.NET + .NET Aspire integration, HOCON with IConfiguration |
| **management** | Akka.Management, health checks, cluster bootstrap |
C# Language
Modern C# patterns for clean, performant code.
| Skill | What You'll Learn |
| --------------------------- | ----------------------------------------------------------------------- |
| **coding-standards** | Records, pattern matching, nullable types, value objects, no AutoMapper |
| **concurrency-patterns** | When to use Task vs Channel vs lock vs actors |
| **api-design** | Extend-only design, API/wire compatibility, versioning strategies |