API Discipline
Specs REST/OpenAPI limpias en validadores, con auditoría obligatoria de consistencia entre endpoints.
Probado · Funciona
Qué hace
Impone disciplina de diseño REST/OpenAPI en diseños desde cero, adiciones de endpoints y revisiones de specs: nombres de recursos en sustantivo plural, un único modelo de error compartido RFC 9457, convenciones de paginación y versionado declaradas una vez y reutilizadas, semántica correcta de PUT/PATCH/POST/DELETE, un diff de cambios disruptivos en cada edición, y una auditoría obligatoria de 10 puntos antes de entregar. Evaluado contra un agente Claude sin skill en 7 tareas, con validadores mecánicos (Redocly, Spectral, oasdiff) en lugar de puntuaciones autodeclaradas.
Informe de la prueba
Skill propia — evaluada bajo el mismo protocolo, con divulgación completa. En 7 tareas de diseño/revisión de API puntuadas con validadores reales (Redocly, Spectral, oasdiff), la skill eliminó los errores estructurales de OpenAPI (0 frente a 18 combinados en dos specs desde cero), las violaciones de consistencia entre endpoints (0 frente a 6) y los errores de semántica HTTP (0 frente a 3) frente a un agente sin skill. Se publican dos salvedades reales en verdict.md en lugar de ocultarlas: la skill perdió la revisión de violaciones sembradas T6 por una sola (9/10 frente a 10/10, se le escapó un hallazgo de 201 sin Location que el agente base sí detectó), y la tarea de cambios disruptivos T4 queda excluida de la victoria porque se descubrió que el brazo con skill había visto una pista de la respuesta correcta antes de analizar. La prueba del protocolo encontró problemas reales en nuestros propios repos (enlaces de benchmark caídos, frontmatter YAML estricto) — corregidos y reverificados el mismo día.
Probado el: 2026-07-11 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/Skillproofdev/api-discipline ~/.claude/skills/api-discipline
Comandos y prompts de ejemplo
/api-disciplineSpecs REST/OpenAPI limpias en validadores, con auditoría obligatoria de consistencia entre endpoints.
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 a project management tool with users, projects, and tasks.Add an endpoint to cancel an order in our existing OpenAPI spec — here's the current spec.yaml.Should I use PUT or PATCH to update a single field on a user resource?