К основному содержанию
скилл CX Codex

api-gateway-patterns · nickcrew — скилл для Claude Code

Скилл api-gateway-patterns для проектирования API-шлюзов в микросервисных архитектурах: маршрутизация, аутентификация, rate limiting, композиция запросов.

MIT 101 установок ★ 71 обновлён 2026-06-29

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a claude-code
Открыть на GitHub

Что делает api-gateway-patterns

Скилл даёт справочники и чеклисты для внедрения API-шлюзов (Kong, Nginx, Envoy, AWS API Gateway) и паттерна Backend for Frontend. Покрывает маршрутизацию по пути и заголовкам, централизованную аутентификацию (JWT, OAuth, RBAC), управление трафиком (circuit breakers, retry logic), композицию и агрегацию вызовов к сервисам. Включает референсы для service discovery, трансформации запросов, настройки observability.

Работает в проектах с файлами **/*.http, **/openapi.*, **/swagger.*, **/api/**, **/services/**, **/microservice/** и **/service/**/handlers/**. Автор советует держать шлюз лёгким: сложную бизнес-логику делегировать сервисам, а на шлюзе решать только маршрутизацию, безопасность и кросс-cutting concerns вроде логирования.

Какие задачи решает

  • спроектировать BFF-слой под мобильное, веб- и админ-приложение
  • настроить JWT-валидацию и API-ключи на уровне шлюза
  • внедрить rate limiting и circuit breakers для защиты сервисов от перегрузки
  • агрегировать несколько вызовов к бэкендам в единый ответ клиенту
  • интегрировать service discovery и динамическую маршрутизацию

Примеры запросов агенту

  • Загрузи референс по паттернам маршрутизации skills/api-gateway-patterns/references/routing-patterns.md и предложи схему для трёх типов клиентов
  • Покажи пример конфига Kong для JWT-аутентификации с RBAC по референсу skills/api-gateway-patterns/references/authentication.md
  • Подскажи стратегию rate limiting для публичного API — загрузи skills/api-gateway-patterns/references/traffic-management.md

Как установить api-gateway-patterns

1Через Skills CLI (Vercel)

npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a claude-code

2Вручную: положить файлы

~/.claude/skills/api-gateway-patterns/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/api-gateway-patterns/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об api-gateway-patterns

Как установить api-gateway-patterns в Claude Code?

Выполни npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a claude-code, скилл появится в ~/.claude/skills/api-gateway-patterns/SKILL.md.

Что делает скилл api-gateway-patterns?

Даёт референсы для проектирования API-шлюзов: маршрутизацию, аутентификацию, rate limiting, композицию запросов, интеграцию с service discovery. Подходит для микросервисных архитектур с Kong, Nginx, Envoy, AWS API Gateway.

Какие файлы активируют скилл api-gateway-patterns?

Скилл включается в проектах с **/*.http, **/openapi.*, **/swagger.*, **/api/**, **/services/**, **/microservice/** и **/service/**/handlers/**.

Исходный текст

SKILL.md · MIT
---
name: api-gateway-patterns
description: API Gateway patterns for routing, authentication, rate limiting, and service composition in microservices architectures. Use when implementing API gateways, building BFF layers, or managing service-to-service communication at scale.
keywords:
  - API gateway
  - BFF
  - Kong
  - Nginx
  - backend for frontend
  - gateway pattern
  - load balancing
  - rate limiting
  - request routing
  - reverse proxy
file_patterns:
  - '**/*.http'
  - '**/api/**'
  - '**/microservice/**'
  - '**/openapi.*'
  - '**/service/**/handlers/**'
  - '**/services/**'
  - '**/swagger.*'
confidence: 0.8
---

# API Gateway Patterns

Expert guidance for implementing API gateways with routing, authentication, traffic management, and service composition patterns for microservices architectures at scale.

## When to Use This Skill

- Implementing API gateway infrastructure for microservices
- Designing Backend for Frontend (BFF) layers
- Adding authentication and authorization at the gateway level
- Implementing rate limiting, circuit breakers, and retry logic
- Setting up service discovery and dynamic routing
- Building API composition and aggregation layers
- Managing cross-cutting concerns (logging, monitoring, CORS)
- Evaluating gateway solutions (Kong, Nginx, Envoy, AWS API Gateway)

## Core Concepts

### Gateway Responsibilities
**Routing**: Direct requests to appropriate backend services based on path, headers, or host
**Security**: Centralized authentication, authorization, and API key validation
**Traffic Management**: Rate limiting, circuit breakers, retry logic
**Composition**: Aggregate multiple service calls into unified responses
**Transformation**: Modify requests/responses for client optimization or legacy adaptation

