Openapi skill

A API em .NET 10 sai com a documentação OpenAPI completa: rotas descritas, respostas certas, token Bearer indicado e arquivo pronto pra gerar cliente.

por codewithmukesh

instalações: 2.800
estrelas no GitHub: 789
No skills.sh desde: março de 2026
Licença: MIT

Atualizada no GitHub em 7 de agosto de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

codewithmukesh
openapi
A API em .NET 10 sai com a documentação OpenAPI completa: rotas descritas, respostas certas, token Bearer indicado e arquivo pronto pra gerar cliente.Auditada2.800 instalações, grátis

O que ela faz

Guia o Claude a montar a documentação OpenAPI de uma API em .NET 10 com o pacote que já vem no framework, o Microsoft.AspNetCore.OpenApi, em vez do Swashbuckle, que saiu dos modelos da Microsoft no .NET 9. A documentação fica em /openapi/v1.json e, se quiser, também em YAML.

Pede nome, resumo e etiqueta em cada rota e usa TypedResults, que descrevem sozinhos as respostas possíveis. Com transformadores, põe título e versão no documento, marca rota como obsoleta e, se a API já usa autenticação Bearer (JWT), registra na documentação que todas as rotas pedem esse token.

Também liga os comentários XML do código à documentação, separa APIs públicas e internas em documentos diferentes, gera o arquivo durante o build e indica o Scalar pra tela de consulta e o Kiota ou o NSwag pra gerar o cliente da API.

Nas palavras de quem fez

Built-in OpenAPI support for .NET 10 applications. Covers document generation, transformers, TypedResults metadata, security schemes, XML comments, build-time…

codewithmukesh, no SKILL.md

Quando usar

Começar uma API nova em .NET 10 já com a documentação montada
Tirar o Swashbuckle de um projeto e passar pro OpenAPI nativo
Mostrar na documentação que a API pede login por token
Gerar o arquivo OpenAPI pra outro sistema criar o cliente da API
Separar as rotas públicas das internas em documentos diferentes

Depois de instalar, é só pedir assim

Configura a documentação OpenAPI dessa API em .NET 10 e tira o Swashbuckle
Coloca o login por token Bearer na documentação de todas as rotas
Revisa as rotas e troca Results por TypedResults pra documentação mostrar as respostas certas

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

Gen Agent Trust HubPassou
SocketPassou
SnykPassou

Perguntas

Como instalar a Openapi no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Openapi, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que precisa pra funcionar?

Um projeto ASP.NET Core em .NET 10. A skill não pede chave de API nem conta paga: o pacote de OpenAPI é da própria Microsoft. Pra gerar o arquivo no build, entra também o pacote Microsoft.Extensions.ApiDescription.Server.

Serve pra API em Node, Python ou PHP?

Não. Todo o conteúdo é de .NET 10 e C#. Em outra linguagem, as instruções não se aplicam.

Roda no Codex e no Antigravity?

Sim. É um arquivo de instruções com exemplos de código, sem script próprio, então qualquer agente que lê skills consegue seguir.

Levar essa skill

1x openapiR$ 0,00

TotalR$ 0,00

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/codewithmukesh/dotnet-claude-kit

Aprenda a usar

O que é o Claude Code (Claude CLI) e como começar
O que é o Claude Code (Claude CLI), pra que serve pra quem não programa, o que ele pede pra rodar e como se compara ao Codex, ao Antigravity e ao Cursor.