openapi-schema-creator
CommunityBuild valid OpenAPI 3.1 REST API schemas easily.
Software Engineering#openapi#api-design#rest-api#api-contract#schema-generation#backend-development#openapi-3.1
Authorsusamn
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Manually creating consistent, valid OpenAPI 3.1 REST API contracts is time-consuming and error-prone, especially for teams that need to align on entity models, endpoint designs, and standard error shapes across services.
Core Features & Use Cases
- Guided Conversational Workflow: Walks users through 6 structured phases from initial service idea to production-ready schema, including entity discovery, CRUD endpoint design, and iterative refinement.
- Built-in Best Practices: Enforces standard pagination envelopes, RFC 7807 problem details for errors, reusable $ref components, and support for common authentication and API versioning patterns.
- Use Case: A backend developer building a new task management API can use this skill to define User and Project entities, design CRUD and custom endpoints, and generate a fully valid OpenAPI 3.1 spec ready for client code generation and mock server setup.
Quick Start
Use the openapi-schema-creator skill to design a complete OpenAPI 3.1 schema for a file sharing API with user, folder, and file entities.
Dependency Matrix
Required Modules
None requiredComponents
scriptsreferencesassets
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: openapi-schema-creator Download link: https://github.com/susamn/skills/archive/main.zip#openapi-schema-creator Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 536,000+ vetted skills library on demand.