Can it handle older Swagger 2.0 files?

Yes, it includes a conversion layer that maps Swagger 2.0 definitions, parameters, and security definitions to modern OpenAPI 3.0 structures internally.

Can I use a remote URL for my specification?

Absolutely. You can provide an http or https URL, and the skill will fetch the content using the WebFetch tool before parsing.

Does this skill support both YAML and JSON?

Yes, the parser automatically detects and processes both .yaml/.yml and .json file formats for local and remote specifications.

What happens if the specification is invalid?

The skill performs validation and returns specific error codes (E201-E207) to help you pinpoint whether the issue is a syntax error or a missing required field.

How are circular references managed in schemas?

The skill detects cycles during the resolution phase and uses type name references instead of infinite inline expansion to prevent processing errors.

OpenAPI Spec Parser

Name: OpenAPI Spec Parser
Author: jhlee0409

byjhlee0409

•

API開発

Parses and extracts structured endpoint information from OpenAPI 3.x and Swagger 2.0 specifications for seamless code generation.

The OpenAPI Parser skill enables Claude to programmatically ingest, validate, and analyze API specifications from both local files and remote URLs. By resolving complex references, handling circular dependencies, and mapping OpenAPI types to TypeScript, it provides a structured foundation for building clients, servers, or documentation directly within the Claude Code environment. Whether you are dealing with legacy Swagger 2.0 or modern OpenAPI 3.x, this skill automates the tedious task of manual spec interpretation, allowing for faster development and more accurate code generation based on existing API contracts.

主な機能

012 GitHub stars

02Supports both OpenAPI 3.x and Swagger 2.0 with automatic internal conversion

03Resolves complex $ref schemas and handles circular references gracefully

04Fetches specifications from remote URLs or reads local JSON/YAML files

05Provides automated TypeScript type mapping for all API schemas and properties

06Generates unique hashes for change detection and tracking endpoint updates

ユースケース

01Extracting specific endpoint metadata to assist in building backend route handlers

02Validating local OpenAPI files during development to ensure structural compliance

03Automating the generation of TypeScript API clients from a live documentation URL

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jhlee0409/claude-plugins openapi-parser

For use in Claude.ai and ChatGPT

Download Skill