dotnet-skills

.NET Skills for Claude Code

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.

Installation

Add the marketplace (one-time):

/plugin marketplace add Aaronontheweb/dotnet-skills

Install the plugin:

/plugin install dotnet-skills

To update:

/plugin marketplace update

---

OpenCode Installation

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.

Manual Installation

1.Clone the repository:

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

2.Install 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

3.Install agents:

# 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

4. Restart OpenCode to load the new skills and agents.

AI-Assisted Installation

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.

---

Suggested AGENTS.md / CLAUDE.md Snippets

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