api-gateway-patterns · nickcrew — скилл для Claude Code
Скилл api-gateway-patterns для проектирования API-шлюзов в микросервисных архитектурах: маршрутизация, аутентификация, rate limiting, композиция запросов.
MIT 101 установок ★ 71 обновлён 2026-06-29
npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/api-gateway-patterns/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/api-gateway-patterns/
1Через Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a codex2Вручную: положить файлы
.agents/skills/api-gateway-patterns/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a cursor2Вручную: положить файлы
.cursor/skills/api-gateway-patterns/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install NickCrew/Claude-Cortex skills/api-gateway-patterns2Вручную: положить файлы
.github/skills/api-gateway-patterns/SKILL.md1Через Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a gemini-cli2Командой платформы
gemini skills install https://github.com/NickCrew/Claude-Cortex --path skills/api-gateway-patternsВручную: положить файлы
.devin/skills/api-gateway-patterns/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add NickCrew/Claude-Cortex --skill api-gateway-patterns -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.