Does this skill support OpenAPI 3.0?

Yes, the skill is designed to generate and validate complete OpenAPI 3.0 specifications in both JSON and YAML formats, including component schemas and path definitions.

Can it help with GraphQL query performance?

Absolutely. It includes implementation patterns for avoiding N+1 query problems and tools for query complexity analysis to ensure your GraphQL API remains performant.

Which API versioning strategies are supported?

The skill provides templates and logic for URL-based versioning, header-based versioning, and content negotiation strategies to help maintain backward compatibility.

How does it assist with RESTful compliance?

It includes a REST compliance validator that checks for noun-based resource naming, proper HTTP method usage, and appropriate status code responses.

API Design Specialist

Name: API Design Specialist
Author: eroslifestyle

byeroslifestyle

0•

API 开发

Architects robust, scalable, and standardized APIs using REST best practices, GraphQL patterns, and OpenAPI specifications.

The API Design skill empowers developers to build production-grade interfaces by providing expert guidance on modern architectural patterns and industry standards. It automates the generation of OpenAPI specifications, creates optimized GraphQL schemas with efficient resolvers, and implements standardized RESTful conventions including HATEOAS and proper HTTP status codes. Whether you are versioning an existing service or designing a new microservice from scratch, this skill ensures consistency, performance, and comprehensive documentation throughout the API lifecycle, reducing technical debt and improving developer experience.

主要功能

01Automated OpenAPI 3.0 specification and documentation generation

020 GitHub stars

03Standardized HTTP status code mapping and API testing patterns

04GraphQL schema optimization and N+1 query prevention

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

06RESTful resource modeling and HATEOAS link generation

使用场景

01Designing a new RESTful microservice with standardized endpoint conventions

02Migrating a legacy API to a modern GraphQL schema with optimized resolvers

03Generating and validating OpenAPI documentation for an existing codebase

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

主要功能

01Automated OpenAPI 3.0 specification and documentation generation

020 GitHub stars

03Standardized HTTP status code mapping and API testing patterns

04GraphQL schema optimization and N+1 query prevention

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

06RESTful resource modeling and HATEOAS link generation

使用场景

01Designing a new RESTful microservice with standardized endpoint conventions

02Migrating a legacy API to a modern GraphQL schema with optimized resolvers

03Generating and validating OpenAPI documentation for an existing codebase

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