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

0•

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.

主要功能

01Resource-oriented RESTful API design and modeling

02GraphQL schema architecture and relationship mapping

030 GitHub stars

04Full OpenAPI 3.1 specification generation in YAML or JSON

05Standardized versioning, pagination, and error-handling strategies

06Detailed authentication and authorization flow documentation

使用场景

01Bootstrapping a new microservice with a formal, production-ready OpenAPI contract

02Designing complex pagination and filtering systems for high-traffic data collections

03Refactoring legacy endpoints to meet modern REST standards and naming conventions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add franroa/chezmoi api-designer

For use in Claude.ai and ChatGPT

Download Skill