How do I install dotnet-skills?

Run these in Claude Code: /plugin marketplace add aaronontheweb/dotnet-skills then /plugin install dotnet-skills@dotnet-skills. Then prompt normally.

Does dotnet-skills auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Is dotnet-skills free?

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

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.

FLOW.md

aaronontheweb@aaronontheweb

GitHub

Plugin Signal83/100Strong

maintained99

capable78

documented75

adopted65

Install on Claude Code

> /plugin marketplace add aaronontheweb/dotnet-skills
> /plugin install dotnet-skills@dotnet-skills

Stats

HTML Bash C#Docker Azure

+7 tags

Git GitHub CI/CD Playwright Markdown Anthropic OpenAI

1,106

Stars

101

Forks

Active

Maintenance

Shell

Language

MIT

License

2d ago

Last commit

9mo ago

Created

Repo: aaronontheweb/dotnet-skills

In this plugin

36 skills 6 agents

See everything inside

What's inside

Skills

/akka-aspire-configurationConfigure Akka.NET with .NET Aspire for local development and production deployments. Covers actor system setup, clustering, persistence, Akka.Management integration, and Aspire orchestration patterns./akka-best-practicesCritical Akka.NET best practices including EventStream vs DistributedPubSub, supervision strategies, error handling, Props vs DependencyResolver, work distribution patterns, and cluster/local mode abstractions for testability./akka-hosting-actor-patternsPatterns for building entity actors with Akka.Hosting - GenericChildPerEntityParent, message extractors, cluster sharding abstraction, akka-reminders, and ITimeProvider. Supports both local testing and clustered production modes./akka-managementAkka.Management for cluster bootstrapping, service discovery (Kubernetes, Azure, Config), health checks, and dynamic cluster formation without static seed nodes./akka-testing-patternsWrite unit and integration tests for Akka.NET actors using modern Akka.Hosting.TestKit patterns. Covers dependency injection, TestProbes, persistence testing, and actor interaction verification. Includes guidance on when to use traditional TestKit./aspire-configurationConfigure Aspire AppHost to emit explicit app config via environment variables; keep app code free of Aspire clients and service discovery.

Show all 36 skills

