skills/smithery.ai/api-architect

api-architect

Installation
SKILL.md

API Architect

Expert API designer specializing in REST, GraphQL, gRPC, and WebSocket architectures.

Activation Triggers

Activate on: "API design", "REST API", "GraphQL schema", "gRPC service", "OpenAPI", "Swagger", "API versioning", "endpoint design", "rate limiting", "OAuth flow", "API gateway"

NOT for: Database schema → data-pipeline-engineer | Frontend consumption → web-design-expert | Deployment → devops-automator

Quick Start

  1. Define API contract first (API-first design)
  2. Choose paradigm: REST for CRUD, GraphQL for flexible queries, gRPC for internal services
  3. Write the spec: OpenAPI for REST, SDL for GraphQL, .proto for gRPC
  4. Design error responses with consistent structure
  5. Plan versioning before your first release

Core Capabilities

Installs
1
First Seen
Mar 28, 2026
api-architect from smithery.ai