Gerar Documentação OpenAPI a partir de Rotas de API
A documentação manual de APIs fica desatualizada quando as rotas mudam. Esta skill lê ficheiros de rotas e cria especificações OpenAPI ou Swagger para frameworks REST comuns.
Copie esta solicitação para o seu Agente. Ela inclui a página canônica do Skill e o manifesto.
Review the Skillstore skill "api-documentation-generator" from https://skillstore.io/skills/crazydubya-api-documentation-generator.md and its manifest at https://skillstore.io/api/skills/crazydubya-api-documentation-generator/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.Seu Agente ainda deve apresentar o plano e solicitar qualquer confirmação exigida pela política de segurança.
Use estes links quando um agente de IA, crawler ou script precisar de contexto limpo em vez de ler a página completa.
Usando "api-documentation-generator". Gerar documentação para as rotas de utilizadores do Express.
Resultado esperado:
Cria um ficheiro OpenAPI com endpoints de Users, parâmetros de caminho, detalhes do corpo do pedido, respostas de sucesso e respostas de erro.
Usando "api-documentation-generator". Atualizar documentação para um serviço FastAPI com modelos Pydantic.
Resultado esperado:
Atualiza descrições de endpoints e liga esquemas de pedido e resposta aos modelos detetados.
Usando "api-documentation-generator". Verificar controladores NestJS em relação ao ficheiro Swagger.
Resultado esperado:
Reporta métodos de controlador em falta, requisitos de autenticação e descrições de respostas antes de aplicar atualizações.
Reviewed all 24 static findings against SKILL.md, examples.md, and templates/openapi-3.0.yaml. The findings are false positives from Markdown examples, sample API documentation, and placeholder OpenAPI URLs; no prompt injection or malicious intent was found.
Compartilhe o relatório de avaliação versionado, o badge neutro, o cartão incorporável e as citações. A Skillstore apresenta evidências sem decidir se este Skill é seguro.
https://skillstore.io/skills/crazydubya-api-documentation-generator/audits/8?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report[](https://skillstore.io/skills/crazydubya-api-documentation-generator?utm_source=security_passport_badge)<a href="https://skillstore.io/skills/crazydubya-api-documentation-generator?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/crazydubya-api-documentation-generator/security.svg" alt="Skillstore security assessment" loading="lazy"></a><iframe src="https://skillstore.io/embed/skills/crazydubya-api-documentation-generator.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>CrazyDubya. (2026). api-documentation-generator security audit report (audit version 8) [Author version unspecified]. Skillstore. https://skillstore.io/skills/crazydubya-api-documentation-generator/audits/8@techreport{crazydubya-crazydubya-api-documentation-generator-2026,
author = {CrazyDubya},
title = {api-documentation-generator security audit report (audit version 8)},
institution = {Skillstore},
year = {2026},
number = {8},
url = {https://skillstore.io/skills/crazydubya-api-documentation-generator/audits/8},
note = {Author version unspecified}
}cff-version: 1.2.0
message: "If you use this Skill, cite its author and this versioned security audit report."
title: "api-documentation-generator security audit report (audit version 8)"
version: "unspecified"
type: report
authors:
- name: "CrazyDubya"
date-released: "2026-07-06"
url: "https://skillstore.io/skills/crazydubya-api-documentation-generator/audits/8"
identifiers:
- type: other
value: "skillstore:crazydubya-api-documentation-generator:audit:8"
description: "Skillstore immutable audit report identifier"
Cada autor permanece como um skill instalável separado. A variante recomendada é classificada pelas evidências do Skillstore.
Por que esta variante está em primeiro
crazydubya-api-documentation-generator
2026-09-09
sickn33-api-documentation-generator
2026-09-09
Gerar uma primeira especificação OpenAPI a partir de ficheiros de rotas existentes e convenções da framework.
Atualizar a documentação Swagger existente depois de endpoints, esquemas ou regras de autenticação mudarem.
Comparar endpoints documentados com ficheiros de rotas antes de uma release ou revisão de plataforma.
Use esta skill para analisar os ficheiros de rotas neste projeto e criar um ficheiro OpenAPI 3.0 na raiz do projeto.
Use esta skill para atualizar o ficheiro OpenAPI ou Swagger existente. Preserve descrições personalizadas e adicione endpoints em falta.
Use esta skill para inspecionar validadores, DTOs, modelos, testes e comentários de rotas. Adicione esquemas de pedido, esquemas de resposta e respostas de erro padrão.
Use esta skill para comparar rotas Express, FastAPI, Flask, NestJS ou Rails com a documentação atual da API. Reporte lacunas antes de escrever alterações.
Autor
CrazyDubyaLicença
MIT
Revisão da Skillstore
r1
Aviso de versão
O autor não declarou uma versão.
Referência
d11af420e07cd866fe39cfa937efef3223896c06
Atualidade da manutenção
18/07/2026
Uso
7 downloads · 257 visualizações
Estrutura de arquivos
Audite a acessibilidade web mais rapidamente
Defeitos de acessibilidade podem bloquear utilizadores e atrasar revisões de lançamento. Esta skill orienta Claude, Codex e Claude Code por verificações focadas em WCAG e correções práticas.
Otimize Dockerfiles para produção
Dockerfiles frequentemente ficam grandes, inseguros e lentos para reconstruir. Esta skill ajuda Claude, Codex ou Claude Code a revisar contêineres e propor otimizações práticas.
Aplicar o Estilo de Código do Projeto
As equipes perdem tempo quando o código segue diferentes hábitos locais. Esta skill revisa arquivos de acordo com as convenções do projeto e recomenda melhorias de estilo consistentes.
Criar Migrações de Base de Dados com Segurança
As migrações de base de dados podem quebrar aplicações quando os nomes dos ficheiros, a lógica de reversão ou as convenções do ORM estão errados. Esta skill ajuda Claude, Codex e Claude Code a criar migrações alinhadas com as convenções, com orientação de reversão.
Encontre Gargalos de Desempenho no Código
Aplicações lentas são difíceis de melhorar sem uma lista clara de gargalos. Esta skill revisa o código em busca de problemas de consultas, algoritmos, memória, frontend, rede e profiling.
Melhorar a Internacionalização de Aplicações
Aplicações multilingues muitas vezes deixam passar texto hardcoded e têm cobertura desigual de locales. Esta skill orienta a extração, a organização de chaves e as verificações de ficheiros de tradução para um trabalho de i18n mais seguro.
Criar Documentação de API Clara
por supercent-io
Equipes de API precisam de documentação precisa que explique endpoints, schemas, autenticação e erros. Esta skill transforma detalhes de API em referências e guias estruturados.
Document Go APIs with Swagger
por samber
Go API annotations often become incomplete, inconsistent, or difficult to generate. This skill guides accurate OpenAPI documentation, Swagger UI wiring, and schema generation with swaggo.
Gerar documentação de API
por zhangchenlai-dev
A documentação manual de API fica defasada em relação ao código e cria confusão para os desenvolvedores. Esta skill ajuda a produzir rascunhos OpenAPI, exemplos de requisições e orientações para coleções Postman a partir do código disponível ou dos detalhes dos endpoints.
Criar Documentação Técnica Clara
por shubhamsaboo
Equipes frequentemente têm dificuldade para transformar detalhes técnicos em documentação clara. Esta skill estrutura READMEs, referências de API, tutoriais e guias para Claude, Codex e Claude Code.
Documentar Arquitetura de Contêiner C4
por sickn33
A documentação de arquitetura de contêiner pode se tornar inconsistente quando componentes, APIs e unidades de implantação são acompanhados separadamente. Esta skill ajuda Claude, Codex e Claude Code a sintetizar componentes em documentos de contêiner C4, diagramas e resumos de API.
Criar documentação de arquitetura C4
por sickn33
A documentação de arquitetura frequentemente fica incompleta à medida que as bases de código crescem. Esta skill orienta Claude, Codex ou Claude Code por um fluxo de trabalho de documentação C4.