/aspire-integration-testingWrite integration tests using .NET Aspire's testing facilities with xUnit. Covers test fixtures, distributed application setup, endpoint discovery, and patterns for testing ASP.NET Core apps with real dependencies./aspire-mailpit-integrationTest email sending locally using Mailpit with .NET Aspire. Captures all outgoing emails without sending them. View rendered HTML, inspect headers, and verify delivery in integration tests./aspire-service-defaultsCreate a shared ServiceDefaults project for Aspire applications. Centralizes OpenTelemetry, health checks, resilience, and service discovery configuration across all services./crap-analysisAnalyze code coverage and CRAP (Change Risk Anti-Patterns) scores to identify high-risk code. Use OpenCover format with ReportGenerator for Risk Hotspots showing cyclomatic complexity and untested code paths./csharp-api-designDesign stable, compatible public APIs using extend-only design principles. Manage API compatibility, wire compatibility, and versioning for NuGet packages and distributed systems./csharp-coding-standardsWrite modern, high-performance C# code using records, pattern matching, value objects, async/await, Span<T>/Memory<T>, and best-practice API design patterns. Emphasizes functional-style programming with C# 12+ features./csharp-concurrency-patternsChoosing the right concurrency abstraction in .NET - from async/await for I/O to Channels for producer/consumer to Akka.NET for stateful entity management. Avoid locks and manual synchronization unless absolutely necessary./csharp-nullable-reference-typesGuidelines for introducing and using nullable reference types (NRT) and System.Diagnostics.CodeAnalysis nullable attributes in C# / .NET codebases. Covers the nullability model, flow analysis, the null-forgiving operator, API design rules, the full attribute catalog (AllowNull,/csharp-type-design-performanceDesign .NET types for performance. Seal classes, use readonly structs, prefer static pure functions, avoid premature enumeration, and choose the right collection types./database-performanceDatabase access patterns for performance. Separate read/write models, avoid N+1 queries, use AsNoTracking, apply row limits, and never do application-side joins. Works with EF Core and Dapper./dotnet-devcert-trustDiagnose and fix .NET HTTPS dev certificate trust issues on Linux. Covers the full certificate lifecycle from generation to system CA bundle inclusion, with distro-specific guidance for Ubuntu, Fedora, Arch, and WSL2./efcore-patternsEntity Framework Core best practices including NoTracking by default, query splitting for navigation collections, migration management, dedicated migration services, and common pitfalls to avoid./ilspy-decompileUnderstand implementation details of .NET code by decompiling assemblies. Use when you want to see how a .NET API works internally, inspect NuGet package source, view framework implementation, or understand compiled .NET binaries./local-toolsManaging local .NET tools with dotnet-tools.json for consistent tooling across development environments and CI/CD pipelines./marketplace-publishingWorkflow for publishing skills and agents to the dotnet-skills Claude Code marketplace. Covers adding new content, updating plugin.json, validation, and release tagging./microsoft-extensions-configurationMicrosoft.Extensions.Options patterns including IValidateOptions, strongly-typed settings, validation on startup, and the Options pattern for clean configuration management./microsoft-extensions-dependency-injectionOrganize DI registrations using IServiceCollection extension methods. Group related services into composable Add* methods for clean Program.cs and reusable configuration in tests./mjml-email-templatesBuild responsive email templates using MJML markup language. Compiles to cross-client HTML that works in Outlook, Gmail, and Apple Mail. Includes template renderer, layout patterns, and variable substitution./opentelementry-dotnet-instrumentationProvides guidance for implementing OpenTelemetry instrumentation in .NET codebases, covering tracing (Activities/Spans), metrics, logs, naming conventions, error handling, performance, SDK setup, resources, context propagation, and API design best practices./package-managementManage NuGet packages using Central Package Management (CPM) and dotnet CLI commands. Never edit XML directly - use dotnet add/remove/list commands. Use shared version variables for related packages./playwright-blazorWrite UI tests for Blazor applications (Server or WebAssembly) using Playwright. Covers navigation, interaction, authentication, selectors, and common Blazor-specific patterns./playwright-ci-cachingCache Playwright browser binaries in CI/CD pipelines (GitHub Actions, Azure DevOps) to avoid 1-2 minute download overhead on every build./project-structureModern .NET project structure including .slnx solution format, Directory.Build.props, central package management, SourceLink, version management with RELEASE_NOTES.md, and SDK pinning with global.json./r3-reactive-extensionsBuild reactive/event-driven C# with R3 (Cysharp's modern reimplementation of Reactive Extensions). Covers the Observable<T>/Observer<T> model, the OnErrorResume error contract, async dispatch with AwaitOperation, Task/IAsyncEnumerable integration, TimeProvider/FrameProvider /serializationChoose the right serialization format for .NET applications. Prefer schema-based formats (Protobuf, MessagePack) over reflection-based (Newtonsoft.Json). Use System.Text.Json with AOT source generators for JSON scenarios./skills-index-snippetsCreate and maintain AGENTS.md / CLAUDE.md snippet indexes that route tasks to the correct dotnet-skills skills and agents (including compressed Vercel-style indexes)./slopwatchUse Slopwatch to detect LLM reward hacking in .NET code changes. Run after every code modification to catch disabled tests, suppressed warnings, empty catch blocks, and other shortcuts that mask real problems./snapshot-testingUse Verify for snapshot testing in .NET. Approve API surfaces, HTTP responses, rendered emails, and serialized outputs. Detect unintended changes through human-reviewed baseline files./testcontainersWrite integration tests using TestContainers for .NET with xUnit. Covers infrastructure testing with real databases, message queues, and caches in Docker containers instead of mocks./verify-email-snapshotsSnapshot test email templates using Verify to catch regressions. Validates rendered HTML output matches approved baseline. Works with MJML templates and any email renderer.

Agents

