Agent skill · software engineering · github
aspnet-minimal-api-openapi
Create ASP.NET Minimal API endpoints with proper OpenAPI documentation
Why this skill is useful
Provides specific patterns and practices for creating ASP.NET Minimal APIs with OpenAPI documentation that the AI wouldn't reliably generate on its own.
What it needs
About 1k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.
What this skill does
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 Type Handling Use strongly-typed route parameters with explicit type binding Use Results<T1, T2> to represent multiple response types Return TypedResults instead of Results for strongly-typed responses Leverage C# 10+ features like nullable annotations and init-only properties OpenAPI Documentation Use the built-in OpenAPI document support added in .NET 9 Define operation summary and description Add operationIds using the WithName extension method Add descriptions to properties and parameters with [Description()] Set proper content types for requests and responses Use document transformers to add elements like servers, tags, and security schemes Use schema transformers to apply customizations to OpenAPI schemas
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills github/aspnet-minimal-api-openapi