.NET Clean Architecture Skills

27 AI-ready skills that teach your coding assistant how to generate production-grade .NET code — Clean Architecture, CQRS, DDD — without explaining the patterns every time.

Works with: Claude Code | GitHub Copilot | Cursor

Before (plain prompt)

"Create a Product entity with name, price, and category"

Your assistant generates a basic class with public setters, no validation, no events, inconsistent patterns.

After (with skills installed)

"Using skill 04-domain-entity-generator, create a Product aggregate root with Name (required, max 200), Price (positive decimal), and a CategoryId foreign key"

Your assistant generates a proper DDD entity with private setters, a Create() factory method, domain events, typed errors, and a repository interface — matching the patterns already in your codebase.

Get started in 30 seconds

# Clone into your project (Claude Code + Copilot)
git clone https://github.com/ronnydelgado/dotnet-clean-architecture-skills.git

# Or copy all skills globally (Claude Code)
cp -r skills/* ~/.claude/skills/

Then follow Recipe 0: Scaffold a New Project or jump to Recipe 1: Add a CRUD Feature if you already have a solution.

Skills Index

Core Architecture Skills

Validation Skills

Security Skills

Infrastructure Skills

Data Access Skills

Testing Skills

Cross-Cutting Skills

Database Skills

Recipes — Where to Start

Skills are building blocks. Recipes show you which skills to combine and in what order for common tasks.

New project? Start with Recipe 0, then Recipe 1. Everything else is optional and independent.

See the full Recipes guide for the suggested order and dependency tree.

Architecture Overview

┌─────────────────────────────────────────────────────────────────┐
│                          API Layer                               │
│  • Controllers (api-controller-generator)                        │
│  • Request/Response DTOs                                         │
│  • Middleware                                                    │
│  • Authentication (jwt-authentication)                           │
│  • Authorization (permission-authorization)                      │
├─────────────────────────────────────────────────────────────────┤
│                      Application Layer                           │
│  • Commands (cqrs-command-generator)                             │
│  • Queries (cqrs-query-generator)                                │
│  • Validators (fluent-validation)                                │
│  • Pipeline Behaviors (pipeline-behaviors)                       │
│  • Event Handlers (domain-events-generator)                      │
├─────────────────────────────────────────────────────────────────┤
│                    Infrastructure Layer                          │
│  • Repositories (repository-pattern)                             │
│  • EF Core Configurations (ef-core-configuration)                │
│  • Dapper Queries (dapper-query-builder)                         │
│  • Outbox Pattern (outbox-pattern)                               │
│  • Background Jobs (quartz-background-jobs)                      │
│  • Email Service (email-service)                                 │
│  • Audit Trail (audit-trail)                                     │
│  • Health Checks (health-checks)                                 │
├─────────────────────────────────────────────────────────────────┤
│                       Domain Layer                               │
│  • Entities (domain-entity-generator)                            │
│  • Value Objects (domain-entity-generator)                       │
│  • Domain Events (domain-events-generator)                       │
│  • Result Pattern (result-pattern)                               │
│  • Specifications (specification-pattern)                        │
└─────────────────────────────────────────────────────────────────┘

Technology Stack

Installation

Option 1: Clone the repo (works with both Claude Code and GitHub Copilot)

git clone https://github.com/ronnydelgado/dotnet-clean-architecture-skills.git

The repo structure works out of the box for both tools:

• GitHub Copilot reads skills from skills/ at the repo root.
• Claude Code reads skills from .claude/skills/, which is a symlink to skills/.

Windows note: Git symlinks require either Developer Mode enabled or running Git as administrator. If symlinks don't resolve, run git config core.symlinks true and re-clone.

Option 2: Copy individual skills into your project

Pick the skills you need and copy them into the appropriate location for your tool:

Claude Code:

# Copy a single skill
cp -r skills/01-dotnet-clean-architecture your-project/.claude/skills/

# Or copy all skills
cp -r skills/* your-project/.claude/skills/

GitHub Copilot:

# Copy a single skill
cp -r skills/01-dotnet-clean-architecture your-project/skills/

# Or copy all skills
cp -r skills/* your-project/skills/

Option 3: Install globally for Claude Code

Make skills available across all your projects:

cp -r skills/* ~/.claude/skills/

Using the skills

Once installed, ask Claude to apply the patterns to your specific use case. Each skill contains:

• Overview and purpose
• Quick reference table
• Complete code templates
• Usage examples
• Best practices
• Anti-patterns to avoid
• Related skills

Credits

Skills 25.1 (postgresql-best-practices) and 26 (options-pattern) were inspired by johnpuksta/clean-architecture-agents, a fork that extends this collection with a multi-agent orchestration system.

Have suggestions or want to contribute? Open an issue or PR on GitHub. Let's make .NET Clean Architecture accessible to everyone.