Agent Skills
› rmyndharis/antigravity-skills
› openapi-spec-generation
openapi-spec-generation
GitHub用于从代码或设计生成OpenAPI 3.1规范，支持API文档创建、SDK生成及契约合规验证。适用于RESTful API的文档化、合同设计及实现校验场景。
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
