dotnet-clean-architecture-skills

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

npx dotnet-clean-arch

Interactive installer: pick your agent (Claude Code, Cursor, GitHub Copilot), cherry-pick the skills you want, done. No clone required. See dotnet-clean-arch on npm for full CLI docs.

Prefer to clone or symlink directly? See Installation below for alternatives.

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

Why the dotnet- prefix? Every skill in this collection is namespaced with dotnet- so the pack is identifiable in mixed-pack environments and addressable in conversation. Instead of remembering an exact skill name, you can say "use the dotnet- skill for CQRS commands" and the agent will narrow down the candidates. The prefix also prevents collisions with other skill packs that might use generic names like repository-pattern or unit-testing. Skill folders follow the pattern <NN>-dotnet-<topic>/, where the numeric prefix establishes a stable learning order and the dotnet-<topic> portion matches the name field in each skill's frontmatter.

Core Architecture Skills

#	Skill	Description	Key Templates
1	dotnet-clean-architecture	Project scaffolding	Solution structure, layer setup, DI configuration
2	dotnet-cqrs-command-generator	Write operations	Commands, Handlers, Validators
3	dotnet-cqrs-query-generator	Read operations	Queries, Dapper SQL, Response DTOs
4	dotnet-domain-entity-generator	Domain modeling	Entities, Value Objects, Factory methods
5	dotnet-repository-pattern	Data access abstraction	Repository interfaces, EF Core implementations
6	dotnet-ef-core-configuration	Database mapping	Fluent API, Relationships, Indexes
7.1	dotnet-legacy-api-controllers	REST API controllers	Controllers, Authorization, Versioning
7.2	dotnet-minimal-api-endpoints	Minimal API endpoints	MapGet/MapPost, Filters, Versioning
8	dotnet-result-pattern	Error handling	Result, Result, Error types
9	dotnet-domain-events-generator	Event-driven design	Domain Events, Handlers, Outbox pattern
10	dotnet-pipeline-behaviors	Cross-cutting concerns	Logging, Validation, Transaction behaviors

Validation Skills

#	Skill	Description	Key Templates
11	dotnet-fluent-validation	Input validation	AbstractValidator, Custom validators, Async validation

Security Skills

#	Skill	Description	Key Templates
12	dotnet-jwt-authentication	JWT Bearer auth	JwtService, Token validation, Refresh tokens
13	dotnet-permission-authorization	Permission-based access	HasPermission attribute, Policy provider

Infrastructure Skills

#	Skill	Description	Key Templates
14	dotnet-outbox-pattern	Reliable messaging	OutboxMessage, Processor job, Idempotency
15	dotnet-quartz-background-jobs	Scheduled jobs	IJob, Cron scheduling, Job configuration
16.1	dotnet-email-service-sendgrid	Email integration	IEmailService, SendGrid, Templates
16.2	dotnet-email-service-aws-ses	Email integration	IEmailService, AWS SES, Local Templates
17	dotnet-health-checks	Dependency monitoring	PostgreSQL, HTTP, Custom checks
18	dotnet-audit-trail	Change tracking	IAuditable, EF interceptor, Soft delete

Data Access Skills