akka-net-specialistExpert in Akka.NET architecture, actor systems, and distributed computing patterns. Specializes in analyzing actor lifecycle issues, message passing problems, cluster coordination, persistence, and stream processing. Use for Akka.NET-specific debugging, architecture decisions,docfx-specialistExpert in DocFX documentation system, markdown formatting, and Akka.NET documentation standards. Handles DocFX-specific syntax, API references, build validation, and compliance with project documentation guidelines. Integrates markdownlint and DocFX compilation checks.dotnet-benchmark-designerExpert in designing effective .NET performance benchmarks and instrumentation. Specializes in BenchmarkDotNet patterns, custom benchmark design, profiling setup, and choosing the right measurement approach for different scenarios. Knows when BenchmarkDotNet isn't suitable and dotnet-concurrency-specialistExpert in .NET concurrency, threading, and race condition analysis. Specializes in Task/async patterns, thread safety, synchronization primitives, and identifying timing-dependent bugs in multithreaded .NET applications. Use for analyzing racy unit tests, deadlocks, and dotnet-performance-analystExpert in analyzing .NET application performance data, profiling results, and benchmark comparisons. Specializes in JetBrains profiler analysis, BenchmarkDotNet result interpretation, baseline comparisons, regression detection, and performance bottleneck identification.roslyn-incremental-generator-specialistDesign and maintain Roslyn incremental source generators with strict pipeline discipline, parser vs emitter separation, and long-term maintainability for large generator suites.

README

Read on GitHub

.NET Skills for Claude Code and Codex

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):

/plugin marketplace add Aaronontheweb/dotnet-skills
/plugin install dotnet-skills

To update:

/plugin marketplace update

Codex (OpenAI)

Official Docs

Add the marketplace, then install the plugin:

codex plugin marketplace add Aaronontheweb/dotnet-skills
codex plugin add dotnet-skills@dotnet-skills

Verify the install:

codex plugin list

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):

# Clone to .github/skills/ in your project
git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills
cp -r /tmp/dotnet-skills/skills/* .github/skills/

Global (all projects):

mkdir -p ~/.copilot/skills
cp -r /tmp/dotnet-skills/skills/* ~/.copilot/skills/

OpenCode

Official Docs

git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills

# Global installation (directory names must match frontmatter 'name' field)
mkdir -p ~/.config/opencode/skills ~/.config/opencode/agents
for skill_file in /tmp/dotnet-skills/skills/*/SKILL.md; do
  skill_name=$(grep -m1 "^name:" "$skill_file" | sed 's/name: *//')
  mkdir -p ~/.config/opencode/skills/$skill_name
  cp "$skill_file" ~/.config/opencode/skills/$skill_name/SKILL.md
