Can this skill generate valid OpenAPI 3.1 files?

Yes, the API Designer skill is specifically configured to generate complete, valid OpenAPI 3.1 specifications in both YAML and JSON formats for your services.

Does it support GraphQL architecture as well as REST?

Absolutely. While it has deep expertise in RESTful patterns, it also provides comprehensive guidance for designing GraphQL schemas and resource relationships.

Does it help with error response standardization?

Yes, it follows RFC 7807 (Problem Details for HTTP APIs) to ensure your API returns consistent, actionable, and well-documented error structures.

How does the skill handle API versioning and breaking changes?

It implements industry-standard versioning strategies and deprecation policies, ensuring your API evolution includes clear migration paths for developers.

API Designer

Name: API Designer
Author: franroa

byfranroa

API開発

Architects scalable, developer-friendly REST and GraphQL APIs with production-grade OpenAPI 3.1 specifications.

概要

The API Designer skill transforms Claude into a senior architect capable of designing sophisticated API ecosystems from the ground up. It provides expert-level guidance on resource modeling, versioning strategies, and standardized error handling while ensuring strict adherence to RESTful principles and modern GraphQL patterns. This skill is essential for developers looking to create robust API contracts that are performant, secure, and highly maintainable, complete with comprehensive documentation and actionable request/response examples.

主な機能

Resource-oriented RESTful API design and modeling
GraphQL schema architecture and relationship mapping
0 GitHub stars
Full OpenAPI 3.1 specification generation in YAML or JSON
Standardized versioning, pagination, and error-handling strategies
Detailed authentication and authorization flow documentation

ユースケース

Bootstrapping a new microservice with a formal, production-ready OpenAPI contract
Designing complex pagination and filtering systems for high-traffic data collections
Refactoring legacy endpoints to meet modern REST standards and naming conventions

概要

主な機能

Resource-oriented RESTful API design and modeling
GraphQL schema architecture and relationship mapping
0 GitHub stars
Full OpenAPI 3.1 specification generation in YAML or JSON
Standardized versioning, pagination, and error-handling strategies
Detailed authentication and authorization flow documentation

ユースケース

Bootstrapping a new microservice with a formal, production-ready OpenAPI contract
Designing complex pagination and filtering systems for high-traffic data collections
Refactoring legacy endpoints to meet modern REST standards and naming conventions