skills.rest
vecear
vecearCOMMUNITY
Explore all skills by this author →
GitHub

openapi-generator

Generate OpenAPI 3.0/3.1 specifications from API routes in Express, Next.js, Fastify, Hono, and NestJS.

Updated Jan 21, 2026
Search Tags:#openapi#swagger#routes#schemas#api-documentation#openapi-generator
One-click install
npx skills add https://github.com/vecear/Nipponverb --skill openapi-generator-vecear
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openapi-generator
Source: https://github.com/vecear/Nipponverb/tree/main/.claude/skills/openapi-generator
Command: npx skills add https://github.com/vecear/Nipponverb --skill openapi-generator-vecear

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typescript, @babel/parser, @babel/traverse, js-yaml, commander, @apidevtools/swagger-parser, and includes scripts (resource) and references (resource) components.

What problem does it solve?

OpenAPI specifications are often written manually, leading to drift with code. This skill automatically generates OpenAPI 3.0/3.1 specs from API route definitions across Express, Next.js, Fastify, Hono, and NestJS, providing complete docs, schemas, and examples that can be imported into Postman, Insomnia, or Swagger UI.

Core Features & Use Cases

  • Scan routes to discover endpoints, methods, and parameters.
  • Extract schemas, request/response bodies, and examples to build reusable components.
  • Build OpenAPI paths and documentation, then export as YAML or JSON for CI/CD and client SDKs.
  • Supports multiple frameworks (Express, Next.js, Fastify, Hono, NestJS) and automates synchronization between code and docs.

Quick Start

Run the OpenAPI generator on your codebase to produce openapi.yaml or openapi.json.

Frequently Asked Questions about openapi-generator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I auto-generate OpenAPI specs from my Express or Next.js API routes?▼

To auto-generate OpenAPI specs from API routes, this skill scans your Express, Next.js, Fastify, Hono, or NestJS project to discover endpoints, extract schemas, and export ready-to-import YAML or JSON specifications.

What is the best way to prevent documentation drift between my API code and OpenAPI definitions?▼

Preventing documentation drift involves automating synchronization between code and docs. This skill builds OpenAPI paths directly from your route definitions, ensuring your specifications always match your actual implementation.

Can I extract request and response schemas to build reusable OpenAPI components automatically?▼

Yes, you can extract request and response schemas to build reusable OpenAPI components. The skill scans your API routes to extract schemas, request bodies, and examples, integrating them into the final specification.

Does this OpenAPI generator work with Fastify, Hono, and NestJS frameworks?▼

Yes, this OpenAPI generator works with Fastify, Hono, and NestJS frameworks. It also supports Express and Next.js projects, scanning route definitions across these platforms to produce OpenAPI 3.0 or 3.1 specifications.

How do I export OpenAPI YAML or JSON files for CI/CD pipelines and client SDKs?▼

To export OpenAPI YAML or JSON files for CI/CD pipelines, run the generator on your codebase. It builds the paths and documentation, then outputs ready-to-import openapi.yaml or openapi.json files for client SDKs.

Related Skills

Explore More Software Engineering Skills→
Camilo8902Camilo8902

postman-collection-generator

Generate Postman collection JSON files from web framework API routes.

Community
Intermediate
patricio0312revpatricio0312rev
5

openapi-generator

Generate OpenAPI 3.0/3.1 specifications from Express, Next.js, Fastify, Hono, and NestJS routes.

Community
Advanced
aegnticaegntic
4

openapi-expert

Design, validate, and generate code from OpenAPI 3.0/3.1 specifications.

Community
Advanced
hasnahasna

shadcn

Integrates reusable UI components into your Tailwind and React projects via the managed screen reader.

Official
Intermediate