ClaudeSuperPower
SubmitLog in

generate-oas

Skill

Generate a complete OpenAPI 3.0 (OAS) specification from an API codebase, a Postman or Insomnia collection, or both together. Use this skill whenever the user wants to generate, create, or derive an OpenAPI spec, reverse-engineer an API definition, document an existing API, or convert a Postman/Inso

1Documents

Install

git clone https://github.com/42Crunch-AI/claude-plugins.git ~/.claude/skills/generate-oas

What is generate-oas?

Generate a complete OpenAPI 3.0 (OAS) specification from an API codebase, a Postman or Insomnia collection, or both together. Use this skill whenever the user wants to generate, create, or derive an OpenAPI spec, reverse-engineer an API definition, document an existing API, or convert a Postman/Insomnia collection to OpenAPI — when there is no existing OAS file yet. Triggers on phrases like "generate OAS", "create an OpenAPI spec", "generate openapi.json", "document my API", "reverse-engineer spec", "convert postman to openapi", "convert insomnia to openapi", "postman collection to OAS", "insomnia collection to OAS", or any request to produce an OAS file from source material rather than from an existing spec.

What this can do

Capabilities declared in this component's own frontmatter — not inferred.

Inherit all session tools

Declares no tool restrictions — inherits every session tool

~180 tokens of context used while enabled, before you invoke anything

Trust

69/100 · Good

3 factors scored below maximum

No license

Documentation

README · ~26 min read

Generate an OpenAPI Specification

Produces a complete, valid OpenAPI 3.0.x specification file (openapi.json) from one or two source materials:

  • an API codebase (any language/framework), and/or
  • an API client collection — either a Postman collection (v2.0 or v2.1, with an optional environment file) or an Insomnia collection (v4 JSON export, or v5 JSON/YAML export, with an optional separate environment export)

No existing OAS file is required. When both a codebase and a collection are available, the codebase is treated as the primary source of truth for

Reviews

Log in to leave a review.

No reviews yet — be the first.

Explore related

Other things in this space — across every part of the ecosystem, not just skills.

Skillssimilar to this one

All skills →

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

43.6K stars

command-development

This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs gu

32.8K stars

plugin-settings

This skill should be used when the user asks about "plugin settings", "store plugin configuration", "user-configurable plugin", ".local.md files", "plugin state files", "read YAML frontmatter", "per-project plugin settings", or wants to make plugin behavior configurable. Documents the .claude/plugin

32.8K stars