creating-api-gateway-stage — скилл для Claude Code: стадии API Gateway
Создаёт стадию API Gateway с логированием в CloudWatch, трассировкой X-Ray, троттлингом и WAF. Нужен при выкатке REST API в dev, test или production.
npx skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage -a claude-codeЧто делает creating-api-gateway-stage
Скилл даёт агенту процедуру создания стадии API Gateway: логирование в CloudWatch, трассировка X-Ray, троттлинг, привязка WAF web ACL, настройка на уровне методов и варианты авторизации. Внутри — файл SKILL.md и справочник references/create-api-gateway-stage.md, где расписан порядок шагов. Агент читает его и ведёт вас по процедуре, а не собирает стадию наугад.
Логирование включается и на стадии, и на уровне методов. Если логи в CloudWatch не появились, проверяют права роли CloudWatch, существование лог-группы и оба уровня настройки. Создание стадии падает из-за неверного REST API ID, deployment ID, нехватки прав IAM или имени стадии, не проходящего по соглашениям AWS.
WAF иногда режет легитимные запросы. Тогда смотрят логи WAF, правят правила или добавляют исключения; для проверки есть режим count. Скилл рассчитан на работу с реальным аккаунтом AWS, поэтому права IAM и идентификаторы API понадобятся заранее.
Какие задачи решает
- создать стадию API Gateway с логированием и трассировкой
- развести dev, test и production по отдельным стадиям
- подключить WAF web ACL к REST API
- настроить троттлинг на уровне методов
- разобраться, почему не пишутся логи CloudWatch
Примеры запросов агенту
- Создай стадию API Gateway для production с логированием в CloudWatch и трассировкой X-Ray
- Почему для моей стадии не появляются логи в CloudWatch?
- WAF блокирует легитимные запросы к API — что поправить?
Как установить creating-api-gateway-stage
1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage -a claude-code2Вручную: положить файлы
~/.claude/skills/creating-api-gateway-stage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/creating-api-gateway-stage/
1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage -a codex2Вручную: положить файлы
.agents/skills/creating-api-gateway-stage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage -a cursor2Вручную: положить файлы
.cursor/skills/creating-api-gateway-stage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install aws/agent-toolkit-for-aws creating-api-gateway-stage2Вручную: положить файлы
.github/skills/creating-api-gateway-stage/SKILL.md1Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage -a gemini-cli2Командой платформы
gemini skills install https://github.com/aws/agent-toolkit-for-aws --path skills/specialized-skills/serverless-skills/creating-api-gateway-stageВручную: положить файлы
.devin/skills/creating-api-gateway-stage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Из того же набора133
Похожие
Рядом в теме «Облака: AWS, Azure, GCP»
Всё по теме «Облака: AWS, Azure, GCP» →Вопросы о creating-api-gateway-stage
Как установить creating-api-gateway-stage в Claude Code?
Выполните npx skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage -a claude-code. Скилл окажется в ~/.claude/skills/creating-api-gateway-stage/SKILL.md.
Что делает creating-api-gateway-stage?
Проводит агента по созданию стадии API Gateway: логирование в CloudWatch, трассировка X-Ray, троттлинг, WAF и IAM-роли. Плюс разбор типовых сбоев — пропавшие логи, ошибки создания стадии, блокировки WAF.
Что нужно, чтобы скилл сработал?
Доступ к аккаунту AWS с правами IAM на API Gateway и CloudWatch, а также REST API ID и deployment ID. Без них создание стадии упадёт.
Исходный текст
SKILL.md · Apache-2.0
--- name: creating-api-gateway-stage description: Creates an API Gateway stage with CloudWatch logging, X-Ray tracing, throttling, WAF integration, and IAM roles following AWS best practices. Use when deploying a REST API to different environments such as dev, test, or production. version: 1 --- # Creating an API Gateway Stage ## Overview Domain expertise for creating and configuring API Gateway stages with comprehensive logging, monitoring, security, and throttling controls. Covers CloudWatch logging setup, X-Ray tracing, WAF web ACL association, method-level configuration, and authorization options. ## Create an API Gateway stage To create a fully configured API Gateway stage with logging, throttling, WAF, and authorization, follow the procedure exactly. See [API Gateway stage creation procedure](references/create-api-gateway-stage.md). ## Troubleshooting ### CloudWatch logs not appearing Verify the CloudWatch role permissions, log group existence, and that logging is enabled at both stage and method levels. See the [full procedure](references/create-api-gateway-stage.md) for details. ### Stage creation fails Check REST API ID, deployment ID, IAM permissions, and stage naming conventions. ### WAF blocking legitimate requests Review WAF logs, adjust rules or add exceptions, and consider count mode for testing.
© aws · Apache-2.0 · aws/agent-toolkit-for-aws
