How does this skill improve API documentation?

It implements native OpenAPI transformers, operation IDs, and property descriptions to generate comprehensive Swagger UI and documentation automatically.

Does it handle error responses?

Yes, it guides you through using ProblemDetailsService and StatusCodePages to ensure your API returns standardized, RFC-compliant error responses.

Why does it prefer TypedResults over standard Results?

TypedResults provide better compile-time type safety and allow the OpenAPI generator to automatically infer response types without extra attributes.

Can I use this for complex, large-scale APIs?

Absolutely. It promotes using MapGroup and feature-based folder structures to keep large API surfaces organized and maintainable.

Does this skill support the latest .NET versions?

Yes, it is specifically designed to leverage the built-in OpenAPI support and features introduced in .NET 9 and C# 12+.

ASP.NET Minimal API & OpenAPI

Name: ASP.NET Minimal API & OpenAPI
Author: rodolfolermacontreras

byrodolfolermacontreras

•

API Development

Generates production-grade ASP.NET Minimal API endpoints with comprehensive OpenAPI documentation and strongly-typed responses.

This skill streamlines the development of modern ASP.NET Core services by enforcing best practices for Minimal APIs. It provides expert guidance on organizing endpoints using MapGroup, implementing feature-based architectures, and utilizing the native OpenAPI support introduced in .NET 9. By leveraging strongly-typed results, record types for DTOs, and advanced schema transformers, this skill helps developers build robust, self-documenting APIs that are easy to maintain and integrate.

Key Features

011 GitHub stars

02Strongly-typed response handling using TypedResults and polymorphic Results types

03Standardized API organization using MapGroup and feature-based folder structures

04Native .NET 9 OpenAPI integration with operation summaries and custom document transformers

05Schema customization using Description attributes and OpenAPI schema transformers

06Automated request validation using data annotations and ProblemDetailsService integration

Use Cases

01Refactoring existing Minimal APIs to use modern .NET 9 OpenAPI and TypedResults patterns

02Designing complex API architectures that require clean separation of concerns and endpoint grouping

03Scaffolding a new RESTful microservice with standardized documentation and error handling

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rodolfolermacontreras/microsoft-ai-learning aspnet-minimal-api-openapi

For use in Claude.ai and ChatGPT

Key Features

011 GitHub stars

02Strongly-typed response handling using TypedResults and polymorphic Results types

03Standardized API organization using MapGroup and feature-based folder structures

04Native .NET 9 OpenAPI integration with operation summaries and custom document transformers

05Schema customization using Description attributes and OpenAPI schema transformers

06Automated request validation using data annotations and ProblemDetailsService integration

Use Cases

01Refactoring existing Minimal APIs to use modern .NET 9 OpenAPI and TypedResults patterns

02Designing complex API architectures that require clean separation of concerns and endpoint grouping

03Scaffolding a new RESTful microservice with standardized documentation and error handling

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rodolfolermacontreras/microsoft-ai-learning aspnet-minimal-api-openapi

For use in Claude.ai and ChatGPT