API Design Principles

Applica i principi di design REST e GraphQL per costruire API chiare e scalabili.

Tested · Didn't pass

Cosa fa

Padroneggia i principi di design delle API REST e GraphQL per costruire API intuitive, scalabili e manutenibili che i developer amano usare. Da usare quando si progettano nuove API, si rivedono specifiche API o si stabiliscono standard di design per le API.

Rapporto di test

Testato su un task di design REST (servizio di bookmark: endpoint, versioning, paginazione, esempi JSON) con e senza lo skill. Entrambi i bracci hanno prodotto design corretti e completi con endpoint orientati alle risorse e versioning via URL; il braccio con lo skill era pienamente conforme alle best practice ma ha scelto la paginazione offset/page, mentre il braccio base è arrivato in autonomia alla scelta più solida basata su cursore, con un ragionamento più netto. Installazione verbatim e frontmatter puliti; lo skill non aggiunge un vantaggio misurabile rispetto a un modello base capace su questo task.

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

Installazione

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

Comandi e prompt di esempio

/api-design-principlesApplica i principi di design REST e GraphQL per costruire API chiare e scalabili.

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

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

Rapporto completo →