本文へスキップ
Kitbay
スキル

openapi-spec-generation

MIT2026年11月9日 更新42,406GitHubスター

A skill from the documentation-generation plugin in wshobson's agents collection for writing, maintaining and checking OpenAPI 3.1 specifications for REST APIs.

メインのスキルopenapi-spec-generationとは内容が異なります(本文の13%が一致)。手を加えたコピーか、古いバージョンの可能性があります。

スキルの内容

A skill from the documentation-generation plugin in wshobson's agents collection for writing, maintaining and checking OpenAPI 3.1 specifications for REST APIs. It outlines the main parts of a specification, from info and servers to paths, shared schemas and security schemes, and compares three ways of working: writing the specification before the code, generating it from existing code, or annotating code and generating from the annotations. A short list of practices asks for reusable components, realistic examples, every error code documented, versioning, explicit nullability, consistent naming and server variables instead of fixed URLs. Templates and worked examples sit in a separate reference file. It names no particular generator or validator.

できること

  • Write an OpenAPI 3.1 specification
  • Choose design-first or code-first working
  • Define reusable schemas and security schemes