API Gateway Design
Design API gateways that route, authenticate, rate-limit, and aggregate backend services. Use when building client-facing APIs or managing service boundaries.
Install
/plugin marketplace add sethdford/claude-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add sethdford/claude-skills --skill api-gateway-designgit clone --depth 1 https://github.com/sethdford/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/architect/system-design/skills/api-gateway-design ~/.claude/skills/api-gateway-designPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# API Gateway Design Design robust API gateways that handle authentication, rate limiting, routing, and response aggregation for backend services. ## Context You are designing an API layer. The user is building client-facing APIs, managing multiple backends, or handling cross-cutting concerns like auth and rate limiting. Read their current API structure. ## Domain Context Based on Sam Newman's API Gateway pattern and Kong/AWS API Gateway reference implementations: - **Reverse Proxy**: Single entry point routing to multiple backends - **Protocol Translation**: GraphQL ↔ REST, REST ↔ gRPC - **Authentication Gateway**: Centralized JWT validation, OAuth2 token exchange - **Rate Limiting**: Per-user, per-API, per-IP rate limits with backpressure - **Response Aggregation**: Fan-out to multiple backends, merge responses (avoid N+1 problems) ## Instructions 1. **Define Gateway Responsibilities**: What should the gateway do? - Route requests to backends - Authenticate and authorize - Rate limit and throttle - Aggregate responses - Transform requests/responses (JSON ↔ Protocol Buffers) 2. **Design Routing Rules**: Map API paths to backend services. Example: ``` /api/users/* → user-service /api/orders/* → order-service /api/inventory/* → inventory-service ``` 3. **Implement Authentication**: Centralize JWT validation or OAuth2 token exchange. Avoid pushing auth to every backend. Include refresh token handling.
Details
- Skill name
api-gateway-design- Repository
- sethdford/claude-skills
- Path
architect/system-design/skills/api-gateway-design/SKILL.md- License
- MIT
- Repo updated
- 11 March 2026
FAQ
What does the API Gateway Design skill do?
Design API gateways that route, authenticate, rate-limit, and aggregate backend services. Use when building client-facing APIs or managing service boundaries.
How do I install the API Gateway Design skill?
Claude Code plugin: /plugin marketplace add sethdford/claude-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is API Gateway Design popular?
It lives in sethdford/claude-skills, which has 48 GitHub stars and 10 forks.
Related skills
A B Test Design
48sethdford/claude-skills
Design rigorous A/B tests with hypotheses, variants, metrics, and sample size calculations.
A B Test Design Pm
48sethdford/claude-skills
Analytics and experimentation skill for product managers.
Abuse Case Design
48sethdford/claude-skills
Design abuse cases (negative use cases) showing how attackers misuse system features. Use when identifying attacks that exploit intended functionality or business logic flaws.
API Mock Strategy
48sethdford/claude-skills
Expert approach to api-mock-strategy in API testing. Use when working with .
API Error Handling
48sethdford/claude-skills
HTTP status codes, error response formats, recovery guidance, and client error handling.
API Regression Suite
48sethdford/claude-skills
Expert approach to api-regression-suite in API testing. Use when working with .
Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.