How do I install the Openapi Spec Generation skill?

Run npx skillmds@latest add tomevault-io/openapi-spec-generation-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openapi Spec Generation safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openapi Spec Generation?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openapi Spec Generation free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openapi Spec Generation?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openapi Spec Generation by tomevault-io

Name: Openapi Spec Generation
Author: tomevault-io

Openapi Spec Generation

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. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

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.md for detailed patterns and examples.

AGI Framework Integration

Adapted for @techwavedev/agi-agent-kit Original source: antigravity-awesome-skills

Memory-First Protocol

Retrieve prior API design decisions, database schema choices, and error handling patterns. Cache API response templates for consistent error formatting.

# Check for prior backend/API context before starting
python3 execution/memory_manager.py auto --query "API design patterns and architecture decisions for Openapi Spec Generation"

Storing Results

After completing work, store backend/API decisions for future sessions:

python3 execution/memory_manager.py store \
  --content "API architecture: REST with HATEOAS, JWT auth, rate limiting at 100 req/min per tenant" \
  --type decision --project <project> \
  --tags openapi-spec-generation backend

Multi-Agent Collaboration

Share API contract changes with frontend agents so they update their client code, and with QA agents for test coverage.

python3 execution/cross_agent_context.py store \
  --agent "<your-agent>" \
  --action "Implemented API endpoints — 5 new routes with OpenAPI spec and integration tests" \
  --project <project>

Agent Team: Code Review

After implementation, dispatch code_review_team for two-stage review (spec compliance + code quality) before merging.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: openapi-spec-generation-2description: 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. Use when this capability is needed.---# OpenAPI Spec GenerationComprehensive 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.md` for detailed patterns and examples.---## AGI Framework Integration> **Adapted for [@techwavedev/agi-agent-kit](https://www.npmjs.com/package/@techwavedev/agi-agent-kit)**> Original source: [antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills)### Memory-First ProtocolRetrieve prior API design decisions, database schema choices, and error handling patterns. Cache API response templates for consistent error formatting.```bash# Check for prior backend/API context before startingpython3 execution/memory_manager.py auto --query "API design patterns and architecture decisions for Openapi Spec Generation"```### Storing ResultsAfter completing work, store backend/API decisions for future sessions:```bashpython3 execution/memory_manager.py store \ --content "API architecture: REST with HATEOAS, JWT auth, rate limiting at 100 req/min per tenant" \ --type decision --project <project> \ --tags openapi-spec-generation backend```### Multi-Agent CollaborationShare API contract changes with frontend agents so they update their client code, and with QA agents for test coverage.```bashpython3 execution/cross_agent_context.py store \ --agent "<your-agent>" \ --action "Implemented API endpoints — 5 new routes with OpenAPI spec and integration tests" \ --project <project>```### Agent Team: Code ReviewAfter implementation, dispatch `code_review_team` for two-stage review (spec compliance + code quality) before merging.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/techwavedev) — claim your Tome and manage your conversions.

Frequently asked questions