openapi-spec-generation
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
概要
- 公開元
- wshobson
インストール
プロジェクトのドキュメントに、確認できるインストール手順がありません。 プロジェクトの手順を見る
含まれるファイル
- references/code-first-and-tooling.md
- references/details.md
MCPサーバーやスキルは、お使いのコンピューターでコードを実行したり、データを操作したりできます。インストールする前にソースを確認してください。
詳細
出典
- スキルファイル(SKILL.md)github.com/wshobson/agents · 根拠となる項目:スクリプトを含む2026年11月10日
- GitHubリポジトリgithub.com/wshobson/agents · 根拠となる項目:ライセンス, 公開元, 活動状況2026年11月11日
- スキルファイル(SKILL.md)github.com/sickn33/agentic-awesome-skills2026年11月17日
- リポジトリ内のフォルダ(openapi-spec-generation)github.com/wshobson/agents · 根拠となる項目:スクリプトを含む2026年11月10日