β³ This skill is pending AI review.
Scores will appear once the review pipeline completes.
api-gateway
AWS API Gateway for REST and HTTP API management. Use when creating APIs, configuring integrations, setting up authorization, managing stages, implementing rate limiting, or troubleshooting API issues.
Choose how to use this skill
You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.
1. Native installer
This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.
Do not guess an installer command or replace an existing version without reviewing the diff.
2. Complete package recommended
Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.
No complete ProSkills package is published for this listing yet.3. Prompt-only
Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.
Need only the instruction file?
Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.
No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.
// RATINGS
Not yet listed on ClawHub or SkillsMP
// README
AWS Agent Skills
Supercharge Claude Code with AWS cloud engineering skills across 18 core AWS services.
π Why AWS Agent Skills?
Developing AWS solutions is complex spanning IAM, compute, storage, security, serverless, networking, and more.
AWS Agent Skills equips Claude Code (and Codex) with deep expertise across 18 AWS domains, enabling automated cloud engineering support from IaC templates to debugging guidance and security best practices.
Automatically checks AWS documentation for updates on a weekly basis to ensure skills stay current with AWS service changes.
Why not just use an MCP?
AWS MCP is great for live docs and API calls, but AWS Agent Skills is designed for reasoning first. It gives AI Agents a curated, LLM-optimized AWS knowledge base with real-world patterns, edge cases, and best practices, without streaming large docs or schemas. Because the skills are local and pre compressed, it is far more token efficient, keeps the context window small and predictable, and avoids MCP infrastructure, latency, and expanded credential exposure.
Installation
Claude Code
From Marketplace
# Add the marketplace
/plugin marketplace add itsmostafa/aws-agent-skills
# Install the plugin
/plugin install aws-agent-skills
From GitHub
/plugin install https://github.com/itsmostafa/aws-agent-skills
Local Development
/plugin install ./path/to/aws-agent-skills
Codex CLI
# Add the marketplace
codex plugin marketplace add itsmostafa/aws-agent-skills
# Install the plugin
codex plugin add aws-agent-skills@aws-agent-skills
# Verify
codex plugin list -m aws-agent-skills
To pull the latest skills later:
codex plugin marketplace upgrade aws-agent-skills
To uninstall:
codex plugin remove aws-agent-skills@aws-agent-skills
codex plugin marketplace remove aws-agent-skills
Available Skills
| Skill | Description |
|---|---|
| iam | Identity and Access Management - users, roles, policies, permissions |
| lambda | Serverless functions - deployment, triggers, debugging |
| dynamodb | NoSQL database - table design, queries, indexes |
| s3 | Object storage - buckets, objects, security, lifecycle |
| api-gateway | REST and HTTP APIs - integrations, authorization |
| ec2 | Virtual machines - instances, AMIs, networking |
| ecs | Container orchestration - clusters, services, tasks |
| eks | Kubernetes - clusters, node groups, IRSA |
| cloudformation | Infrastructure as Code - templates, stacks, drift |
| cloudwatch | Monitoring - logs, metrics, alarms, dashboards |
| rds | Relational databases - instances, backups, replication |
| sqs | Message queues - standard, FIFO, dead-letter queues |
| sns | Notifications - topics, subscriptions, filtering |
| cognito | User authentication - user pools, identity pools, OAuth |
| step-functions | Workflow orchestration - state machines, error handling |
| secrets-manager | Secret storage - rotation, versioning, RDS integration |
| eventbridge | Event bus - rules, patterns, cross-account events |
| bedrock | Foundation models - inference, RAG, custom models |
Usage Examples
IAM Policy Creation
Ask Claude to help with IAM:
- "Create an IAM policy for Lambda to access DynamoDB"
- "Set up cross-account access for S3"
- "Debug this access denied error"
Lambda Development
- "Create a Python Lambda function triggered by S3"
- "Debug my Lambda timeout issues"
- "Set up Lambda with VPC access"
Infrastructure as Code
- "Write a CloudFormation template for a serverless API"
- "Create an ECS Fargate service with load balancer"
- "Set up EventBridge rules for scheduled tasks"
Skill Structure
Each skill contains:
SKILL.md- Core concepts, patterns, CLI reference, best practices, troubleshooting- Supplementary files - Deep dives into specific topics
Skills include metadata showing when content was last updated, so you always know how current the information is.
Contributing
- Fork this repository
- Create a feature branch
- Add or update skills, following the structure of the existing ones
- Submit a pull request
License
MIT License - see LICENSE for details.
// HOW IT'S BUILT
// FILES
2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.
skills/api-gateway/SKILL.md7.8 KBupstream β
--- name: api-gateway description: AWS API Gateway for REST and HTTP API management. Use when creating APIs, configuring integrations, setting up authorization, managing stages, implementing rate limiting, or troubleshooting API issues. last_updated: "2026-01-07" doc_source: https://docs.aws.amazon.com/apigateway/latest/developerguide/ --- # AWS API Gateway Amazon API Gateway is a fully managed service for creating, publishing, and securing APIs at any scale. Supports REST APIs, HTTP APIs, and WebSocket APIs. ## Table of Contents - [Core Concepts](#core-concepts) - [Common Patterns](#common-patterns) - [CLI Reference](#cli-reference) - [Best Practices](#best-practices) - [Troubleshooting](#troubleshooting) - [References](#references) ## Core Concepts ### API Types | Type | Description | Use Case | |------|-------------|----------| | **HTTP API** | Low-latency, cost-effective | Simple APIs, Lambda proxy | | **REST API** | Full-featured, more control | Complex APIs, transformation | | **WebSocket API** | Bidirectional communication | Real-time apps, chat | ### Key Components - **Resources**: URL paths (/users, /orders/{id}) - **Methods**: HTTP verbs (GET, POST, PUT, DELETE) - **Integrations**: Backend connections (Lambda, HTTP, AWS services) - **Stages**: Deployment environments (dev, prod) ### Integration Types | Type | Description | |------|-------------| | **Lambda Proxy** | Pass-through to Lambda (recommended) | | **Lambda Custom** | Transform request/response | | **HTTP Proxy** | Pass-through to HTTP endpoint | | **AWS Service** | Direct integration with AWS services | | **Mock** | Return static response | ## Common Patterns ### Create HTTP API with Lambda **AWS CLI:** ```bash # Create HTTP API aws apigatewayv2 create-api \ --name my-api \ --protocol-type HTTP \ --target arn:aws:lambda:us-east-1:123456789012:function:MyFunction # Get API endpoint aws apigatewayv2 get-api --api-id abc123 --query 'ApiEndpoint' ``` **SAM Template:** ```yaml AWSTemplateFormatVersion: '2010-09-09' Transform: AWS::Serverless-2016-10-31 Resources: MyApi: Type: AWS::Serverless::HttpApi Properties: StageName: prod MyFunction: Type: AWS::Serverless::Function Properties: Handler: app.handler Runtime: python3.12 Events: ApiEvent: Type: HttpApi Properties: ApiId: !Ref MyApi Path: /items Method: GET ``` ### Create REST API with Lambda Proxy ```bash # Create REST API aws apigateway create-rest-api \ --name my-rest-api \ --endpoint-configuration types=REGIONAL API_ID=abc123 # Get root resource ID ROOT_ID=$(aws apigateway get-resources --rest-api-id $API_ID --query 'items[0].id' --output text) # Create resource aws apigateway create-resource \ --rest-api-id $API_ID \ --parent-id $ROOT_ID \ --path-part items RESOURCE_ID=xyz789 # Create method aws apigateway put-method \ --rest-api-id $API_ID \ --resource-id $RESOURCE_ID \ --http-method GET \ --authorization-type NONE # Create Lambda integration aws apigateway put-integration \ --rest-api-id $API_ID \ --resource-id $RESOURCE_ID \ --http-method GET \ --type AWS_PROXY \ --integration-http-method POST \ --uri arn:aws:apigateway:us-east-1:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-1:123456789012:function:MyFunction/invocations # Deploy to stage aws apigateway create-deployment \ --rest-api-id $API_ID \ --stage-name prod ``` ### Lambda Handler for API Gateway ```python import json def handler(event, context): # HTTP API event http_method = event.get('requestContext', {}).get('http', {}).get('method') path = event.get('rawPath', '') query_params = event.get('queryStringParameters', {}) body = event.get('body', '') if body and event.get('isBase64Encoded'): import base64 body = base64.b64decode(body).decode('utf-8') # Process request response_body = {'message': 'Success', 'path': path} return { 'statusCode': 200, 'headers': { 'Content-Type': 'application/json' }, 'body': json.dumps(response_body) } ``` ### Configure CORS **HTTP API:** ```bash aws apigatewayv2 update-api \ --api-id abc123 \ --cors-configuration '{ "AllowOrigins": ["https://example.com"], "AllowMethods": ["GET", "POST", "PUT", "DELETE"], "AllowHeaders": ["Content-Type", "Authorization"], "MaxAge": 86400 }' ``` **REST API:** ```bash # Enable CORS on resource aws apigateway put-method \ --rest-api-id $API_ID \ --resource-id $RESOURCE_ID \ --http-method OPTIONS \ --authorization-type NONE aws apigateway put-integration \ --rest-api-id $API_ID \ --resource-id $RESOURCE_ID \ --http-method OPTIONS \ --type MOCK \ --request-templates '{"application/json": "{\"statusCode\": 200}"}' aws apigateway put-method-response \ --rest-api-id $API_ID \ --resource-id $RESOURCE_ID \ --http-method OPTIONS \ --status-code 200 \ --response-parameters '{ "method.response.header.Access-Control-Allow-Headers": true, "method.response.header.Access-Control-Allow-Methods": true, "method.response.header.Access-Control-Allow-Origin": true }' aws apigateway put-integration-response \ --rest-api-id $API_ID \ --resource-id $RESOURCE_ID \ --http-method OPTIONS \ --status-code 200 \ --response-parameters '{ "method.response.header.Access-Control-Allow-Headers": "'\''Content-Type,Authorization'\''", "method.response.header.Access-Control-Allow-Methods": "'\''GET,POST,PUT,DELETE,OPTIONS'\''", "method.response.header.Access-Control-Allow-Origin": "'\''*'\''" }' ``` ### JWT Authorization (HTTP API) ```bash aws apigatewayv2 create-authorizer \ --api-id abc123 \ --name jwt-authorizer \ --authorizer-type JWT \ --identity-source '$request.header.Authorization' \ --jwt-configuration '{ "Issuer": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_abc123", "Audience": ["client-id"] }' ``` ## CLI Reference ### HTTP API (apigatewayv2) | Command | Description | |---------|-------------| | `aws apigatewayv2 create-api` | Create API | | `aws apigatewayv2 get-apis` | List APIs | | `aws apigatewayv2 create-route` | Create route | | `aws apigatewayv2 create-integration` | Create integration | | `aws apigatewayv2 create-stage` | Create stage | | `aws apigatewayv2 create-authorizer` | Create authorizer | ### REST API (apigateway) | Command | Description | |---------|-------------| | `aws apigateway create-rest-api` | Create API | | `aws apigateway get-rest-apis` | List APIs | | `aws apigateway create-resource` | Create resource | | `aws apigateway put-method` | Create method | | `aws apigateway put-integration` | Create integration | | `aws apigateway create-deployment` | Deploy API | ## Best Practices ### Performance - **Use HTTP APIs** for simple use cases (70% cheaper, lower latency) - **Enable caching** for REST APIs - **Use regional endpoints** unless global distribution needed - **Implement pagination** for list endpoints ### Security - **Use authorization** on all endpoints - **Enable WAF** for REST APIs - **Use API keys** for rate limiting (not authentication) - **Enable access logging** - **Use HTTPS only** ### Reliability - **Set up throttling** to protect backends - **Configure timeout** appropriately - **Use canary deployments** for updates - **Monitor with CloudWatch** ## Troubleshooting ### 403 Forbidden **Causes:** - Missing authorization - Invalid API key - WAF blocking - Resource policy denying **Debug:** ```bash # Check API key aws apigateway get-api-key --api-key abc123 --include-value # Check authorizer aws apigatewayv2 get-authorizer --api-id abc123 --authorizer-id xyz789 ``` ### 502 Bad Gateway **Causes:** - Lambda error - Integration timeout - Invalid response format **Lambda response format:** ```python # Correct format return { 'statusCode': 200, 'headers': {'ContentREADME.mdupstream β
Contents are not inlined in the catalog. Open the upstream file.
Plain-text copy, no login: /skill-bundles/itsmostafa-aws-agent-skills-skills-api-gateway.md