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.

主要功能

2 GitHub stars
Supports both OpenAPI 3.x and Swagger 2.0 with automatic internal conversion
Resolves complex $ref schemas and handles circular references gracefully
Fetches specifications from remote URLs or reads local JSON/YAML files
Provides automated TypeScript type mapping for all API schemas and properties
Generates unique hashes for change detection and tracking endpoint updates

使用场景

Extracting specific endpoint metadata to assist in building backend route handlers
Validating local OpenAPI files during development to ensure structural compliance
Automating the generation of TypeScript API clients from a live documentation URL

关于

主要功能

2 GitHub stars
Supports both OpenAPI 3.x and Swagger 2.0 with automatic internal conversion
Resolves complex $ref schemas and handles circular references gracefully
Fetches specifications from remote URLs or reads local JSON/YAML files
Provides automated TypeScript type mapping for all API schemas and properties
Generates unique hashes for change detection and tracking endpoint updates

使用场景

Extracting specific endpoint metadata to assist in building backend route handlers
Validating local OpenAPI files during development to ensure structural compliance
Automating the generation of TypeScript API clients from a live documentation URL