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.

48 stars 10 forksSoftware Development Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add sethdford/claude-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sethdford/claude-skills --skill api-gateway-design
Manual install
git 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-design

Personal 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.
Read the full skill on GitHub

Details

Skill name
api-gateway-design
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

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.