What problem does it solve?
It solves the problem of writing HTTP endpoints with scattered routing code by providing a consistent, scalable Minimal API pattern that preserves maintainability and produces accurate OpenAPI metadata.
Core Features & Use Cases
- Endpoint grouping with
MapGroup: Organize related routes into coherent feature files rather than spreading MapGet/MapPost calls across Program.cs.
- Auto-discovery via
IEndpointGroup: Keep Program.cs stable while endpoint features are added or changed in isolation.
- Type-safe responses with
TypedResults: Generate correct OpenAPI schemas while retaining compile-time safety for success/error response shapes.
- Production-ready concerns: Add endpoint filters, parameter binding (including
[AsParameters]), and capabilities such as OpenAPI, rate limiting, and output caching in a predictable way.
- Use case: When building an orders API, define an
OrderEndpoints group in a dedicated file and automatically register Create/List/Get endpoints with consistent response typing and documented metadata.
Quick Start
Load this skill, then design each feature’s endpoints as an IEndpointGroup in its own file and register everything with a single app.MapEndpoints() call so OpenAPI and routing stay correct as the API grows.