Why should I stop using Swashbuckle in .NET 10?

.NET 10 includes native OpenAPI support through Microsoft.AspNetCore.OpenApi, which is framework-maintained, more performant, and better integrated than Swashbuckle.

Do I need special attributes for response types in .NET 10?

By using TypedResults in your minimal APIs, .NET 10 automatically infers the correct status codes and response schemas for your OpenAPI document without extra attributes.

How does this skill help with security schemes?

It provides patterns for implementing IOpenApiDocumentTransformer to globally inject Bearer Token or OAuth2 security definitions into your documentation.

Can I generate the OpenAPI spec during the build process?

Yes, this skill provides the configuration for build-time generation using the Microsoft.Extensions.ApiDescription.Server package, allowing you to export the JSON/YAML file on every build.

.NET 10 OpenAPI Expert

Name: .NET 10 OpenAPI Expert
Author: codewithmukesh

bycodewithmukesh

•

189

•

API開発

Streamlines the implementation of built-in OpenAPI 3.1 documentation for .NET 10 applications using modern framework patterns.

This skill provides comprehensive guidance for implementing the official .NET 10 OpenAPI support, moving away from third-party libraries like Swashbuckle. It automates the setup of API documentation, configures security schemes via transformers, and ensures high-quality schema generation using TypedResults. Whether you are migrating from older versions or starting fresh, this skill helps you leverage native .NET features like XML comment extraction, build-time spec generation, and per-endpoint operation transformers to create robust, standards-compliant API specifications suitable for client generation with tools like Kiota.

主な機能

01Custom document, operation, and schema transformers for advanced metadata

02Native XML documentation comment extraction for endpoint descriptions

03Automatic schema generation using TypedResults and union return types

04Build-time OpenAPI document generation and YAML endpoint support

05189 GitHub stars

06Native .NET 10 OpenAPI 3.1 integration without Swashbuckle dependency

ユースケース

01Migrating legacy .NET APIs from Swashbuckle to the native .NET 10 OpenAPI implementation

02Generating high-quality API specifications to feed into Kiota or NSwag client generators

03Configuring complex JWT Bearer or OAuth2 security schemes within API documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codewithmukesh/dotnet-claude-kit openapi

For use in Claude.ai and ChatGPT

Download Skill