aspnet-minimal-api-openapi
Installation
Summary
ASP.NET Minimal API endpoints with automatic OpenAPI/Swagger documentation and strong typing.
- Organize endpoints using
MapGroup(), endpoint filters, and feature-based folder structures for scalability - Define explicit request/response DTOs with validation attributes; use record types and
TypedResultsfor type safety - Leverage .NET 9 built-in OpenAPI support with operation summaries, descriptions, operationIds, and property-level documentation via
[Description()] - Apply document and schema transformers to customize OpenAPI output with servers, tags, security schemes, and standardized error responses
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