Agent Skills
› rmyndharis/antigravity-skills
› openapi-spec-generation
openapi-spec-generation
GitHub用于从代码、设计文档生成和维护 OpenAPI 3.1 规范，支持 API 文档创建、SDK 生成及契约合规验证。
Trigger Scenarios
需要生成或更新 OpenAPI 规范
基于代码生成 API 文档
进行设计优先的 API 契约设计
验证 API 实现与规范的符合性
从规范生成客户端 SDK
Install
npx skills add rmyndharis/antigravity-skills --skill openapi-spec-generation -g -y
SKILL.md
Frontmatter
{
"name": "openapi-spec-generation",
"description": "Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance."
}
OpenAPI Spec Generation
Comprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.
Use this skill when
- Creating API documentation from scratch
- Generating OpenAPI specs from existing code
- Designing API contracts (design-first approach)
- Validating API implementations against specs
- Generating client SDKs from specs
- Setting up API documentation portals
Do not use this skill when
- The task is unrelated to openapi spec generation
- You need a different domain or tool outside this scope
Instructions
- Clarify goals, constraints, and required inputs.
- Apply relevant best practices and validate outcomes.
- Provide actionable steps and verification.
- If detailed examples are required, open
resources/implementation-playbook.md.
Resources
resources/implementation-playbook.mdfor detailed patterns and examples.
Version History
- e63f7dd Current 2026-07-05 09:35
