SkillProof tested Claude skills

API Gateway

Référence AWS API Gateway : recettes CLI REST/HTTP, CORS, authentification JWT, dépannage 502/504

par itsmostafa · itsmostafa/aws-agent-skills

Fonctionne avec configuration ★ 7.2/10

API Gateway — Référence AWS API Gateway : recettes CLI REST/HTTP, CORS, authentification JWT, dépannage 502/504

Ce que fait

Une compétence de référence pour Amazon API Gateway qui fournit des recettes CLI pour les API REST et HTTP, un modèle SAM, la forme du gestionnaire de proxy Lambda, la configuration CORS pour les deux types d'API, la configuration d'un autorisateur JWT et une section de dépannage couvrant les erreurs 403, 502, 504 et les échecs CORS. Elle se déclenche lorsque vous posez des questions sur la création d'une API Gateway, le câblage d'intégrations Lambda ou de services AWS, la configuration d'autorisateurs, la gestion des étapes et des déploiements, l'ajout de plans d'utilisation ou de limitation, ou le débogage des codes d'erreur API Gateway. Fait partie du plugin aws-agent-skills, qui regroupe 18 compétences de services AWS installées ensemble.

Rapport de test

SKILL.md localisé via l'API GitHub tree (343 lignes, frontmatter contient name + description + last_updated 2026-01-07) ; integration-patterns.md (HTTP 200) et .claude-plugin/marketplace.json (HTTP 200) vérifiés ponctuellement, ce dernier listant ./skills/api-gateway, donc le chemin d'installation est dérivable et aucun chemin machine n'est codé en dur ; grep pour curl|sh, base64 -d, eval et texte d'injection n'a rien trouvé. Phrases de déclenchement jugées : DEVRAIT — "Mettre en place une API HTTP devant ma Lambda avec un autorisateur JWT Cognito" (charger), "Mon point de terminaison API Gateway renvoie 502 Bad Gateway, aidez-moi à déboguer" (charger), "Ajouter un plan d'utilisation et une limitation par clé API à notre étape d'API REST" (charger) ; NE DEVRAIT PAS — "Ajouter un middleware de limitation de débit à mon application Express exécutée sur ECS" (ignorer), "Concevoir un schéma de nommage de ressources API REST pour notre service interne" (ignorer) ; 5/5 correct, l'ancre "AWS API Gateway" empêche les phrases génériques comme "dépannage des problèmes d'API" de se déclencher excessivement. Pour la sortie, j'ai écrit les deux artefacts (apigw-baseline.md vs skillrun.md dans le scratchpad) pour une tâche : API HTTP POST /orders supportée par Lambda, authentification JWT Cognito, CORS pour une origine. Ma base de référence couvrait les 6 étapes nécessaires pour un point de terminaison fonctionnel ; suivre strictement le corps de SKILL.md en couvrait environ 3 — le corps ne montre que le raccourci de création rapide `create-api --target` et ne donne jamais d'exemple de `create-route` ou `create-integration` (`create-route` n'apparaît que comme une ligne dans un tableau CLI), ne mentionne jamais `--payload-format-version 2.0`, et `aws lambda add-permission` n'apparaît nulle part dans SKILL.md ou integration-patterns.md, donc une suite littérale déploie une API qui renvoie 500. La compétence a ajouté deux choses que ma base de référence avait manquées : le décodage du corps isBase64Encoded dans le gestionnaire et les notes de timeout 502 "missing statusCode" / 504 29s-vs-30s. Résultat net, donc 5/10. Documentation pénalisée à 3 : integration-patterns.md n'est jamais lié depuis SKILL.md, donc la divulgation progressive est morte, l'exemple d'installation Codex du README pointe vers une compétence `rlhf` inexistante dans ce dépôt, et "deep expertise / real-world patterns, edge cases" survend ce qui est une feuille de triche compétente mais incomplète ; les affirmations sur les "18 services" et la vérification hebdomadaire des documents ont été vérifiées par rapport à l'arborescence et .github/workflows/weekly-aws-doc-check.yml.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

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.

Commandes et exemples de prompts

  • /api-gatewayRéférence AWS API Gateway : recettes CLI REST/HTTP, CORS, authentification JWT, dépannage 502/504

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →