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

0•

API Development

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.

Key Features

01Comprehensive authentication patterns (OAuth 2.0, JWT, PKCE)

02RESTful endpoint and resource-oriented architecture design

03Strategic API versioning and deprecation planning

04Automated OpenAPI 3.0 and Swagger documentation generation

05GraphQL schema definition and resolver pattern optimization

060 GitHub stars

Use Cases

01Architecting a new REST or GraphQL API from scratch

02Modernizing legacy APIs with better security and documentation

03Generating standardized OpenAPI specifications for team collaboration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add icartsh/icartsh_plugin api-designer

For use in Claude.ai and ChatGPT

Key Features

01Comprehensive authentication patterns (OAuth 2.0, JWT, PKCE)

02RESTful endpoint and resource-oriented architecture design

03Strategic API versioning and deprecation planning

04Automated OpenAPI 3.0 and Swagger documentation generation

05GraphQL schema definition and resolver pattern optimization

060 GitHub stars

Use Cases

01Architecting a new REST or GraphQL API from scratch

02Modernizing legacy APIs with better security and documentation

03Generating standardized OpenAPI specifications for team collaboration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add icartsh/icartsh_plugin api-designer

For use in Claude.ai and ChatGPT