A comprehensive Claude Code plugin with 27 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.

Add the marketplace (one-time):

/plugin marketplace add Aaronontheweb/dotnet-skills

Install the plugin:

/plugin install dotnet-skills

To update:

/plugin marketplace update

OpenCode (https://opencode.ai/) is an open-source AI coding assistant that supports the same skill/agent format. These skills and agents are fully compatible with OpenCode.

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

# Create OpenCode skills directory
mkdir -p ~/.config/opencode/skills

# Install each skill (skill name must match frontmatter 'name' field)
for skill_file in $(find skills -name "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

# Create OpenCode agents directory
mkdir -p ~/.config/opencode/agents

# Install each agent
for agent_file in agents/\*.md; do
cp "$agent_file" ~/.config/opencode/agents/
done

If you're using OpenCode or another AI coding assistant, you can ask it to install these skills automatically:

Install the .NET skills from https://github.com/Aaronontheweb/dotnet-skills to my OpenCode configuration

The AI will:

1. Clone the repository
2. Extract skill names from SKILL.md frontmatter
3. Create properly structured directories in ~/.config/opencode/skills/
4. Copy agent files to ~/.config/opencode/agents/
   Installed Locations
   | Type | Location |
   |------|----------|
   | Skills | ~/.config/opencode/skills/<skill-name>/SKILL.md |
   | Agents | ~/.config/opencode/agents/<agent-name>.md |
   Compatibility Note
   The SKILL.md and agent markdown formats follow the Agent Skills open standard (https://opencode.ai/docs/skills/), which is compatible with multiple AI coding tools including Claude Code and OpenCode.

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.

# 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
- 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

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:
|csharp:{modern-csharp-coding-standards,csharp-concurrency-patterns,api-design,type-design-performance}
|aspnetcore-web:{aspire-integration-testing,aspire-service-defaults,transactional-emails}
|data:{efcore-patterns,database-performance}
|di-config:{microsoft-extensions-configuration,dependency-injection-patterns}
|testing:{testcontainers-integration-tests,playwright-blazor-testing,snapshot-testing,playwright-ci-caching}
|dotnet:{dotnet-project-structure,dotnet-local-tools,package-management,serialization}
|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}

Agents are AI personas with deep domain expertise. They're invoked automatically when Claude Code detects relevant tasks.

Production patterns for building distributed systems with Akka.NET.

Modern C# patterns for clean, performant code.

Database patterns that scale.

Cloud-native application orchestration.

Web application patterns.

Core .NET development practices.

Dependency injection and configuration patterns.

Comprehensive testing strategies.

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

dotnet-skills/
├── .claude-plugin/
│   └── plugin.json         # Plugin manifest
├── agents/                 # 5 specialized agents
│   ├── akka-net-specialist.md
│   ├── docfx-specialist.md
│   ├── dotnet-benchmark-designer.md
│   ├─�� dotnet-concurrency-specialist.md
│   └── dotnet-performance-analyst.md
└── skills/                 # 25 comprehensive skills
    ├── akka/               # Akka.NET (5 skills)
    ├── aspire/             # .NET Aspire (2 skills)
    ├── aspnetcore/         # ASP.NET Core (1 skill)
    ├── csharp/             # C# language (4 skills)
    ├── data/               # Data access (2 skills)
    ├── dotnet/             # .NET ecosystem (5 skills)
    ├── microsoft-extensions/  # DI & config (2 skills)
    └── testing/            # Testing (4 skills)

Want to add a skill or agent? PRs welcome!

1. Create skills/<category>/<skill-name>/SKILL.md (or agents/<name>/AGENT.md)
2. Add the path to .claude-plugin/plugin.json
3. Submit a PR

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

Created by Aaron Stannard (@Aaronontheweb)

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

MIT License - Copyright (c) 2025 Aaron Stannard

See LICENSE for full details.