Creating Api Gateway Stage

This handles the full setup of an API Gateway stage with all the production-ready bits you'd normally have to piece together from multiple AWS docs. It covers CloudWatch logging with proper IAM roles, X-Ray tracing, throttling limits, WAF integration, and method-level authorization configuration. You'd reach for this when promoting a REST API through dev, test, or prod environments and want everything configured correctly the first time. The troubleshooting section is helpful since CloudWatch logging permissions are easy to mess up. It follows AWS best practices, which means you won't have to refactor security or monitoring settings later when someone asks why there's no audit trail.

skills.sh installs: 6.7K
GitHub stars: 3.4K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add aws/agent-toolkit-for-aws --skill creating-api-gateway-stage --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

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 for details.