### Architecture Patterns
**Single Gateway**: One gateway for all clients (simple, potential bottleneck)
**BFF Pattern**: Separate gateway per client type (mobile, web, admin) - optimized for each
**GraphQL Gateway**: Schema stitching across services, client-driven data fetching
**Service Mesh**: Distributed gateway pattern with sidecar proxies (Istio, Linkerd)

## Quick Reference

| Task | Load reference |
| --- | --- |
| Routing strategies (path, header, host-based) | `skills/api-gateway-patterns/references/routing-patterns.md` |
| Request/response transformation | `skills/api-gateway-patterns/references/transformation.md` |
| API composition and aggregation | `skills/api-gateway-patterns/references/composition.md` |
| Authentication & authorization (JWT, OAuth, RBAC) | `skills/api-gateway-patterns/references/authentication.md` |
| Traffic management (rate limiting, circuit breakers) | `skills/api-gateway-patterns/references/traffic-management.md` |
| Backend for Frontend (BFF) pattern | `skills/api-gateway-patterns/references/bff-pattern.md` |
| Service discovery integration | `skills/api-gateway-patterns/references/service-discovery.md` |
| Gateway implementations (Kong, Nginx, Envoy, AWS) | `skills/api-gateway-patterns/references/implementations.md` |

## Implementation Workflow

### Phase 1: Requirements Analysis
1. **Identify client types**: Mobile, web, admin, partners
2. **Map service landscape**: Catalog backend services and endpoints
3. **Define cross-cutting concerns**: Auth, logging, monitoring, CORS
4. **Determine composition needs**: Which endpoints require aggregation?
5. **Establish SLAs**: Latency, throughput, availability targets

### Phase 2: Gateway Design
1. **Choose architecture**: Single gateway vs BFF vs GraphQL
2. **Select implementation**: Kong, Nginx, Envoy, AWS API Gateway
3. **Design routing rules**: Path-based, header-based, host-based
4. **Plan authentication**: JWT, OAuth 2.0, API keys, or hybrid
5. **Define traffic policies**: Rate limits, circuit breakers, timeouts

### Phase 3: Implementation
1. **Set up infrastructure**: Deploy gateway instances, configure load balancer
2. **Implement routing**: Configure service discovery and route definitions
3. **Add authentication**: JWT validation, OAuth integration, API key management
4. **Apply traffic management**: Rate limiting, circuit breakers, retry logic
5. **Enable observability**: Distributed tracing, metrics, structured logging

### Phase 4: Testing & Optimization
1. **Load testing**: Verify performance under expected and peak load
2. **Failure injection**: Test circuit breakers and retry logic
3. **Security testing**: Verify auth flows, token validation, RBAC policies
4. **Latency optimization**: Cache strategies, connection pooling
5. **Monitor and tune**: Adjust timeouts, limits based on real traffic

## Best Practices

1. **Centralize Cross-Cutting Concerns**: Authentication, logging, monitoring at gateway
2. **Keep Gateway Lightweight**: Avoid complex business logic, delegate to services
3. **Implement Health Checks**: Monitor upstream service health, remove unhealthy instances
4. **Use Circuit Breakers**: Prevent cascading failures, fail fast
5. **Apply Rate Limiting**: Protect services from overload, implement tiered limits
6. **Enable Observability**: Distributed tracing, metrics, structured logging
7. **Version APIs**: Support multiple API versions, plan deprecation
8. **Secure Communication**: TLS everywhere, mutual TLS for service-to-service
9. **Cache Strategically**: Response caching, but invalidate properly
10. **Test Resilience**: Chaos engineering, failure injection, load testing

## Common Mistakes

1. **Business Logic in Gateway**: Keep gateway focused on routing/security, not business rules
2. **Chatty Composition**: Too many upstream calls (use BFF, GraphQL, or caching)
3. **Single Point of Failure**: Deploy redundantly, use load balancers
4. **No Timeout Configuration**: Always set connection/read timeouts to prevent hanging requests
5. **Ignoring Backpressure**: Implement queue limits, graceful degradation
6. **Over-Aggregation**: Don't make gateway do too much work (compute-heavy transformations)
7. **Inadequate Monitoring**: Must track latency, errors, throughput at gateway level
8. **No Rate Limiting**: Services will be overwhelmed eventually without protection
9. **Synchronous Everything**: Use async patterns for non-critical operations
10. **No Version Strategy**: Breaking changes break all clients simultaneously

