Crie endpoints de ASP.NET Minimal API bem estruturados com documentação OpenAPI/Swagger abrangente e respostas fortemente tipadas.
- Estrelas no GitHub
- 41.038
- Arquivos
- 1
- Último commit
- 11 de nov. de 2026
- Licença
- MIT
- Ferramentas permitidas
- —
O que a skill aspnet-minimal-api-openapi faz?
Crie endpoints de ASP.NET Minimal API bem estruturados com documentação OpenAPI/Swagger abrangente e respostas fortemente tipadas.
Resumo gerado a partir do SKILL.md da skill.
Sobre a skill aspnet-minimal-api-openapi
A principal função desta SKILL é construir endpoints de ASP.NET Minimal API bem estruturados com documentação OpenAPI abrangente. Desenvolvedores a utilizam para gerar código que segue os padrões modernos de C#, garantindo que cada endpoint inclua documentação Swagger clara e respostas fortemente tipadas. É especialmente útil quando um agente precisa realizar o scaffold de novas rotas de API, organizar grupos de endpoints complexos usando MapGroup ou implementar tratamento de erros padronizado através de ProblemDetailsService e StatusCodePages.
A SKILL foca em type safety ao utilizar TypedResults e Results<T1, T2> em vez de resultados genéricos. Ela orienta a criação de objetos de request e response imutáveis usando record types e reforça a integridade dos dados por meio de atributos de validação como [Required]. Para documentação, utiliza o suporte nativo ao OpenAPI encontrado no .NET 9, aplicando document e schema transformers para gerenciar servers, tags e security schemes. Essa abordagem garante que a API resultante seja fácil de consumir e estritamente tipada.
O que um agente pode fazer com ela
- 1Organizar estruturas de API extensasInstrua o agente a agrupar rotas relacionadas para manter uma arquitetura de projeto limpa.
- 2Configurar customizações de esquema OpenAPIPeça ao agente para aplicar transformações específicas ao documento OpenAPI, como security schemes ou tags.
Escrito a partir do SKILL.md da skill. Cada caso de uso é verificado com uma citação dele.
Como instalar a skill aspnet-minimal-api-openapi
Cada comando copia a pasta da skill para o diretório de skills do cliente. Reinicie o cliente ou inicie uma nova sessão para carregá-la.Instalar a skill aspnet-minimal-api-openapi no Claude Code
~/.claude/skills/aspnet-minimal-api-openapi/SKILL.md
$ npx degit github/awesome-copilot/skills/aspnet-minimal-api-openapi ~/.claude/skills/aspnet-minimal-api-openapiInstalar a skill aspnet-minimal-api-openapi no Claude Code (project)
.claude/skills/aspnet-minimal-api-openapi/SKILL.md
$ npx degit github/awesome-copilot/skills/aspnet-minimal-api-openapi .claude/skills/aspnet-minimal-api-openapiInstalar a skill aspnet-minimal-api-openapi no Codex
~/.agents/skills/aspnet-minimal-api-openapi/SKILL.md
$ npx degit github/awesome-copilot/skills/aspnet-minimal-api-openapi ~/.agents/skills/aspnet-minimal-api-openapiInstalar a skill aspnet-minimal-api-openapi no Gemini CLI
~/.gemini/skills/aspnet-minimal-api-openapi/SKILL.md
$ npx degit github/awesome-copilot/skills/aspnet-minimal-api-openapi ~/.gemini/skills/aspnet-minimal-api-openapiInstalar a skill aspnet-minimal-api-openapi no Claude.ai
npx degit github/awesome-copilot/skills/aspnet-minimal-api-openapi aspnet-minimal-api-openapi && zip -r aspnet-minimal-api-openapi.zip aspnet-minimal-api-openapi # claude.ai → Customize → Skills → + → Create skill → Upload a skill → aspnet-minimal-api-openapi.zip
Verificações automatizadas
Executado em 15 de nov. de 2026Relatório completo →Passou nas nossas verificações automáticas. Não é uma auditoria de segurança: leia os scripts antes de deixar um agente executá-los. Como as verificações funcionam · O que corrigir para ganhar mais pontos
- Repositório de origem vinculado e acessívelgithub/awesome-copilot/skills/aspnet-minimal-api-openapi is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/aspnet-mi ↗Passou
- Licença de código aberto (OSI)MITspdx.org/licenses/MIT.html ↗Passou
- Commit ou release no último anoLast commit 2026-11-11github.com/github/awesome-copilot/commits ↗Passou
- Sem baixar e executar nem roubo de credenciais nos scriptsNo scripts in the skill folderPassou
- Sem instruções ocultas no SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/aspnet-mi ↗Passou
- Ferramentas pré-aprovadas são restritasNo pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/aspnet-mi ↗Passou
- O SKILL.md segue o formato Agent Skillsthe description does not say when to use the skillgithub.com/github/awesome-copilot/blob/HEAD/skills/aspnet-mi ↗Problema encontrado
SKILL.md
Ver no GitHubASP.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
TypedResultsinstead ofResultsfor 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
WithNameextension 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
Arquivos desta skill
1Perguntas sobre a skill aspnet-minimal-api-openapi
Como instalo a skill aspnet-minimal-api-openapi no Claude Code?
Execute npx degit github/awesome-copilot/skills/aspnet-minimal-api-openapi ~/.claude/skills/aspnet-minimal-api-openapi. O Claude Code carrega skills de ~/.claude/skills (todos os projetos) ou .claude/skills (um projeto) e usa uma skill quando a descrição dela corresponde à tarefa.
Quais clientes podem usar a skill aspnet-minimal-api-openapi?
Qualquer cliente que leia o formato Agent Skills: Claude Code, Codex, Gemini CLI e claude.ai (envie como ZIP). Scripts da skill são executados apenas onde o cliente permite execução de código.
Como posso personalizar esquemas e documentos OpenAPI?
Você pode usar document transformers para adicionar elementos como servers e security schemes, e usar schema transformers para aplicar customizações aos esquemas OpenAPI.