API Designer

Conçoit des API REST ou GraphQL avec modèles de ressources, versioning et standards d'erreurs.

par Jeffallan · Jeffallan/claude-skills

Fonctionne avec configuration ★ 7.2/10

API Designer — Conçoit des API REST ou GraphQL avec modèles de ressources, versioning et standards d'erreurs.

Ce que fait

À utiliser pour concevoir des API REST ou GraphQL, créer des spécifications OpenAPI, ou planifier une architecture d'API. Invoquez-le pour la modélisation de ressources, les stratégies de versioning, les modèles de pagination, les standards de gestion des erreurs.

Rapport de test

Installé verbatim (cible redirigée vers le répertoire de travail) : le frontmatter du SKILL.md est valide en strict-YAML et les cinq fichiers de référence (rest-patterns, versioning, pagination, error-handling, openapi) sont présents et substantiels. Sur une tâche de conception d'API REST Bookmarks, le skill a produit un résultat correct et complet — des URI composées uniquement de noms, une pagination par curseur justifiée, un OpenAPI 3.1 valide et une erreur RFC 7807. L'A/B face au bras de base sans skill était un match nul : les deux ont satisfait toutes les exigences à qualité quasi égale, le skill apporte donc des garde-fous solides mais aucun gain transformateur ici.

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

Installation

git clone https://github.com/Jeffallan/claude-skills
cd claude-skills
mkdir -p ~/.claude/skills
cp -r skills/api-designer ~/.claude/skills/api-designer

Commandes et exemples de prompts

  • /api-designerConçoit des API REST ou GraphQL avec modèles de ressources, versioning et standards d'erreurs.

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

  • Design a REST API for this new service
  • Write an OpenAPI spec for these endpoints
  • Plan pagination and error handling for this API