aspnet-minimal-api-openapi

SKILL.md

ASP.NET Minimal API with OpenAPI

Your goal is to help me create well-structured ASP.NET Minimal API endpoints with correct types and comprehensive OpenAPI/Swagger documentation.

API Organization

Group related endpoints using MapGroup() extension

Use endpoint filters for cross-cutting concerns

Structure larger APIs with separate endpoint classes

Consider using a feature-based folder structure for complex APIs

Request and Response Types

Define explicit request and response DTOs/models

Create clear model classes with proper validation attributes

Use record types for immutable request/response objects

Use meaningful property names that align with API design standards

Apply [Required] and other validation attributes to enforce constraints

Use the ProblemDetailsService and StatusCodePages to get standard error responses