API Gateway
Referencia de AWS API Gateway: recetas CLI REST/HTTP, CORS, autenticación JWT, solución de problemas 502/504
Funciona con configuración
Qué hace
Una habilidad de referencia para Amazon API Gateway que proporciona recetas CLI para APIs REST y HTTP, una plantilla SAM, forma de manejador proxy de Lambda, configuración CORS para ambos tipos de API, configuración de autorizador JWT y una sección de solución de problemas que cubre fallos 403, 502, 504 y CORS. Se activa cuando se pregunta sobre la creación de una API Gateway API, la conexión de integraciones de Lambda o servicios de AWS, la configuración de autorizadores, la gestión de etapas y despliegues, la adición de planes de uso o limitación, o la depuración de códigos de error de API Gateway. Parte del plugin aws-agent-skills, que agrupa 18 habilidades de servicios de AWS instaladas conjuntamente.
Informe de la prueba
Se encontró skills/api-gateway/SKILL.md a través de la API de GitHub tree (343 líneas, frontmatter tiene name + description + last_updated 2026-01-07); se obtuvo integration-patterns.md (HTTP 200) y .claude-plugin/marketplace.json (HTTP 200), que lista ./skills/api-gateway, por lo que la ruta de instalación es derivable y no hay rutas de máquina codificadas; grep para curl|sh, base64 -d, eval y texto de inyección no encontró nada. Frases de activación que juzgué: DEBERÍA — "Set up an HTTP API in front of my Lambda with a Cognito JWT authorizer" (cargar), "My API Gateway endpoint returns 502 Bad Gateway, help me debug" (cargar), "Add a usage plan and API key throttling to our REST API stage" (cargar); NO DEBERÍA — "Add rate limiting middleware to my Express app running on ECS" (omitir), "Design a REST API resource naming scheme for our internal service" (omitir); 5/5 correcto, el ancla "AWS API Gateway" evita que frases genéricas como "troubleshooting API issues" se activen en exceso. Para la salida, escribí ambos artefactos (apigw-baseline.md vs skillrun.md en scratchpad) para una tarea: HTTP API POST /orders respaldada por Lambda, autenticación JWT de Cognito, CORS para un origen. Mi línea base cubrió los 6 pasos necesarios para un endpoint funcional; seguir estrictamente el cuerpo de SKILL.md cubrió aproximadamente 3 — el cuerpo solo muestra el atajo de creación rápida `create-api --target` y nunca da un ejemplo de `create-route` o `create-integration` (`create-route` aparece solo como una fila de una línea en una tabla CLI), nunca menciona `--payload-format-version 2.0`, y `aws lambda add-permission` no aparece en SKILL.md ni en integration-patterns.md, por lo que un seguimiento literal despliega una API que devuelve 500. La habilidad añadió dos cosas que mi línea base omitió: decodificación del cuerpo isBase64Encoded en el manejador y las notas de tiempo de espera 502 "missing statusCode" / 504 29s-vs-30s. Resultado neto, por lo tanto 5/10. Documentación reducida a 3: integration-patterns.md nunca se enlaza desde SKILL.md, por lo que la divulgación progresiva está muerta, el ejemplo de instalación de Codex del README apunta a una habilidad `rlhf` inexistente en este repositorio, y "deep expertise / real-world patterns, edge cases" exagera lo que es una hoja de trucos competente pero incompleta; las afirmaciones de "18 services" y verificación semanal de documentos sí se verificaron contra el árbol y .github/workflows/weekly-aws-doc-check.yml.
Probado el: 2026-07-21 · Claude Code 2.x (agent harness)
Instalación
git clone --depth 1 https://github.com/itsmostafa/aws-agent-skills.git /tmp/api-gateway-src mkdir -p ~/.claude/skills cp -R /tmp/api-gateway-src/skills/api-gateway ~/.claude/skills/api-gateway # Plugin instead (installs all 18 AWS skills): /plugin marketplace add itsmostafa/aws-agent-skills # then /plugin install aws-agent-skills # The skill body is pure reference text; the AWS CLI is only needed if you run the commands it shows.
Comandos y prompts de ejemplo
/api-gatewayReferencia de AWS API Gateway: recetas CLI REST/HTTP, CORS, autenticación JWT, solución de problemas 502/504
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Set up rate limiting on this API GatewayConfigure a Lambda integration for this endpointTroubleshoot this API Gateway 403 error