openapi-generator

Generate OpenAPI 3.0/3.1 specs from JavaScript framework routes.

1|Updated Nov 6, 2025
One-click install
npx skills add https://github.com/zinohome/CozyChat --skill openapi-generator-zinohome
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openapi-generator
Source: https://github.com/zinohome/CozyChat/tree/main/.claude/skills/openapi-generator
Command: npx skills add https://github.com/zinohome/CozyChat --skill openapi-generator-zinohome

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the creation of OpenAPI 3.0/3.1 specifications directly from your API codebase, eliminating manual documentation efforts and ensuring accuracy.

Core Features & Use Cases

  • Automated Spec Generation: Creates comprehensive OpenAPI specs from Express, Next.js, Fastify, or NestJS routes.
  • Schema Extraction: Automatically infers schemas from TypeScript types.
  • Use Case: When you've just finished building a new set of API endpoints, use this skill to instantly generate a Swagger/OpenAPI documentation file that can be imported into tools like Postman or Insomnia.

Quick Start

Use the openapi-generator skill to generate an OpenAPI specification from the routes in the './src' directory.

Frequently Asked Questions about openapi-generator

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

FAQPage Schema
How do I generate OpenAPI specifications from Express or Fastify code?

To generate OpenAPI specifications from Express or Fastify code, this skill parses your route definitions and TypeScript types to automatically build OpenAPI 3.0/3.1 documents. It extracts schemas directly from your existing API codebase.

Can I extract OpenAPI schemas from TypeScript types automatically?

Yes, you can extract OpenAPI schemas from TypeScript types automatically. The skill infers schemas directly from TypeScript types used in your route handlers, eliminating the need to manually define API schemas in a separate file.

Does this openapi-generator support Next.js and NestJS route definitions?

Yes, this openapi-generator supports Next.js and NestJS route definitions. It processes route handlers and their associated JSDoc comments or decorators across various JavaScript frameworks to build the specification.

What is the best way to automate Swagger documentation for a JavaScript API?

The best way to automate Swagger documentation for a JavaScript API is to generate it directly from your codebase. This skill creates comprehensive OpenAPI specs that can be imported into tools like Postman or Insomnia.

How do I parse JSDoc comments to build API documentation?

You can parse JSDoc comments to build API documentation using this skill. It requires parsing route handlers and their associated JSDoc comments or decorators to automatically construct accurate OpenAPI 3.0/3.1 specifications.