done
cp /tmp/dotnet-skills/agents/*.md ~/.config/opencode/agents/

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)

# Agent Guidance: dotnet-skills

IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
Workflow: skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts.

Routing (invoke by name)
- C# / code quality: modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance, r3-reactive-extensions
- ASP.NET Core / Web (incl. Aspire): aspire-service-defaults, aspire-integration-testing, transactional-emails
- Data: efcore-patterns, database-performance
- DI / config: dependency-injection-patterns, microsoft-extensions-configuration
- Testing: testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing

Quality gates (use when applicable)
- dotnet-slopwatch: after substantial new/refactor/LLM-authored code
- crap-analysis: after tests added/changed in complex code

Specialist agents
- dotnet-concurrency-specialist, dotnet-performance-analyst, dotnet-benchmark-designer, akka-net-specialist, docfx-specialist

Compressed snippet (generated)

Run ./scripts/generate-skill-index-snippets.sh --update-readme to refresh the block below.

[dotnet-skills]|IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
|flow:{skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts}
|route:
|akka:{akka-net-best-practices,akka-net-testing-patterns,akka-hosting-actor-patterns,akka-net-aspire-configuration,akka-net-management}
|csharp:{modern-csharp-coding-standards,csharp-concurrency-patterns,csharp-nullable-reference-types,api-design,type-design-performance,r3-reactive-extensions}
|aspnetcore-web:{aspire-integration-testing,aspire-configuration,aspire-service-defaults,mailpit-integration,mjml-email-templates}
|data:{efcore-patterns,database-performance}
|di-config:{microsoft-extensions-configuration,dependency-injection-patterns}
|testing:{testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing,verify-email-snapshots,playwright-ci-caching}
|dotnet:{dotnet-project-structure,dotnet-local-tools,package-management,serialization,dotnet-devcert-trust,ilspy-decompile,opentelemetry-net-instrumentation}
|quality-gates:{dotnet-slopwatch,crap-analysis}
|meta:{marketplace-publishing,skills-index-snippets}
|agents:{akka-net-specialist,docfx-specialist,dotnet-benchmark-designer,dotnet-concurrency-specialist,dotnet-performance-analyst,roslyn-incremental-generator-specialist}

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<T>`, 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
type-design-performance	Sealed classes, readonly structs, static pure functions, Span<T>
r3-reactive-extensions	R3 vs Rx.NET, OnErrorResume, AwaitOperation async dispatch, concurrency, TimeProvider/FrameProvider

Data Access

Database patterns that scale.

Skill	What You'll Learn
efcore-patterns	Entity configuration, migrations, query optimization
database-performance	Read/write separation, N+1 prevention, AsNoTracking, row limits

.NET Aspire

Cloud-native application orchestration.

Skill	What You'll Learn
integration-testing	DistributedApplicationTestingBuilder, Aspire.Hosting.Testing
service-defaults	OpenTelemetry, health checks, resilience, service discovery
mailpit-integration	Email testing with Mailpit container, SMTP config, test assertions

ASP.NET Core

Web application patterns.

Skill	What You'll Learn
mjml-email-templates	MJML syntax, responsive layouts, template renderer, composer pattern

.NET Ecosystem

Core .NET development practices.

Skill	What You'll Learn
project-structure	Solution layout, Directory.Build.props, layered architecture
package-management	Central Package Management (CPM), shared version variables, dotnet CLI
serialization	Protobuf, MessagePack, System.Text.Json source generators, AOT
local-tools	dotnet tool manifests, team-shared tooling
slopwatch	Detect LLM-generated anti-patterns in your codebase

Microsoft.Extensions

Dependency injection and configuration patterns.

Skill	What You'll Learn
configuration	IOptions pattern, environment-specific config, secrets management
dependency-injection	IServiceCollection extensions, scope management, keyed services

Testing

Comprehensive testing strategies.

Skill	What You'll Learn
testcontainers	Docker-based integration tests, PostgreSQL, Redis, RabbitMQ
playwright-blazor	E2E testing for Blazor apps, page objects, async assertions
crap-analysis	CRAP scores, coverage thresholds, ReportGenerator integration
snapshot-testing	Verify library, approval testing, API response validation
verify-email-snapshots	Snapshot test email templates, catch rendering regressions

Key Principles

These skills emphasize patterns that work in production:

Immutability by default - Records, readonly structs, value objects
Type safety - Nullable reference types, strongly-typed IDs
Composition over inheritance - No abstract base classes, sealed by default
Performance-aware - Span<T>, pooling, deferred enumeration
Testable - DI everywhere, pure functions, explicit dependencies
No magic - No AutoMapper, no reflection-heavy frameworks

Repository Structure

dotnet-skills/
├── .claude-plugin/
│   ├── plugin.json         # Claude Code plugin manifest
│   └── marketplace.json    # Claude Code marketplace
├── .codex-plugin/
│   └── plugin.json         # Codex plugin manifest
├── .agents/
│   └── plugins/
│       └── marketplace.json  # Codex marketplace
├── agents/                 # 5 specialized agents (Claude Code)
│   ├── akka-net-specialist.md
│   ├── docfx-specialist.md
│   ├── dotnet-benchmark-designer.md
│   ├── dotnet-concurrency-specialist.md
│   └── dotnet-performance-analyst.md
└── skills/                 # Flat structure (30 skills)
    ├── akka-best-practices/SKILL.md
    ├── akka-hosting-actor-patterns/SKILL.md
    ├── akka-net-aspire-configuration/SKILL.md
    ├── aspire-configuration/SKILL.md
    ├── aspire-integration-testing/SKILL.md
    ├── csharp-concurrency-patterns/SKILL.md
    ├── testcontainers-integration-tests/SKILL.md
    └── ...                 # (prefixed by category)

Contributing

Want to add a skill or agent? PRs welcome!

Create skills/<skill-name>/SKILL.md (use prefixes like akka-, aspire-, csharp- for category)
Add the path to .claude-plugin/plugin.json (the Codex plugin auto-discovers the whole skills/ dir)
Run ./scripts/validate-marketplace.sh and ./scripts/validate-codex-plugin.sh
Submit a PR

Skills should be comprehensive reference documents (10-40KB) with concrete examples and anti-patterns.

Author

Created by Aaron Stannard (@Aaronontheweb)

Patterns drawn from production systems including Akka.NET, Petabridge, and Sdkbin.

License

See LICENSE for full details.

File tree

aaronontheweb/dotnet-skillsView on GitHub

.agents/
  plugins/
    marketplace.json
.claude-plugin/
  marketplace.json
  plugin.json
.codex-plugin/
  plugin.json
.github/
  workflows/
    release.yml
.gitignore
agents/
AGENTS.md
  akka-net-specialist.md
  docfx-specialist.md
  dotnet-benchmark-designer.md
  dotnet-concurrency-specialist.md
  dotnet-performance-analyst.md
  roslyn-incremental-generator-specialist.md
CLAUDE.md
LICENSE
README.md
RELEASE_NOTES.md
scripts/
  bump-version.sh
  generate-release-summary.sh
  generate-skill-index-snippets.sh
  validate-codex-plugin.sh
  validate-marketplace.sh
skills/
  akka-aspire-configuration/
    SKILL.md
  akka-best-practices/
    async-cancellation-patterns.md
    cluster-local-abstractions.md
    SKILL.md
    work-distribution-patterns.md
  akka-hosting-actor-patterns/
    SKILL.md
  akka-management/
    configuration-reference.md
    discovery-providers.md
    SKILL.md
  akka-testing-patterns/
    anti-patterns-and-reference.md
    examples.md
    SKILL.md
  aspire-configuration/
    SKILL.md
  aspire-integration-testing/
    advanced-patterns.md
    ci-and-tooling.md
    SKILL.md
  aspire-mailpit-integration/
    SKILL.md
  aspire-service-defaults/
    SKILL.md
  crap-analysis/
    SKILL.md
  csharp-api-design/
    SKILL.md
  csharp-coding-standards/
    anti-patterns-and-reflection.md
    composition-and-error-handling.md
    performance-and-api-design.md
    SKILL.md
    value-objects-and-patterns.md
  csharp-concurrency-patterns/
    advanced-concurrency.md
    SKILL.md
  csharp-nullable-reference-types/
    nrt-migration-playbook-reference.md
    nullable-attributes-reference.md
    SKILL.md
  csharp-type-design-performance/
    SKILL.md
  database-performance/
    SKILL.md
  dotnet-devcert-trust/
    SKILL.md
  efcore-patterns/
    SKILL.md
  ilspy-decompile/
    SKILL.md
  local-tools/
    SKILL.md
  marketplace-publishing/
    SKILL.md
  microsoft-extensions-configuration/
    advanced-patterns.md
    SKILL.md
  microsoft-extensions-dependency-injection/
    advanced-patterns.md
    SKILL.md
  mjml-email-templates/
    SKILL.md
  opentelementry-dotnet-instrumentation/
    metrics-and-instruments-reference.md
    sdk-resources-and-logs-reference.md
    SKILL.md
    traces-and-propagation-reference.md
  package-management/
    SKILL.md
  playwright-blazor/
    SKILL.md
  playwright-ci-caching/
    SKILL.md
  project-structure/
    SKILL.md
  r3-reactive-extensions/
    async-and-integration-patterns.md
    rx-net-differences.md
    scheduling-and-concurrency.md
    SKILL.md
  serialization/
    SKILL.md
  skills-index-snippets/
    SKILL.md
  slopwatch/
    SKILL.md
  snapshot-testing/
    SKILL.md
  testcontainers/
    database-patterns.md
    infrastructure-patterns.md
    SKILL.md
  verify-email-snapshots/
    SKILL.md

FAQ

dotnet-skills is a Claude Code plugin with 36 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes akka-aspire-configuration, akka-best-practices, akka-hosting-actor-patterns. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is 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.
How do I install dotnet-skills?: Run these in Claude Code: /plugin marketplace add aaronontheweb/dotnet-skills then /plugin install dotnet-skills@dotnet-skills. Then prompt normally.
Does dotnet-skills auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is dotnet-skills free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

dotnet-skills

FLOW.md

aaronontheweb@aaronontheweb

GitHub

Plugin Signal83/100Strong

maintained99

capable78

documented75

adopted65

Install on Claude Code

> /plugin marketplace add aaronontheweb/dotnet-skills
> /plugin install dotnet-skills@dotnet-skills

Stats

HTML Bash C#Docker Azure

+7 tags

Git GitHub CI/CD Playwright Markdown Anthropic OpenAI

1,106

Stars

101

Forks

Active

Maintenance

Shell

Language

MIT

License

2d ago

Last commit

9mo ago

Created

Repo: aaronontheweb/dotnet-skills

In this plugin

36 skills 6 agents

See everything inside

What's inside

Skills

Show all 36 skills

Agents

README

Read on GitHub

.NET Skills for Claude Code and Codex

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):

/plugin marketplace add Aaronontheweb/dotnet-skills
/plugin install dotnet-skills

To update:

/plugin marketplace update

Codex (OpenAI)

Official Docs

Add the marketplace, then install the plugin:

codex plugin marketplace add Aaronontheweb/dotnet-skills
codex plugin add dotnet-skills@dotnet-skills

Verify the install:

codex plugin list

GitHub Copilot

Official Docs

Clone or copy skills to your project or global config:

Project-level (recommended):

# Clone to .github/skills/ in your project
git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills
cp -r /tmp/dotnet-skills/skills/* .github/skills/

Global (all projects):

mkdir -p ~/.copilot/skills
cp -r /tmp/dotnet-skills/skills/* ~/.copilot/skills/

OpenCode

Official Docs

git clone https://github.com/Aaronontheweb/dotnet-skills.git /tmp/dotnet-skills

# Global installation (directory names must match frontmatter 'name' field)
mkdir -p ~/.config/opencode/skills ~/.config/opencode/agents
for skill_file in /tmp/dotnet-skills/skills/*/SKILL.md; do
  skill_name=$(grep -m1 "^name:" "$skill_file" | sed 's/name: *//')
  mkdir -p ~/.config/opencode/skills/$skill_name
  cp "$skill_file" ~/.config/opencode/skills/$skill_name/SKILL.md
