API Auditor

Compétence d'exemple qui ping une URL avec HEAD et n'affiche que le code de statut

par saeed-vayghan · saeed-vayghan/gemini-agent-skills

Tested · Didn't pass

API Auditor — Compétence d'exemple qui ping une URL avec HEAD et n'affiche que le code de statut

Ce que fait

Une compétence de démonstration de 15 lignes qui indique à l'agent d'exécuter un script Node de 12 lignes fourni contre une URL, d'afficher le statut HTTP et de mentionner https. C'est l'entrée d'exemple livrée avec un dépôt de convertisseur de compétences Claude-vers-Gemini plutôt qu'un outil de test d'API fonctionnel, et son script rapporte les erreurs de serveur comme des succès. Se déclencherait en demandant de vérifier, tester ou auditer une URL ou une API.

Rapport de test

Le fichier audit.js fourni fait douze lignes et a affiché 'Result: Success (Status 503)' contre un service qui était réellement en panne, et 'Result: Success (Status 404)' contre un chemin manquant, donc un auditeur de disponibilité rapporte les échecs comme des succès. SKILL.md ordonne à l'agent d'analyser 'status codes, latency', mais le script ne mesure aucune latence et réduit un nom d'hôte mort à 'Result: Failed (fetch failed)' sans cause. La référence sans compétence, une ligne de curl, a renvoyé les mêmes codes de statut plus DNS, TLS et les temps totaux sur chaque cible et a nommé l'échec de résolution directement. Puisque SKILL.md dit que l'agent DOIT utiliser le script fourni, suivre cette compétence dégrade activement une vérification que l'agent fait déjà mieux sans aide ; c'est la démo d'exemple de base du dépôt pour un convertisseur Gemini, pas un outil.

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

Installation

git clone https://github.com/saeed-vayghan/gemini-agent-skills.git
mkdir -p ~/.claude/skills
cd gemini-agent-skills && cp -r .agent/skills/basic-sample-api-auditor ~/.claude/skills/api-auditor

Commandes et exemples de prompts

  • /api-auditorCompétence d'exemple qui ping une URL avec HEAD et n'affiche que le code de statut

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) :

  • Audit https://api.stripe.com/v1/charges and report the status
  • Check whether my API endpoint at myapi.dev/health is up
  • Test my REST endpoints and report their HTTP status codes