API Design Patterns

38 reglas para la nomenclatura de endpoints REST, errores, paginación, versionado y seguridad API.

Por AsyrafHussin · AsyrafHussin/agent-skills

Probado · Funciona ★ 9.6/10

API Design Patterns — 38 reglas para la nomenclatura de endpoints REST, errores, paginación, versionado y seguridad API.

Qué hace

Un manual de reglas condensado (38 reglas / 7 categorías) para el diseño de API RESTful, que cubre la nomenclatura de recursos, la forma de las respuestas de error, la paginación, el versionado y la autenticación. Se activa al diseñar o revisar endpoints, o al escribir código de manejo de errores/paginación, y remite a archivos por regla (rules/*.md) y a un AGENTS.md compilado de 7,200 líneas para análisis profundos.

Informe de la prueba

Ejecuté un rediseño real de 'invoices API' a través de ella: la skill convirtió URLs basadas en verbos (POST /createInvoice) en sustantivos propios, reemplazó una cadena de error simple con un sobre estructurado (code/message/details/request_id) y añadió metadatos de paginación por cursor más enlaces HATEOAS que la línea base ingenua nunca tuvo.

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

Instalación

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

Comandos y prompts de ejemplo

/api-design-patterns38 reglas para la nomenclatura de endpoints REST, errores, paginación, versionado y seguridad API.

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 user management with proper error handling
Review my API endpoints for best practices before we ship
What HTTP status codes should I use for this validation error?

Informe completo →