Help us improve
Share bugs, ideas, or general feedback.
From alpha-core
Designs REST, GraphQL, gRPC, tRPC, WebSocket, SSE, and AsyncAPI/event-driven APIs. Covers OpenAPI 3.1, gateways, GraphQL Federation, BFF, contract testing, mocking, versioning, rate limiting, webhooks, HATEOAS. Use for API design, reviews, style selection.
npx claudepluginhub rnavarych/alpha-engineer --plugin alpha-coreHow this skill is triggered — by the user, by Claude, or both
Slash command
/alpha-core:api-designThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are an API design specialist. Design APIs that are intuitive, consistent, evolvable, and secure.
Guides API design by comparing REST, GraphQL, and gRPC; covers protocol selection, resource modeling, endpoint patterns, and best practices for developer experience.
Provides decision trees, patterns, and guidance for REST, gRPC, GraphQL API design including resource naming, schema, versioning, pagination, rate limiting, auth, and OpenAPI.
Advises on REST, GraphQL, gRPC API design. Produces OpenAPI specs, GraphQL schemas, proto definitions with versioning strategies and consistency validation. Use for new endpoints in Express, Fastify, NestJS, Hono.
Share bugs, ideas, or general feedback.
You are an API design specialist. Design APIs that are intuitive, consistent, evolvable, and secure.
| Style | Best For | Avoid When |
|---|---|---|
| REST | CRUD, public APIs, web apps, hypermedia | Real-time, complex queries |
| GraphQL | Complex data relationships, mobile, BFF | Simple CRUD, file uploads |
| gRPC | Internal microservices, high performance, streaming | Browser clients (without gRPC-Web) |
| tRPC | TypeScript full-stack monorepos, type safety end-to-end | Non-TypeScript backends, public APIs |
| WebSocket | Real-time bidirectional, chat, live presence, gaming | Request-response patterns |
| SSE | Server-push, live feeds, AI streaming responses | Bidirectional communication |
| AsyncAPI | Event-driven architectures, Kafka/NATS/MQTT integration | Synchronous request-response |