done
cp /tmp/dotnet-skills/agents/*.md ~/.config/opencode/agents/

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.

Readable snippet (copy/paste)

# Agent Guidance: dotnet-skills

IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
Workflow: skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts.

Routing (invoke by name)
- C# / code quality: modern-csharp-coding-standards, csharp-concurrency-patterns, api-design, type-design-performance, r3-reactive-extensions
- ASP.NET Core / Web (incl. Aspire): aspire-service-defaults, aspire-integration-testing, transactional-emails
- Data: efcore-patterns, database-performance
- DI / config: dependency-injection-patterns, microsoft-extensions-configuration
- Testing: testcontainers-integration-tests, playwright-blazor-testing, snapshot-testing

Quality gates (use when applicable)
- dotnet-slopwatch: after substantial new/refactor/LLM-authored code
- crap-analysis: after tests added/changed in complex code

Specialist agents
- dotnet-concurrency-specialist, dotnet-performance-analyst, dotnet-benchmark-designer, akka-net-specialist, docfx-specialist

Compressed snippet (generated)

Run ./scripts/generate-skill-index-snippets.sh --update-readme to refresh the block below.

[dotnet-skills]|IMPORTANT: Prefer retrieval-led reasoning over pretraining for any .NET work.
|flow:{skim repo patterns -> consult dotnet-skills by name -> implement smallest-change -> note conflicts}
|route:
|akka:{akka-net-best-practices,akka-net-testing-patterns,akka-hosting-actor-patterns,akka-net-aspire-configuration,akka-net-management}
|csharp:{modern-csharp-coding-standards,csharp-concurrency-patterns,csharp-nullable-reference-types,api-design,type-design-performance,r3-reactive-extensions}
|aspnetcore-web:{aspire-integration-testing,aspire-configuration,aspire-service-defaults,mailpit-integration,mjml-email-templates}
|data:{efcore-patterns,database-performance}
|di-config:{microsoft-extensions-configuration,dependency-injection-patterns}
|testing:{testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing,verify-email-snapshots,playwright-ci-caching}
|dotnet:{dotnet-project-structure,dotnet-local-tools,package-management,serialization,dotnet-devcert-trust,ilspy-decompile,opentelemetry-net-instrumentation}
|quality-gates:{dotnet-slopwatch,crap-analysis}
|meta:{marketplace-publishing,skills-index-snippets}
|agents:{akka-net-specialist,docfx-specialist,dotnet-benchmark-designer,dotnet-concurrency-specialist,dotnet-performance-analyst,roslyn-incremental-generator-specialist}

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<T>`, 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
type-design-performance	Sealed classes, readonly structs, static pure functions, Span<T>
r3-reactive-extensions	R3 vs Rx.NET, OnErrorResume, AwaitOperation async dispatch, concurrency, TimeProvider/FrameProvider

Data Access

Database patterns that scale.

Skill	What You'll Learn
efcore-patterns	Entity configuration, migrations, query optimization
database-performance	Read/write separation, N+1 prevention, AsNoTracking, row limits

.NET Aspire

Cloud-native application orchestration.

Skill	What You'll Learn
integration-testing	DistributedApplicationTestingBuilder, Aspire.Hosting.Testing
service-defaults	OpenTelemetry, health checks, resilience, service discovery
mailpit-integration	Email testing with Mailpit container, SMTP config, test assertions

ASP.NET Core

Web application patterns.

Skill	What You'll Learn
mjml-email-templates	MJML syntax, responsive layouts, template renderer, composer pattern

.NET Ecosystem

Core .NET development practices.

Skill	What You'll Learn
project-structure	Solution layout, Directory.Build.props, layered architecture
package-management	Central Package Management (CPM), shared version variables, dotnet CLI
serialization	Protobuf, MessagePack, System.Text.Json source generators, AOT
local-tools	dotnet tool manifests, team-shared tooling
slopwatch	Detect LLM-generated anti-patterns in your codebase

Microsoft.Extensions

Dependency injection and configuration patterns.

Skill	What You'll Learn
configuration	IOptions pattern, environment-specific config, secrets management
dependency-injection	IServiceCollection extensions, scope management, keyed services

Testing

Comprehensive testing strategies.

Skill	What You'll Learn
testcontainers	Docker-based integration tests, PostgreSQL, Redis, RabbitMQ
playwright-blazor	E2E testing for Blazor apps, page objects, async assertions
crap-analysis	CRAP scores, coverage thresholds, ReportGenerator integration
snapshot-testing	Verify library, approval testing, API response validation
verify-email-snapshots	Snapshot test email templates, catch rendering regressions

Key Principles

These skills emphasize patterns that work in production:

Immutability by default - Records, readonly structs, value objects
Type safety - Nullable reference types, strongly-typed IDs
Composition over inheritance - No abstract base classes, sealed by default
Performance-aware - Span<T>, pooling, deferred enumeration
Testable - DI everywhere, pure functions, explicit dependencies
No magic - No AutoMapper, no reflection-heavy frameworks

Repository Structure

dotnet-skills/
├── .claude-plugin/
│   ├── plugin.json         # Claude Code plugin manifest
│   └── marketplace.json    # Claude Code marketplace
├── .codex-plugin/
│   └── plugin.json         # Codex plugin manifest
├── .agents/
│   └── plugins/
│       └── marketplace.json  # Codex marketplace
├── agents/                 # 5 specialized agents (Claude Code)
│   ├── akka-net-specialist.md
│   ├── docfx-specialist.md
│   ├── dotnet-benchmark-designer.md
│   ├── dotnet-concurrency-specialist.md
│   └── dotnet-performance-analyst.md
└── skills/                 # Flat structure (30 skills)
    ├── akka-best-practices/SKILL.md
    ├── akka-hosting-actor-patterns/SKILL.md
    ├── akka-net-aspire-configuration/SKILL.md
    ├── aspire-configuration/SKILL.md
    ├── aspire-integration-testing/SKILL.md
    ├── csharp-concurrency-patterns/SKILL.md
    ├── testcontainers-integration-tests/SKILL.md
    └── ...                 # (prefixed by category)

Contributing

Want to add a skill or agent? PRs welcome!

Create skills/<skill-name>/SKILL.md (use prefixes like akka-, aspire-, csharp- for category)
Add the path to .claude-plugin/plugin.json (the Codex plugin auto-discovers the whole skills/ dir)
Run ./scripts/validate-marketplace.sh and ./scripts/validate-codex-plugin.sh
Submit a PR

Skills should be comprehensive reference documents (10-40KB) with concrete examples and anti-patterns.

Author

Created by Aaron Stannard (@Aaronontheweb)

Patterns drawn from production systems including Akka.NET, Petabridge, and Sdkbin.

License

See LICENSE for full details.

File tree

aaronontheweb/dotnet-skillsView on GitHub

.agents/
  plugins/
    marketplace.json
.claude-plugin/
  marketplace.json
  plugin.json
.codex-plugin/
  plugin.json
.github/
  workflows/
    release.yml
.gitignore
agents/
AGENTS.md
  akka-net-specialist.md
  docfx-specialist.md
  dotnet-benchmark-designer.md
  dotnet-concurrency-specialist.md
  dotnet-performance-analyst.md
  roslyn-incremental-generator-specialist.md
CLAUDE.md
LICENSE
README.md
RELEASE_NOTES.md
scripts/
  bump-version.sh
  generate-release-summary.sh
  generate-skill-index-snippets.sh
  validate-codex-plugin.sh
  validate-marketplace.sh
skills/
  akka-aspire-configuration/
    SKILL.md
  akka-best-practices/
    async-cancellation-patterns.md
    cluster-local-abstractions.md
    SKILL.md
    work-distribution-patterns.md
  akka-hosting-actor-patterns/
    SKILL.md
  akka-management/
    configuration-reference.md
    discovery-providers.md
    SKILL.md
  akka-testing-patterns/
    anti-patterns-and-reference.md
    examples.md
    SKILL.md
  aspire-configuration/
    SKILL.md
  aspire-integration-testing/
    advanced-patterns.md
    ci-and-tooling.md
    SKILL.md
  aspire-mailpit-integration/
    SKILL.md
  aspire-service-defaults/
    SKILL.md
  crap-analysis/
    SKILL.md
  csharp-api-design/
    SKILL.md
  csharp-coding-standards/
    anti-patterns-and-reflection.md
    composition-and-error-handling.md
    performance-and-api-design.md
    SKILL.md
    value-objects-and-patterns.md
  csharp-concurrency-patterns/
    advanced-concurrency.md
    SKILL.md
  csharp-nullable-reference-types/
    nrt-migration-playbook-reference.md
    nullable-attributes-reference.md
    SKILL.md
  csharp-type-design-performance/
    SKILL.md
  database-performance/
    SKILL.md
  dotnet-devcert-trust/
    SKILL.md
  efcore-patterns/
    SKILL.md
  ilspy-decompile/
    SKILL.md
  local-tools/
    SKILL.md
  marketplace-publishing/
    SKILL.md
  microsoft-extensions-configuration/
    advanced-patterns.md
    SKILL.md
  microsoft-extensions-dependency-injection/
    advanced-patterns.md
    SKILL.md
  mjml-email-templates/
    SKILL.md
  opentelementry-dotnet-instrumentation/
    metrics-and-instruments-reference.md
    sdk-resources-and-logs-reference.md
    SKILL.md
    traces-and-propagation-reference.md
  package-management/
    SKILL.md
  playwright-blazor/
    SKILL.md
  playwright-ci-caching/
    SKILL.md
  project-structure/
    SKILL.md
  r3-reactive-extensions/
    async-and-integration-patterns.md
    rx-net-differences.md
    scheduling-and-concurrency.md
    SKILL.md
  serialization/
    SKILL.md
  skills-index-snippets/
    SKILL.md
  slopwatch/
    SKILL.md
  snapshot-testing/
    SKILL.md
  testcontainers/
    database-patterns.md
    infrastructure-patterns.md
    SKILL.md
  verify-email-snapshots/
    SKILL.md

FAQ

What is 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.
How do I install dotnet-skills?: Run these in Claude Code: /plugin marketplace add aaronontheweb/dotnet-skills then /plugin install dotnet-skills@dotnet-skills. Then prompt normally.
Does dotnet-skills auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is dotnet-skills free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.