minimal-api

Design .NET 10 Minimal API endpoints with MapGroup and TypedResults.

1|Updated Apr 28, 2026
One-click install
npx skills add https://github.com/Trossitec/dotnet-claude-kit --skill minimal-api-trossitec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: minimal-api
Source: https://github.com/Trossitec/dotnet-claude-kit/tree/main/skills/minimal-api
Command: npx skills add https://github.com/Trossitec/dotnet-claude-kit --skill minimal-api-trossitec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you structure .NET 10 Minimal APIs so endpoints are discoverable, consistently organized, and documented correctly without scattering routing code or producing incomplete OpenAPI schemas.

Core Features & Use Cases

  • Group endpoints with MapGroup and IEndpointGroup: Keeps Program.cs stable while registering endpoints automatically across feature files.
  • Use TypedResults for OpenAPI correctness: Ensures compile-time response typing and accurate Swagger/OpenAPI output for union result types.
  • Apply modern minimal API conventions: Covers endpoint metadata (WithName, WithTags, WithSummary), parameter binding (route/query/header/DI/[AsParameters]), and cross-cutting concerns via endpoint filters plus built-in features like rate limiting and output caching.

Quick Start

Load this skill when creating an HTTP endpoint in your .NET 10 project, then implement your feature as an IEndpointGroup with TypedResults-based return types and endpoint metadata for OpenAPI.

Frequently Asked Questions about minimal-api

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

FAQPage Schema
How do I generate correct OpenAPI schemas for .NET 10 minimal APIs?

To generate correct OpenAPI schemas for .NET 10 minimal APIs, use TypedResults for compile-time response typing and accurate Swagger output. Apply endpoint metadata like WithName, WithTags, and WithSummary to ensure complete documentation.

What is the best way to organize minimal API endpoints without cluttering Program.cs?

The best way to organize minimal API endpoints is grouping them with MapGroup and IEndpointGroup. This keeps Program.cs stable while auto-discovering and registering endpoints across individual feature files via app.MapEndpoints().

How do I bind multiple parameters in a .NET 10 minimal API route handler?

Bind multiple parameters in a .NET 10 minimal API route handler by using records with the [AsParameters] attribute. This allows binding route, query, header, and dependency injection parameters together cleanly.

Can I apply rate limiting and output caching to specific minimal API endpoints?

Yes, you can apply rate limiting and output caching to specific minimal API endpoints. Combine these built-in features with endpoint filters to manage cross-cutting concerns for individual routes or endpoint groups.

When should I use TypedResults instead of Results in minimal API responses?

Use TypedResults instead of Results in minimal API responses when you need type-safe result unions for automatic schema generation. TypedResults ensures compile-time response typing and produces accurate OpenAPI documentation.