aspnet-minimal-api-openapi

Design ASP.NET Minimal API endpoints with typed DTOs and OpenAPI metadata.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/vladimir-shirmanov/tenax --skill aspnet-minimal-api-openapi-vladimir-shirmanov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aspnet-minimal-api-openapi
Source: https://github.com/vladimir-shirmanov/tenax/tree/main/.github/skills/aspnet-minimal-api-openapi
Command: npx skills add https://github.com/vladimir-shirmanov/tenax --skill aspnet-minimal-api-openapi-vladimir-shirmanov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers design and implement ASP.NET Minimal API endpoints with robust OpenAPI documentation, ensuring clear contracts and consistent metadata across services.

Core Features & Use Cases

  • Route-group support using MapGroup() to organize endpoints by feature.
  • Strongly typed request and response DTOs with validation attributes.
  • OpenAPI metadata enrichment (WithName, summaries, tags, status codes) and support for transformers.
  • Use Case: When adding new endpoints in Tenax.Web, migrate from controllers to minimal APIs with typed contracts and comprehensive docs.

Quick Start

Define a new route group with MapGroup(), create explicit typed DTOs for requests and responses, and enable OpenAPI metadata for automatic documentation.

Frequently Asked Questions about aspnet-minimal-api-openapi

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

FAQPage Schema
How do I generate OpenAPI documentation for ASP.NET Minimal APIs?

To generate OpenAPI documentation for ASP.NET Minimal APIs, define typed request and response DTOs and apply endpoint metadata enrichment like WithName, summaries, tags, and status codes to produce automatic, strongly typed contracts.

What is the best way to organize Minimal API endpoints by feature?

The best way to organize Minimal API endpoints by feature is using MapGroup() to create route groups. This structures endpoints logically while maintaining strongly typed bindings and comprehensive OpenAPI metadata across services.

How do I migrate from controllers to minimal APIs with typed contracts?

To migrate from controllers to minimal APIs with typed contracts, define explicit DTOs with validation attributes for requests and responses, use MapGroup-based routing, and apply endpoint filters to preserve and enrich your API behavior.

Can I use typed DTOs with validation attributes in ASP.NET Minimal APIs?

Yes, you can use typed DTOs with validation attributes in ASP.NET Minimal APIs. This Skill automates strongly typed request and response bindings, ensuring clear contracts and consistent metadata generation for your endpoints.

How do I add OpenAPI summaries and status codes to Minimal API endpoints?

To add OpenAPI summaries and status codes to Minimal API endpoints, apply OpenAPI metadata enrichment methods directly to your endpoint definitions. This Skill supports metadata generation and transformers to document status codes and descriptions accurately.

Does this approach support endpoint filters in ASP.NET Minimal APIs?

Yes, this approach supports endpoint filters in ASP.NET Minimal APIs. You can apply endpoint filters alongside MapGroup-based routing and typed DTO contracts to handle cross-cutting concerns while generating comprehensive OpenAPI documentation.