SkillProof tested Claude skills

API Designer

Diseña APIs REST o GraphQL con modelos de recursos, versionado y estándares de errores.

Por Jeffallan · Jeffallan/claude-skills

Funciona con configuración ★ 7.2/10

API Designer — Diseña APIs REST o GraphQL con modelos de recursos, versionado y estándares de errores.

Qué hace

Úsala al diseñar APIs REST o GraphQL, crear especificaciones OpenAPI o planificar la arquitectura de una API. Invócala para modelado de recursos, estrategias de versionado, patrones de paginación y estándares de manejo de errores.

Informe de la prueba

Se instaló tal cual (el destino se redirigió al workdir): el frontmatter del SKILL.md es strict-YAML válido y los cinco archivos de referencia (rest-patterns, versioning, pagination, error-handling, openapi) están presentes y son sustanciales. En una tarea de diseño de una API REST de Bookmarks, la skill produjo un resultado correcto y completo — URIs solo con sustantivos, paginación por cursor justificada, un OpenAPI 3.1 válido y un error RFC 7807. El A/B frente al arm base sin skill fue un empate: ambos cumplieron todos los requisitos con una calidad esencialmente igual, así que la skill añade buenas barandillas pero no supone aquí una mejora transformadora.

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

Instalación

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

Comandos y prompts de ejemplo

  • /api-designerDiseña APIs REST o GraphQL con modelos de recursos, versionado y estándares de errores.

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 API for this new service
  • Write an OpenAPI spec for these endpoints
  • Plan pagination and error handling for this API

Informe completo →