Is this skill compatible with OpenAPI 3.1?

Yes, it supports all versions of OpenAPI and Swagger as long as the remote file is formatted as valid JSON or YAML.

Can I specify where the file is saved?

Yes, the skill accepts an optional output-path argument allowing you to save the file to any specific directory or filename.

Does it support YAML files?

Yes, it supports both JSON and YAML formats for OpenAPI 2.0 and 3.x specifications.

What happens if the URL is a documentation page instead of a raw spec?

The skill validates the content format and will return an error if it detects HTML instead of a valid JSON or YAML OpenAPI specification.

Does it require any external dependencies?

The skill uses the system's curl utility, which is standard in most development environments where Claude Code operates.

Swagger & OpenAPI Downloader

Name: Swagger & OpenAPI Downloader
Author: HaibaraAiAPTX

byHaibaraAiAPTX

API開発

Downloads and validates OpenAPI or Swagger specification files from remote URLs to streamline API-driven development workflows.

概要

The Swagger & OpenAPI Downloader skill simplifies the process of bringing remote API contracts into your local environment. It automatically fetches specification files via URL, supports both JSON and YAML formats for OpenAPI 2.0 and 3.x, and performs basic validation to ensure the file is a legitimate specification rather than a generic HTML page. This utility is perfect for developers who need to maintain up-to-date local copies of API documentation for code generation, testing, or documentation purposes without manual downloading and renaming.

主な機能

Fetches specifications from any accessible URL via curl
Automatic file format detection and syntax validation
Supports JSON and YAML formats for OpenAPI 2.0, 3.0, and 3.1
0 GitHub stars
Customizable local output paths for organized project structures
Returns detailed file metadata including size, path, and format

ユースケース

Automating the retrieval of latest backend contracts in CI/CD pipelines
Synchronizing local API specs before regenerating TypeScript types and clients
Quickly importing third-party API documentation for local analysis and testing

概要

主な機能

Fetches specifications from any accessible URL via curl
Automatic file format detection and syntax validation
Supports JSON and YAML formats for OpenAPI 2.0, 3.0, and 3.1
0 GitHub stars
Customizable local output paths for organized project structures
Returns detailed file metadata including size, path, and format

ユースケース

Automating the retrieval of latest backend contracts in CI/CD pipelines
Synchronizing local API specs before regenerating TypeScript types and clients
Quickly importing third-party API documentation for local analysis and testing