Can this skill generate OpenAPI 3.0 documentation?

Yes, the skill includes a dedicated OpenAPI Generator that creates comprehensive 3.0.0 specifications, including paths, components, and security schemas.

Can I use this to audit my existing API code?

Yes, by utilizing tools like Grep and Read, the skill can analyze your current implementation and provide a compliance check against REST best practices.

Does it support both REST and GraphQL paradigms?

Absolutely. It contains specialized designers for both RESTful resource patterns and GraphQL schema optimization, including pagination and resolver logic.

How does the skill handle API versioning?

It provides implementation patterns for three major strategies: URL-based versioning (e.g., /v1/), Header-based versioning, and Content Negotiation.

API Design & Architect

Name: API Design & Architect
Author: eroslifestyle

byeroslifestyle

0•

API Development

Architects production-grade REST and GraphQL APIs with automated OpenAPI specifications and robust versioning strategies.

The API Design skill transforms Claude into a senior API architect capable of designing, documenting, and auditing complex interface structures. It provides specialized logic for RESTful resource modeling, GraphQL schema optimization, and the generation of standardized OpenAPI 3.0 specifications. By enforcing industry best practices—such as HATEOAS, proper HTTP status code usage, and sophisticated versioning patterns—this skill ensures that your backend services remain maintainable, scalable, and developer-friendly throughout their lifecycle.

Key Features

01GraphQL schema design including pagination, mutations, and query optimization

02OpenAPI 3.0 specification generation in YAML and JSON formats

03Compliance auditing for REST best practices and naming conventions

04Automated RESTful resource and endpoint generation with HATEOAS support

050 GitHub stars

06Multi-strategy API versioning implementation (URL, Header, and Content Negotiation)

Use Cases

01Scaffolding a new microservice with a complete OpenAPI-compliant interface

02Designing complex GraphQL schemas with optimized resolvers and N+1 prevention

03Refactoring legacy endpoints into a standardized RESTful structure with versioning

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add eroslifestyle/claude-orchestrator-plugin api-design

For use in Claude.ai and ChatGPT

Key Features

01GraphQL schema design including pagination, mutations, and query optimization

02OpenAPI 3.0 specification generation in YAML and JSON formats

03Compliance auditing for REST best practices and naming conventions

04Automated RESTful resource and endpoint generation with HATEOAS support

050 GitHub stars

06Multi-strategy API versioning implementation (URL, Header, and Content Negotiation)

Use Cases

01Scaffolding a new microservice with a complete OpenAPI-compliant interface

02Designing complex GraphQL schemas with optimized resolvers and N+1 prevention

03Refactoring legacy endpoints into a standardized RESTful structure with versioning

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add eroslifestyle/claude-orchestrator-plugin api-design

For use in Claude.ai and ChatGPT