skills.rest
PPsteven
PPstevenCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

swagger2skill

Generate Claude skills from OpenAPI and Swagger specifications.

1|Updated Feb 24, 2026
Search Tags:#api#openapi#code generation#skill generation#cli#swagger
One-click install
npx skills add https://github.com/PPsteven/skills --skill swagger2skill
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
jhlee0409jhlee0409
4

openapi-parser

Parse OpenAPI 3.x and Swagger 2.0 specs into structured endpoint catalogs.

Community
Advanced
AzureManagedRedisAzureManagedRedis
2

amr-migration-skill

Automate Azure Cache for Redis to Azure Managed Redis migration via ARM REST APIs.

Official
Advanced
vikrant-projectvikrant-project
2

rest-graphql-debug

Automate debugging and validation of REST and GraphQL APIs with curl and Python requests.

Community
Intermediate
gztcodegztcode

lark-openapi-explorer

Discover and invoke Lark OpenAPI endpoints via lark-cli.

Community
Advanced