SkillProof tested Claude skills

API And Interface Design

Diseño de interfaces REST/GraphQL y TypeScript guiado por checklist, con reglas de errores y nomenclatura.

Por addyosmani · addyosmani/agent-skills

Probado · Funciona ★ 9.6/10

API And Interface Design — Diseño de interfaces REST/GraphQL y TypeScript guiado por checklist, con reglas de errores y nomenclatura.

Qué hace

Guía el diseño de endpoints REST/GraphQL estables, límites de módulos y contratos de tipos TypeScript usando la Ley de Hyrum, semántica de errores consistente, validación de límites y cambios solo aditivos. Se activa cuando un usuario está diseñando nuevos endpoints, definiendo contratos entre frontend/backend o módulos, o cambiando una interfaz pública existente.

Informe de la prueba

Convirtió un diseño de API basado en verbos (POST /createBookmark, retornos inconsistentes) en rutas de recursos adecuadas, una forma de error consistente, paginación por cursor y un tipo de ID de marca (branded type).

Probado el: 2026-07-10 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/addyosmani/agent-skills
cd agent-skills
mkdir -p ~/.claude/skills
cp -r skills/api-and-interface-design ~/.claude/skills/api-and-interface-design

Comandos y prompts de ejemplo

  • /api-and-interface-designDiseño de interfaces REST/GraphQL y TypeScript guiado por checklist, con reglas de errores y nomenclatura.

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Design a REST endpoint for order refunds with consistent error semantics
  • Define the TypeScript contract between the frontend and this new service
  • Review this public API change for additive-only compatibility

Informe completo →