skills.rest
rudironsoni
rudironsoniCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/rudironsoni/dotnet-agent-harness --skill dotnet-openapi-rudironsoni
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
AGIBuildAGIBuild
10

dotnet-openapi

Generate OpenAPI 3.1 documentation for ASP.NET Core applications.

Community
Intermediate
teexiiiteexiii

swagger

Serve interactive Swagger UI and raw OpenAPI spec from a TypeScript-based definition.

Community
Intermediate
FaysilAlshareefFaysilAlshareef
4

gateway-security

Configure JWT authentication and policy-based authorization for ASP.NET Core gateway endpoints.

Community
Advanced
FaysilAlshareefFaysilAlshareef
4

openapi-scalar

Generate OpenAPI specifications and Scalar UI documentation for .NET 9+ applications.

Community
Intermediate