## Resources

- **Kong**: https://docs.konghq.com/gateway/latest/
- **Nginx**: https://nginx.org/en/docs/
- **Envoy**: https://www.envoyproxy.io/docs/envoy/latest/
- **AWS API Gateway**: https://docs.aws.amazon.com/apigateway/
- **Patterns**: "Microservices Patterns" by Chris Richardson
- **Service Mesh**: https://istio.io/latest/docs/
- **Circuit Breakers**: Martin Fowler's CircuitBreaker pattern
- **BFF Pattern**: Sam Newman's "Building Microservices"

© NickCrew · MIT · NickCrew/Claude-Cortex

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →

Сначала — api-gateway-patterns от других авторов.

api-gateway-patterns manutej Скилл api-gateway-patterns для Claude Code помогает проектировать API-шлюзы на Kong. Он подключается к задачам с маршрутизацией запросов, аутентификацией и управлением трафиком. CX Codex +1 482установок api-gateway-configuration aj-geddes Скилл api-gateway-configuration для Claude Code конфигурирует API-шлюзы, авторизацию и лимиты запросов. Включается при развёртывании микросервисов и обратных прокси. CX Codex +1 509установок analyzing-api-gateway-access-logs mahipal Скилл analyzing-api-gateway-access-logs разбирает логи API Gateway и ищет признаки BOLA/IDOR, обхода лимитов, перебора учётных данных и инъекций. CX Codex +1 795установок connecting-lambda-to-api-gateway aws Скилл connecting-lambda-to-api-gateway проводит агента по шагам подключения существующей Lambda к Amazon API Gateway: ресурсы, методы, прокси-интеграция, права и деплой. CX Codex +1 7 400установок creating-api-gateway-stage aws Скилл creating-api-gateway-stage для Claude Code создаёт стейдж API Gateway с CloudWatch-логами, X-Ray, WAF и IAM-ролями для деплоя REST API в dev, test и production. CX Codex +1 7 100установок api-gateway-backend-security-and-rate-limiting официальный google Скилл api-gateway-backend-security-and-rate-limiting для Claude Code, Gemini CLI и Codex настраивает аутентификацию клиентов и бэкенда, а также квоты запросов в Google Cloud API Gateway, включая шлюзы с MCP. CX Codex +1 360установок alibabacloud-nginx-ingress-to-api-gateway aliyun Скилл alibabacloud-nginx-ingress-to-api-gateway переносит Kubernetes nginx Ingress в Alibaba Cloud API Gateway. Анализирует YAML локально, классифицирует аннотации, генерирует конфигурацию Higress и отчёт о миграции. CX Codex +1 152установок

Из того же набора21

Весь набор →
event-driven-architecture Скилл event-driven-architecture для Claude Code помогает проектировать системы на событиях: event sourcing, CQRS, саги и обмен сообщениями. Охватывает микросервисы и распределённые транзакции. CX Codex +1 118установок dashboard-designer Скилл dashboard-designer для Claude Code помогает спроектировать дашборд: выбрать KPI, расположить блоки и настроить визуальную иерархию. Запускается на запросы о структуре панели мониторинга или выборе BI-инструмента. CX Codex +1 109установок terraform-best-practices Скилл terraform-best-practices внедряет инженерные стандарты Terraform: разбиение на модули, блокировку стейта, разделение сред и валидацию в CI/CD. CX Codex +1 109установок mermaid-diagramming Скилл mermaid-diagramming учит агента рисовать диаграммы Mermaid: блок-схемы, sequence-диаграммы, ERD, состояния, Gantt и архитектурные виды, отдельно базовую и стилизованную версию. CX Codex +1 105установок kubernetes-security-policies Скилл kubernetes-security-policies для Claude Code помогает настроить Pod Security Standards, сетевые политики и RBAC в Kubernetes. Ужесточает защиту прод-окружения. CX Codex +1 104установок user-journey-mapping Скилл user-journey-mapping для Claude Code помогает составить карту пути пользователя с этапами, точками контакта, эмоциями и проблемами. Запускается при анализе пользовательского опыта или конверсии. CX Codex +1 102установок tutorial-design Скилл tutorial-design помогает проектировать пошаговые туториалы, воркшопы и практические руководства с контрольными точками и разбором частых ошибок. CX Codex +1 102установок requirements-discovery Скилл requirements-discovery для Claude Code помогает собирать требования, определять границы проекта и готовить PRD. Запускается при обсуждении новой функции, интервью со стейкхолдерами или проверке спецификации. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой