Can it help me improve my existing API endpoints?

Absolutely. It can review your current API contracts to ensure they follow consistency, discoverability, and standard naming conventions.

How does it handle API versioning?

The skill provides strategies for both URL-prefixed and header-based versioning to ensure long-term backward compatibility.

Does this skill support gRPC design?

Yes, it provides design guidance and best practices for gRPC alongside REST, GraphQL, and CLI interfaces.

Is CLI command structure included?

Yes, it includes specific checklists for command hierarchies, flag conventions (long/short form), and machine-readable output formats.

API Design Architect

Name: API Design Architect
Author: s-hiraoku

bys-hiraoku

0•

API Development

Standardizes the design of REST, GraphQL, gRPC, and CLI interfaces using industry-best practices and consistency patterns.

The API Design skill enables Claude to function as a specialized technical architect, ensuring your API interfaces are consistent, discoverable, and robust. It provides comprehensive frameworks for designing new endpoints, reviewing existing contracts, and establishing project-wide conventions for naming, status codes, and pagination. By focusing on principles like backward compatibility and minimal surface area, this skill helps developers build scalable services and user-friendly CLI tools that minimize friction for both human users and machine consumers.

Key Features

01Multi-protocol support including REST, GraphQL, gRPC, and CLI

02Automated contract review and consistency checks

030 GitHub stars

04Comprehensive error handling and HTTP status code mapping

05Standardized naming, versioning, and resource nesting conventions

06Strategies for cursor-based and offset-based pagination

Use Cases

01Designing a new RESTful microservice architecture with resource-based routing

02Defining a consistent CLI command structure with standardized flags and JSON output

03Auditing existing API endpoints to ensure backward compatibility and naming consistency

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add s-hiraoku/synapse-a2a api-design

For use in Claude.ai and ChatGPT

Download Skill