API Design Principles

Applique les principes de conception REST et GraphQL pour construire des API claires et évolutives.

Tested · Didn't pass

Ce que fait

Maîtriser les principes de conception d'API REST et GraphQL pour construire des API intuitives, évolutives et maintenables qui ravissent les développeurs. À utiliser quand on conçoit de nouvelles API, relit des spécifications d'API, ou établit des standards de conception d'API.

Rapport de test

Testé sur une tâche de conception REST (service de favoris : endpoints, versioning, pagination, exemples JSON) avec et sans le skill. Les deux bras ont produit des conceptions correctes et complètes avec des endpoints orientés ressources et un versioning par URL ; le bras avec skill respectait pleinement les bonnes pratiques mais a choisi une pagination offset/page, tandis que le bras de base a atteint indépendamment le choix plus solide de pagination par curseur, avec une justification plus fine. L'installation verbatim et le frontmatter étaient propres ; le skill n'apporte pas de gain mesurable par rapport à un modèle de base compétent sur cette tâche.

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

Installation

git clone https://github.com/wshobson/agents
cd agents
mkdir -p ~/.claude/skills
cp -r plugins/backend-development/skills/api-design-principles ~/.claude/skills/api-design-principles

Commandes et exemples de prompts

/api-design-principlesApplique les principes de conception REST et GraphQL pour construire des API claires et évolutives.

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

Review this REST API design for consistency issues
Design a GraphQL schema following best practices
Set API design standards for our new service

Rapport complet →