Generate OpenAPI documentation for .NET 10 APIs using transformers and TypedResults.
npx skills add https://github.com/Trossitec/dotnet-claude-kit --skill openapi-trossitec
Please help me install this Agent Skill. Skill: openapi Source: https://github.com/Trossitec/dotnet-claude-kit/tree/main/skills/openapi Command: npx skills add https://github.com/Trossitec/dotnet-claude-kit --skill openapi-trossitec
It solves the problem of producing correct, client-friendly OpenAPI documentation for .NET 10 APIs, especially when developers rely on outdated Swagger tooling or omit metadata needed for reliable schemas and operation IDs.
Enable built-in OpenAPI by adding AddOpenApi in your builder and calling MapOpenApi in development so your app serves the generated OpenAPI document.
High-intent search queries and answers about installing and using this skill.
To generate OpenAPI documentation for .NET 10 without Swashbuckle, use the built-in Microsoft.AspNetCore.OpenApi library by calling AddOpenApi in your builder and MapOpenApi in your development pipeline.
OpenAPI response schemas are often incorrect when using untyped Results. You must use TypedResults in your minimal APIs so the schema is inferred correctly from strongly typed union return types like ValidationProblem.
You add security schemes to OpenAPI documents in .NET 10 by applying document, operation, and schema transformers during the AddOpenApi setup to customize global structure and security definitions.
Yes, you can generate OpenAPI specs at build time in .NET 10. The built-in Microsoft.AspNetCore.OpenApi package supports multi-document output and build-time spec generation without relying on runtime hacks.
Reliable client generation from .NET OpenAPI requires endpoint metadata such as WithName, WithSummary, WithDescription, and tags to ensure high-quality operation IDs and consistent documentation structure.
While Swashbuckle may technically run, using it for .NET 10 minimal APIs is considered a deprecated and ineffective pattern compared to the built-in Microsoft.AspNetCore.OpenApi package designed for this purpose.
ResgridStandardize .NET 10 Minimal API endpoints with MapGroup and TypedResults.
gil00pitaGenerate OpenAPI 3.1 specifications and TypeScript types from API definitions.
ResgridGenerate OpenAPI 3.1 documentation for .NET 10 endpoints using built-in Microsoft OpenAPI and transformers.
rudironsoniGenerate and customize OpenAPI documentation for ASP.NET Core applications.
