dotnet-openapi

Generate and customize OpenAPI documentation for ASP.NET Core applications.

1|Updated Feb 22, 2026

Search Tags:#openapi #dotnet #swagger #api documentation #asp.net core #web api

Ready to run

npx skills add https://github.com/rudironsoni/dotnet-agent-harness --skill dotnet-openapi-rudironsoni

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: dotnet-openapi
Source: https://github.com/rudironsoni/dotnet-agent-harness/tree/main/.rulesync/skills/dotnet-openapi
Command: npx skills add https://github.com/rudironsoni/dotnet-agent-harness --skill dotnet-openapi-rudironsoni

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the process of generating and managing OpenAPI (Swagger) documentation for ASP.NET Core applications, ensuring your APIs are well-documented and discoverable.

Core Features & Use Cases

OpenAPI Generation: Integrates with Microsoft.AspNetCore.OpenApi (recommended for .NET 9+) and NSwag for generating OpenAPI specifications.
Migration Assistance: Provides guidance on migrating from Swashbuckle to the newer, actively maintained Microsoft.AspNetCore.OpenApi.
Customization: Supports document, operation, and schema transformers for fine-grained control over the generated OpenAPI output.
Use Case: You've built a new ASP.NET Core Web API and need to generate an OpenAPI specification so that API consumers can easily understand and interact with your endpoints.

Quick Start

Configure your ASP.NET Core application to generate OpenAPI documentation using the built-in Microsoft.AspNetCore.OpenApi package.

Frequently Asked Questions about dotnet-openapi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I generate OpenAPI documentation for an ASP.NET Core Web API?▼

You generate OpenAPI documentation by configuring your ASP.NET Core application with the built-in Microsoft.AspNetCore.OpenApi package, which is recommended for .NET 9+ and provides native specification generation.

Can I migrate from Swashbuckle to Microsoft.AspNetCore.OpenApi in .NET 9?▼

Yes, you can migrate from Swashbuckle to Microsoft.AspNetCore.OpenApi. The Skill provides specific migration guidance to transition your ASP.NET Core application to the newer, actively maintained package.

Does ASP.NET Core OpenAPI support custom schema and operation transformers?▼

Yes, ASP.NET Core OpenAPI supports custom transformers. The Skill offers document, operation, and schema transformers to provide fine-grained control over your generated OpenAPI output.

What is the best way to manage Swagger documentation in ASP.NET Core?▼

The best way to manage Swagger documentation in ASP.NET Core is using Microsoft.AspNetCore.OpenApi for .NET 9+ or NSwag, which allow you to generate and customize OpenAPI specifications with document, operation, and schema transformers.

Can I use NSwag with ASP.NET Core to generate OpenAPI specifications?▼

Yes, you can use NSwag with ASP.NET Core to generate OpenAPI specifications. It is fully supported alongside Microsoft.AspNetCore.OpenApi for managing and customizing your API documentation.