openapi-spec-generation – Coding skill for AI agents
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.
Install the openapi-spec-generation skill with one command
Pick the tool you use, copy the command and paste it in your terminal. The skill lands in that tool's skills folder and is ready in your next session.
Claude Code
mkdir -p ~/.claude/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.claude/skills
Call it in Claude Code: /openapi-spec-generation – then describe the task you want done.
Codex
mkdir -p ~/.codex/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.codex/skills
Call it in Codex: $openapi-spec-generation – then describe the task you want done.
Hermes Agent
mkdir -p ~/.hermes/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.hermes/skills
Call it in Hermes Agent: /openapi-spec-generation – then describe the task you want done.
DeepSeek
mkdir -p ~/.deepcode/skills && curl -fsSL https://skill.dn1nguoi.com/z/openapi-spec-generation-90934.tgz | tar xz -C ~/.deepcode/skills
Call it in DeepSeek: /openapi-spec-generation – then describe the task you want done.
SKILL.md content
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.
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.
Related skills
- openapi-spec-generator – Generate complete, production-ready OpenAPI 3.x and Swagger 2.0 specifications from…
- openclaw-github-repo-commander – 7-stage super workflow for GitHub repo audit, cleanup, PR review, and competitor analysis
- opencode-delegate – Delegate coding tasks to the OpenCode CLI only when the user explicitly requests it…
- orchestrate-batch-refactor – Plan and execute large refactors with dependency-aware work packets and parallel analysis.
- papers-skill – Skill for academic research workflows: search Semantic Scholar (200M+ papers), inspect…
- parcel-coupon – Call parcel/courier coupon API to fetch one-stop logistics service coupons, including…
- penetration-testing – Perform basic penetration testing and security assessments.
- performance-engineer – Diagnose performance bottlenecks using profiling, traces, load tests, and observability…