swagger2skill

Name: swagger2skill
Availability: InStock
Author: PPsteven

Generate Claude skills from OpenAPI and Swagger specifications.

1|Updated Feb 24, 2026

Search Tags:#api #openapi #code generation #skill generation #cli #swagger

Ready to run

npx skills add https://github.com/PPsteven/skills --skill swagger2skill

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: swagger2skill
Source: https://github.com/PPsteven/skills/tree/main/swagger2skill
Command: npx skills add https://github.com/PPsteven/skills --skill swagger2skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires click, requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of reusable Claude skills by converting OpenAPI/Swagger specifications into functional code, eliminating manual API endpoint transcription and boilerplate generation.

Core Features & Use Cases

Automated Skill Generation: Creates a complete skill directory, including SKILL.md, CLI tools, and reference documentation, directly from an OpenAPI specification.
Selective API Wrapping: Allows users to choose specific API categories (tags) to include in the generated skill, tailoring it to their needs.
Use Case: You need to build a skill to interact with a complex REST API. Instead of manually writing all the code, you provide the API's OpenAPI spec to swagger2skill, select the desired endpoints (e.g., user management, order processing), and it generates a ready-to-use skill with a Python CLI.

Quick Start

Use the swagger2skill skill with the provided OpenAPI URL to generate a new skill.

Frequently Asked Questions about swagger2skill

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

FAQPage Schema

How do I generate a Python CLI from an OpenAPI specification?▼

You can generate a Python CLI from an OpenAPI specification by providing the API URL to this skill. It parses the definitions and creates a structured directory with a Click-based CLI tool and reference docs.

Does swagger2skill support both Swagger 2.0 and OpenAPI 3.0?▼

Yes, swagger2skill supports both Swagger 2.0 and OpenAPI 3.0.x specifications. It parses either format to extract API definitions and tags for generating the skill directory.

Can I generate a skill for specific API endpoints instead of the entire API?▼

Yes, you can generate a skill for specific API endpoints by selecting specific API categories defined via tags. This allows selective API wrapping tailored to your needs.

What is the best way to automate Claude skill creation from a REST API?▼

The best way to automate Claude skill creation from a REST API is using swagger2skill. It eliminates manual endpoint transcription by converting OpenAPI specs into functional code and a SKILL.md file.

Do I need the Click and requests packages to use the generated skill?▼

Yes, you need the Click and requests packages to use the generated skill. The skill generates Python CLI tools using Click and relies on requests for making API calls.

What files are included in the skill directory generated from an OpenAPI spec?▼

The skill directory generated from an OpenAPI spec includes a SKILL.md file, Python CLI tools, and reference documentation. These components provide a ready-to-use skill structure.