dotnet-backend

An agent skill for ASP.NET Core backend development, optimized for Layered Architecture with clear separation between API, Core (business logic), Persistence, and Migrations layers.

What It Does

Guides AI agents through .NET backend development following consistent conventions:

• Project structure — Layered Architecture with Api/, Core/, Persistence/, and Migrations/ projects
• Coding standards — C# style, naming conventions, error handling patterns, DI registration
• API design — RESTful controllers, FluentValidation, response envelope, Swagger/OpenAPI
• Database migrations — Bundled script that generates both EF Core migrations and matching SQL scripts in one step

Architecture Overview

Api            → Controllers, validators, middleware, jobs (entry point)
Core           → Services, DTOs, request/response models (business logic)
Persistence    → EF Core models, enums (data layer)
Migrations     → Migration files + SQL scripts (schema management)

Each layer has a single responsibility. Dependencies flow inward: Api → Core → Persistence.

Installation

npx skills install dotnet-backend.skill

Bundled Tools

scripts/generate-migration.sh

Generates an EF Core migration and its corresponding SQL script automatically:

./scripts/generate-migration.sh AddUserTable
./scripts/generate-migration.sh AddOrderIndex --context AppDbContext

Skill Contents

File	Purpose
SKILL.md	Core workflows and project structure
references/coding-guidelines.md	Style, naming, error handling, DI, testing
references/api-design.md	Controller patterns, Swagger, versioning
scripts/generate-migration.sh	Migration + SQL script generator