Agent Skills
› rmyndharis/antigravity-skills
› openapi-spec-generation
openapi-spec-generation
GitHub用于创建、维护和验证 OpenAPI 3.1 规范的技能，支持从代码生成规范、设计先行契约、实现合规性校验及生成 SDK。
触发场景
需要从零开始编写 API 文档
从现有代码生成 OpenAPI 规范
设计 API 契约（Design-first）
验证 API 实现与规范的一致性
根据规范生成客户端 SDK
搭建 API 文档门户
安装
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.
版本历史
- e63f7dd 当前 2026-07-05 09:35
