{"id":"0746fa6f-7737-47dd-8771-a56201713a23","shortId":"h8LsZX","kind":"skill","title":"openapi-spec-generation","tagline":"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.","description":"# OpenAPI Spec Generation\n\nComprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.\n\n## Use this skill when\n\n- Creating API documentation from scratch\n- Generating OpenAPI specs from existing code\n- Designing API contracts (design-first approach)\n- Validating API implementations against specs\n- Generating client SDKs from specs\n- Setting up API documentation portals\n\n## Do not use this skill when\n\n- The task is unrelated to openapi spec generation\n- You need a different domain or tool outside this scope\n\n## Instructions\n\n- Clarify goals, constraints, and required inputs.\n- Apply relevant best practices and validate outcomes.\n- Provide actionable steps and verification.\n- If detailed examples are required, open `resources/implementation-playbook.md`.\n\n## Resources\n\n- `resources/implementation-playbook.md` for detailed patterns and examples.\n\n## Limitations\n- Use this skill only when the task clearly matches the scope described above.\n- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.\n- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.","tags":["openapi","spec","generation","antigravity","awesome","skills","sickn33","agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding"],"capabilities":["skill","source-sickn33","skill-openapi-spec-generation","topic-agent-skills","topic-agentic-skills","topic-ai-agent-skills","topic-ai-agents","topic-ai-coding","topic-ai-workflows","topic-antigravity","topic-antigravity-skills","topic-claude-code","topic-claude-code-skills","topic-codex-cli","topic-codex-skills"],"categories":["antigravity-awesome-skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/sickn33/antigravity-awesome-skills/openapi-spec-generation","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add sickn33/antigravity-awesome-skills","source_repo":"https://github.com/sickn33/antigravity-awesome-skills","install_from":"skills.sh"}},"qualityScore":"0.700","qualityRationale":"deterministic score 0.70 from registry signals: · indexed on github topic:agent-skills · 34616 github stars · SKILL.md body (1,223 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-04-23T00:51:21.616Z","embedding":null,"createdAt":"2026-04-18T21:42:02.188Z","updatedAt":"2026-04-23T00:51:21.616Z","lastSeenAt":"2026-04-23T00:51:21.616Z","tsv":"'3.1':9,43 'action':124 'api':23,29,47,53,64,71,82 'appli':116 'approach':69 'ask':175 'best':118 'boundari':183 'clarif':177 'clarifi':110 'clear':150 'client':76 'code':12,62 'complianc':31 'comprehens':35 'constraint':112 'contract':30,65 'creat':22,38,52 'criteria':186 'describ':154 'design':14,63,67 'design-first':13,66 'detail':129,138 'differ':102 'document':24,54,83 'domain':103 'ensur':28 'environ':166 'environment-specif':165 'exampl':130,141 'exist':61 'expert':171 'first':15,68 'generat':4,5,25,34,57,75,98 'goal':111 'implement':72 'input':115,180 'instruct':109 'limit':142 'maintain':7,39 'match':151 'miss':188 'need':100 'open':133 'openapi':2,8,32,42,58,96 'openapi-spec-gener':1 'outcom':122 'output':160 'outsid':106 'pattern':19,36,139 'permiss':181 'portal':84 'practic':119 'provid':123 'relev':117 'requir':114,132,179 'resourc':135 'resources/implementation-playbook.md':134,136 'rest':46 'review':172 'safeti':182 'scope':108,153 'scratch':56 'sdks':26,77 'set':80 'skill':50,89,145 'skill-openapi-spec-generation' 'source-sickn33' 'spec':3,16,33,59,74,79,97 'specif':10,44,167 'step':125 'stop':173 'substitut':163 'success':185 'task':92,149 'test':169 'tool':105 'topic-agent-skills' 'topic-agentic-skills' 'topic-ai-agent-skills' 'topic-ai-agents' 'topic-ai-coding' 'topic-ai-workflows' 'topic-antigravity' 'topic-antigravity-skills' 'topic-claude-code' 'topic-claude-code-skills' 'topic-codex-cli' 'topic-codex-skills' 'treat':158 'unrel':94 'use':20,48,87,143 'valid':18,41,70,121,168 'verif':127","prices":[{"id":"bc34a86e-4ae6-4fa7-8e98-854bfe3016e8","listingId":"0746fa6f-7737-47dd-8771-a56201713a23","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"sickn33","category":"antigravity-awesome-skills","install_from":"skills.sh"},"createdAt":"2026-04-18T21:42:02.188Z"}],"sources":[{"listingId":"0746fa6f-7737-47dd-8771-a56201713a23","source":"github","sourceId":"sickn33/antigravity-awesome-skills/openapi-spec-generation","sourceUrl":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/openapi-spec-generation","isPrimary":false,"firstSeenAt":"2026-04-18T21:42:02.188Z","lastSeenAt":"2026-04-23T00:51:21.616Z"}],"details":{"listingId":"0746fa6f-7737-47dd-8771-a56201713a23","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"sickn33","slug":"openapi-spec-generation","github":{"repo":"sickn33/antigravity-awesome-skills","stars":34616,"topics":["agent-skills","agentic-skills","ai-agent-skills","ai-agents","ai-coding","ai-workflows","antigravity","antigravity-skills","claude-code","claude-code-skills","codex-cli","codex-skills","cursor","cursor-skills","developer-tools","gemini-cli","gemini-skills","kiro","mcp","skill-library"],"license":"mit","html_url":"https://github.com/sickn33/antigravity-awesome-skills","pushed_at":"2026-04-22T06:40:00Z","description":"Installable GitHub library of 1,400+ agentic skills for Claude Code, Cursor, Codex CLI, Gemini CLI, Antigravity, and more. Includes installer CLI, bundles, workflows, and official/community skill collections.","skill_md_sha":"ab492aad029b8e78fde23f602a45a185f8658351","skill_md_path":"skills/openapi-spec-generation/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/openapi-spec-generation"},"layout":"multi","source":"github","category":"antigravity-awesome-skills","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."},"skills_sh_url":"https://skills.sh/sickn33/antigravity-awesome-skills/openapi-spec-generation"},"updatedAt":"2026-04-23T00:51:21.616Z"}}