What problem does it solve?
This Skill helps you produce accurate OpenAPI documentation for .NET 10 APIs using the built-in OpenAPI support, avoiding extra tooling and ensuring the spec reflects real endpoint behavior.
Core Features & Use Cases
- Built-in .NET 10 OpenAPI: Use Microsoft.AspNetCore.OpenApi to generate OpenAPI documents without Swashbuckle.
- TypedResults-driven schemas: Rely on TypedResults union return types so response schemas match your actual controller/endpoint contracts.
- Transformers for customization: Add document, operation, and schema transformers for security schemes, metadata, and schema tweaks.
- Production-ready endpoint metadata: Apply .WithName(), .WithSummary(), and .WithTags() so client generation and operationIds stay clean.
- Multiple documents & grouping: Create versioned or segmented specs (e.g., public vs internal) with WithGroupName while sharing common endpoints.
- XML comments integration: Enable GenerateDocumentationFile and let .NET extract summaries/params/responses into the spec.
Quick Start
Tell the AI: "Set up built-in OpenAPI for my .NET 10 minimal API, enable /openapi/v1.json in development, and add a Bearer security scheme to the OpenAPI documents using a document transformer."