openapi-spec-generation
Tools for generating, validating, and maintaining OpenAPI 3.1 specs to ensure consistent API documentation and implementation.
Install
mkdir -p .claude/skills/openapi-spec-generation-anhvu1107 && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14167" && unzip -o skill.zip -d .claude/skills/openapi-spec-generation-anhvu1107 && rm skill.zipInstalls to .claude/skills/openapi-spec-generation-anhvu1107
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
ALWAYS use this when the request matches Openapi Spec Generation: Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns.Key capabilities
- →Create API documentation from scratch
- →Design API contracts using a design-first approach
- →Validate API implementations against specifications
How it works
The skill applies patterns for creating, maintaining, and validating OpenAPI 3.1 specifications. It clarifies goals, constraints, and inputs, then applies best practices to generate or validate API documentation.
Inputs & outputs
When to use openapi-spec-generation
- →Generate OpenAPI spec from code
- →Design a new API contract
- →Validate API implementation against spec
About this skill
OpenAPI Spec Generation
Selective Reading Rule
Start with:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
Then load only the inherited docs, scripts, assets, or examples that match the user's actual task.
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.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
When not to use it
- →When a different domain or tool outside this scope is required
Limitations
- →The skill is limited to OpenAPI 3.1 specifications
- →The skill does not implement the API itself, only generates its specification
- →The skill does not cover other API documentation formats
How it compares
This skill provides complete patterns and validation for OpenAPI 3.1 specification generation, offering a structured and standardized approach compared to ad-hoc API documentation.
Compared to similar skills
openapi-spec-generation side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| openapi-spec-generation (this skill) | 0 | 3mo | No flags | Intermediate |
| openapi-spec-generation | 22 | 2mo | No flags | Intermediate |
| korean-skill-creator | 8 | 9mo | Review | Beginner |
| skill-forge | 11 | 9mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by Anhvu1107
View all by Anhvu1107 →You might also like
openapi-spec-generation
wshobson
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.
korean-skill-creator
clwmfksek
한글 기반 클로드 스킬 자동 생성 도구. 사용자가 "클로드 스킬을 만들어줘" 또는 "[요구사항] 스킬 만들어줘"라고 요청할 때 사용. Progressive disclosure 원칙을 따르는 한글 문서 구조(SKILL.md + references/)를 자동으로 생성하고, 실전 예시를 포함한 일관성 있는 스킬 템플릿을 제공.
skill-forge
WilliamSaysX
Automated skill creation workshop with intelligent source detection, smart path management, and end-to-end workflow automation. This skill should be used when users want to create a new skill or convert external resources (GitHub repositories, online documentation, or local directories) into a skill. Automatically fetches, organizes, and packages skills with proactive cleanup management.
svelte-expert
Raudbjorn
Expert Svelte/SvelteKit development assistant for building components, utilities, and applications. Use when creating Svelte components, SvelteKit applications, implementing reactive patterns, handling state management, working with stores, transitions, animations, or any Svelte/SvelteKit development task. Includes comprehensive documentation access, code validation with svelte-autofixer, and playground link generation.
claude-opus-4-5-migration
anthropics
Migrate prompts and code from Claude Sonnet 4.0, Sonnet 4.5, or Opus 4.1 to Opus 4.5. Use when the user wants to update their codebase, prompts, or API calls to use Opus 4.5. Handles model string updates and prompt adjustments for known Opus 4.5 behavioral differences. Does NOT migrate Haiku 4.5.
copilot-sdk
github
Build agentic applications with GitHub Copilot SDK. Use when embedding AI agents in apps, creating custom tools, implementing streaming responses, managing sessions, connecting to MCP servers, or creating custom agents. Triggers on Copilot SDK, GitHub SDK, agentic app, embed Copilot, programmable agent, MCP server, custom agent.