Can this skill generate OpenAPI specifications?

Yes, it helps you create, validate, and document OpenAPI 3.0 and Swagger specifications for your endpoints based on your code or requirements.

How does it handle API security?

It offers detailed guidance on implementing OAuth 2.0 flows, JWT token design, API key management, and security patterns like PKCE and RBAC.

Does it provide error handling standards?

Yes, it defines consistent JSON error response formats and provides a mapping of operations to standard HTTP status codes for better API predictability.

Does it support both REST and GraphQL?

Absolutely. It provides specific workflows for resource-oriented REST design and type-safe GraphQL schema definitions including queries and mutations.

Can I use it to plan API versioning?

Yes, it includes strategies for both URL and header-based versioning, along with advice on semantic versioning and maintaining backward compatibility.

API Designer

Name: API Designer
Author: icartsh

byicartsh

API 개발

Designs and documents production-grade RESTful and GraphQL APIs with OpenAPI specifications and industry-standard security patterns.

소개

API Designer is a specialized Claude Code skill that streamlines the process of architecting robust web services. It provides standardized guidance for resource identification, endpoint naming, GraphQL schema design, and comprehensive documentation using OpenAPI 3.0. Beyond structure, the skill implements best practices for authentication (OAuth 2.0, JWT), versioning strategies, and consistent error handling, making it an essential tool for developers building scalable, secure, and developer-friendly backends.

주요 기능

Comprehensive authentication patterns (OAuth 2.0, JWT, PKCE)
RESTful endpoint and resource-oriented architecture design
Strategic API versioning and deprecation planning
Automated OpenAPI 3.0 and Swagger documentation generation
GraphQL schema definition and resolver pattern optimization
0 GitHub stars

사용 사례

Architecting a new REST or GraphQL API from scratch
Modernizing legacy APIs with better security and documentation
Generating standardized OpenAPI specifications for team collaboration

소개

주요 기능

Comprehensive authentication patterns (OAuth 2.0, JWT, PKCE)
RESTful endpoint and resource-oriented architecture design
Strategic API versioning and deprecation planning
Automated OpenAPI 3.0 and Swagger documentation generation
GraphQL schema definition and resolver pattern optimization
0 GitHub stars

사용 사례

Architecting a new REST or GraphQL API from scratch
Modernizing legacy APIs with better security and documentation
Generating standardized OpenAPI specifications for team collaboration