api-schema - Design API schemas with OpenAPI
Defines request/response shapes, versioning, validation, and compatibility rules for API-first work
Tags
Updated: 2026-03-20Capabilities
Typical Inputs
Typical Outputs
What this skill does
- Create OpenAPI specification
- Define reusable schemas
- Classify changes
- Choose versioning strategy
- Generate code from spec
- Add request validation
- Design REST API
- Add endpoints
- Generate client SDK
- Generate server stubs
- Document API
- Validate spec
Inputs
- OpenAPI specification
- JSON Schema
- Service name
- API resource
- Request parameters
- User data
- Error structure
- Versioning strategy
Outputs
- OpenAPI file
- Client SDK
- Server stub code
- API documentation
- Validation errors
- Diff report
Requirements
- OpenAPI 3.1 specification
- Code generation tools
- CI validation environment
