SkillProof tested Claude skills

API Gateway

Riferimento AWS API Gateway: ricette CLI REST/HTTP, CORS, autenticazione JWT, risoluzione problemi 502/504

di itsmostafa · itsmostafa/aws-agent-skills

Richiede configurazione ★ 7.2/10

API Gateway — Riferimento AWS API Gateway: ricette CLI REST/HTTP, CORS, autenticazione JWT, risoluzione problemi 502/504

Cosa fa

Una skill di riferimento per Amazon API Gateway che fornisce ricette CLI per API REST e HTTP, un template SAM, la forma del gestore proxy Lambda, la configurazione CORS per entrambi i tipi di API, la configurazione dell'autorizzatore JWT e una sezione di risoluzione dei problemi che copre errori 403, 502, 504 e CORS. Si attiva quando si chiede di creare un'API Gateway, di collegare integrazioni Lambda o servizi AWS, di configurare autorizzatori, di gestire stage e deployment, di aggiungere piani di utilizzo o throttling, o di eseguire il debug di codici di errore di API Gateway. Fa parte del plugin aws-agent-skills, che raggruppa 18 skill di servizi AWS installate insieme.

Rapporto di test

Localizzato skills/api-gateway/SKILL.md tramite l'API di GitHub (343 righe, il frontmatter ha name + description + last_updated 2026-01-07); recuperato a campione integration-patterns.md (HTTP 200) e .claude-plugin/marketplace.json (HTTP 200), che elenca ./skills/api-gateway, quindi il percorso di installazione è derivabile e nessun percorso macchina è hardcoded; la ricerca di curl|sh, base64 -d, eval e testo di iniezione non ha trovato nulla. Frasi trigger che ho giudicato: DOVREBBE — "Set up an HTTP API in front of my Lambda with a Cognito JWT authorizer" (carica), "My API Gateway endpoint returns 502 Bad Gateway, help me debug" (carica), "Add a usage plan and API key throttling to our REST API stage" (carica); NON DOVREBBE — "Add rate limiting middleware to my Express app running on ECS" (salta), "Design a REST API resource naming scheme for our internal service" (salta); 5/5 corretto, l'ancora "AWS API Gateway" impedisce alle frasi altrimenti generiche come "troubleshooting API issues" di attivarsi eccessivamente. Per l'output ho scritto entrambi gli artefatti (apigw-baseline.md vs skillrun.md nello scratchpad) per un task: HTTP API POST /orders supportato da Lambda, autenticazione JWT Cognito, CORS per un'origine. La mia baseline copriva tutti i 6 passaggi necessari per un endpoint funzionante; seguendo rigorosamente il corpo di SKILL.md ne copriva circa 3 — il corpo mostra solo la scorciatoia `create-api --target` e non fornisce mai un esempio di `create-route` o `create-integration` (`create-route` appare solo come una riga in una tabella CLI), non menziona mai `--payload-format-version 2.0`, e `aws lambda add-permission` non appare da nessuna parte in SKILL.md o integration-patterns.md, quindi un seguito letterale distribuisce un'API che restituisce 500. La skill ha aggiunto due cose che la mia baseline ha perso: la decodifica del corpo isBase64Encoded nel gestore e le note 502 "missing statusCode" / 504 29s-vs-30s timeout. Risultato netto pari, quindi 5/10. Documentazione detratta a 3: integration-patterns.md non è mai collegato da SKILL.md quindi la divulgazione progressiva è morta, l'esempio di installazione di Codex del README punta a una skill `rlhf` inesistente in questo repo, e "deep expertise / real-world patterns, edge cases" esagera ciò che è una cheat sheet competente ma incompleta; le affermazioni "18 services" e i controlli settimanali della documentazione sono risultati corretti rispetto all'albero e a .github/workflows/weekly-aws-doc-check.yml.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

  • /api-gatewayRiferimento AWS API Gateway: ricette CLI REST/HTTP, CORS, autenticazione JWT, risoluzione problemi 502/504

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Set up rate limiting on this API Gateway
  • Configure a Lambda integration for this endpoint
  • Troubleshoot this API Gateway 403 error

Rapporto completo →