Pular para o conteúdo
Kitbay
Skill

openapi-spec-generation

MITAtualizado em 10 de nov. de 202649.466Estrelas no GitHub

A short skill from the agentic-awesome-skills collection for writing and maintaining OpenAPI 3.1 specifications for REST APIs.

O que a skill ensina

A short skill from the agentic-awesome-skills collection for writing and maintaining OpenAPI 3.1 specifications for REST APIs. It names the situations it covers: documenting an API from scratch, generating a spec from existing code, designing the contract first, checking an implementation against the spec, generating client SDKs and setting up a documentation portal. The SKILL.md itself only gives general steps, asking the agent to clarify goals and inputs, apply good practice and verify the result, and moves the detailed patterns and examples into an implementation playbook file. It notes that its output does not replace testing or expert review.

O que faz

  • Write an OpenAPI 3.1 specification
  • Generate a spec from existing code
  • Check an implementation against a spec