Zum Inhalt springen
Kitbay
Skill

openapi-spec-generation

MITAktualisiert am 10. Nov. 202649.466GitHub-Sterne

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

Was der Skill vermittelt

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.

Funktionen

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