Generate OpenAPI 3.1 documentation for .NET 10 endpoints using built-in Microsoft OpenAPI and transformers.
npx skills add https://github.com/Resgrid/Core --skill openapi-resgrid
Please help me install this Agent Skill. Skill: openapi Source: https://github.com/Resgrid/Core/tree/main/.opencode/skills/openapi Command: npx skills add https://github.com/Resgrid/Core --skill openapi-resgrid
Resiliently generate accurate OpenAPI 3.1 documentation for .NET 10 APIs using the built-in OpenAPI support, avoiding schema gaps that often occur with generic result types or missing endpoint metadata.
Microsoft.AspNetCore.OpenApi with AddOpenApi() and MapOpenApi() instead of Swashbuckle for new projects.TypedResults so response schemas are inferred correctly from endpoint return types (especially for union results)..WithName(), .WithSummary(), and tags to improve the spec and downstream client generation.Load this skill when you are setting up .NET 10 API documentation so you can generate OpenAPI 3.1 output with correct schemas, security documentation, and endpoint metadata.
High-intent search queries and answers about installing and using this skill.
Generate OpenAPI documentation in .NET 10 without Swashbuckle by using the built-in `AddOpenApi()` and `MapOpenApi()` methods from `Microsoft.AspNetCore.OpenApi` to produce OpenAPI 3.1 specs natively.
OpenAPI response schemas are incomplete for generic endpoint return types because the generator cannot infer them accurately. Using `TypedResults` for endpoint return types ensures response schemas are correctly inferred for union results.
Add security schemes to your OpenAPI 3.1 document in .NET 10 by applying document transformers, schema transformers, or per-endpoint operation transformers to customize security schemes and endpoint behavior.
Yes, built-in .NET 10 OpenAPI generation supports multiple documents. You can produce multiple OpenAPI documents and enrich them using generated XML documentation comments for client-friendly spec output.
The best way to enrich endpoint metadata for OpenAPI client generation in .NET 10 is using first-class metadata methods like `.WithName()`, `.WithSummary()`, and adding tags to improve the spec and downstream client generation.
Use document transformers for global OpenAPI customizations like security schemes and global responses, and use per-endpoint operation transformers for specific endpoint behavior, deprecations, and schema formatting adjustments.
codewithmukeshConfigure type-safe .NET 10 minimal API endpoints with TypedResults and endpoint filters.
Ankurjain1121Convert API contracts into OpenAPI 3.1 specifications and SDK templates.
FaysilAlshareefEnrich OpenAPI specifications with summaries, descriptions, and examples.
rudironsoniGenerate and customize OpenAPI documentation for ASP.NET Core applications.