SkillProof tested Claude skills

API Design Principles

Aplica principios de diseño REST y GraphQL para construir APIs claras y escalables.

Por wshobson · wshobson/agents

Tested · Didn't pass

API Design Principles — Aplica principios de diseño REST y GraphQL para construir APIs claras y escalables.

Qué hace

Domina los principios de diseño de APIs REST y GraphQL para construir APIs intuitivas, escalables y mantenibles que encantan a los desarrolladores. Se activa cuando se diseñan nuevas APIs, se revisan especificaciones de API o se establecen estándares de diseño de API.

Informe de la prueba

Se probó una tarea de diseño REST (servicio de marcadores: endpoints, versionado, paginación, ejemplos JSON) con y sin la skill. Ambos brazos produjeron diseños correctos y completos con endpoints orientados a recursos y versionado por URL; el brazo con skill cumplió plenamente las mejores prácticas pero eligió paginación por offset/página, mientras que el brazo base llegó de forma independiente a la opción más sólida de paginación por cursor, con una justificación más precisa. La instalación literal y el frontmatter estaban limpios; la skill no aporta una ventaja medible sobre un modelo base competente en esta tarea.

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

Instalación

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

Comandos y prompts de ejemplo

  • /api-design-principlesAplica principios de diseño REST y GraphQL para construir APIs claras y escalables.

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

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

Informe completo →