Doncheli API Contract

Fuerza una plantilla completa de contrato de API: auth, límites de tasa, reintentos, disyuntor, idempotencia, versionado.

Por doncheli · doncheli/don-cheli-sdd

Probado · Funciona ★ 9.2/10

Doncheli API Contract — Fuerza una plantilla completa de contrato de API: auth, límites de tasa, reintentos, disyuntor, idempotencia, versionado.

Qué hace

Produce un documento de contrato de API estructurado por endpoint/operación que cubre esquemas de solicitud/respuesta, catálogos de errores, ámbitos de autenticación, limitación de tasa, política de reintentos y disyuntor, y requisitos de idempotencia, luego una política de cambios disruptivos para toda la superficie. Se activa con solicitudes de diseño de API/contrato/endpoint/webhook/REST/GraphQL/OpenAPI; explícitamente se remite a habilidades hermanas para solicitudes de solo revisión o solo implementación.

Informe de la prueba

Ejecutó una tarea real de contrato de webhook: la línea base cubría el payload y una nota vaga de reintento; la lista de verificación de la habilidad forzó una clave/TTL de idempotencia explícita, un catálogo de errores de 5 casos y un diseño de disyuntor para tormentas de reintentos que la línea base nunca consideró.

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

Instalación

git clone https://github.com/doncheli/don-cheli-sdd
cd don-cheli-sdd
mkdir -p ~/.claude/skills
cp -r .agent/skills/doncheli-api-contract ~/.claude/skills/doncheli-api-contract

Comandos y prompts de ejemplo

  • /doncheli-api-contractFuerza una plantilla completa de contrato de API: auth, límites de tasa, reintentos, disyuntor, idempotencia, versionado.

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

  • Design the API contract for our new Stripe webhook integration.
  • Define endpoints, auth, and error handling before we start building.
  • Help me spec out rate limiting and retries for this REST API.