Claude Agent Skill · by Github

Aspnet Minimal Api Openapi

The aspnet-minimal-api-openapi skill assists .NET developers in building ASP.NET Minimal API endpoints with comprehensive OpenAPI/Swagger documentation by provi

Install
Terminal · npx
$npx skills add https://github.com/github/awesome-copilot --skill aspnet-minimal-api-openapi
Works with Paperclip

How Aspnet Minimal Api Openapi fits into a Paperclip company.

Aspnet Minimal Api Openapi drops into any Paperclip agent that handles this kind of work. Assign it to a specialist inside a pre-configured PaperclipOrg company and the skill becomes available on every heartbeat — no prompt engineering, no tool wiring.

S
SaaS FactoryPaired

Pre-configured AI company — 18 agents, 18 skills, one-time purchase.

$27$59
Explore pack
Source file
SKILL.md41 lines
Expand
---name: aspnet-minimal-api-openapidescription: 'Create ASP.NET Minimal API endpoints with proper OpenAPI documentation'--- # ASP.NET Minimal API with OpenAPI Your goal is to help me create well-structured ASP.NET Minimal API endpoints with correct types and comprehensive OpenAPI/Swagger documentation. ## API Organization - Group related endpoints using `MapGroup()` extension- Use endpoint filters for cross-cutting concerns- Structure larger APIs with separate endpoint classes- Consider using a feature-based folder structure for complex APIs ## Request and Response Types - Define explicit request and response DTOs/models- Create clear model classes with proper validation attributes- Use record types for immutable request/response objects- Use meaningful property names that align with API design standards- Apply `[Required]` and other validation attributes to enforce constraints- Use the ProblemDetailsService and StatusCodePages to get standard error responses ## Type Handling - Use strongly-typed route parameters with explicit type binding- Use `Results<T1, T2>` to represent multiple response types- Return `TypedResults` instead of `Results` for strongly-typed responses- Leverage C# 10+ features like nullable annotations and init-only properties ## OpenAPI Documentation - Use the built-in OpenAPI document support added in .NET 9- Define operation summary and description- Add operationIds using the `WithName` extension method- Add descriptions to properties and parameters with `[Description()]`- Set proper content types for requests and responses- Use document transformers to add elements like servers, tags, and security schemes- Use schema transformers to apply customizations to OpenAPI schemas