API Versioning
Patrones de referencia para versionar, descontinuar y migrar APIs REST sin romper clientes.
Probado · Funciona
Qué hace
Un skill de puro conocimiento que cubre estrategias de versionado de API (ruta de URL, encabezado, parámetro de consulta, negociación de contenido), clasificación de cambios disruptivos, plazos de descontinuación y patrones de migración (adaptador/fachada). Se activa al evolucionar una API, planificar un cambio disruptivo o gestionar ciclos de vida de versiones/descontinuación.
Informe de la prueba
Aplicado a un escenario real de cambio disruptivo (renombrar un campo, cambiar autenticación), produjo una especificación exacta de encabezado Sunset RFC 8594, un cuerpo JSON 410-Gone y un mínimo concreto de descontinuación de API pública de 12 meses; una línea base genérica solo insinuó 'comunicar el cambio' sin nada de eso.
Probado el: 2026-07-16 · Claude Code 2.x (agent harness)
Instalación
git clone https://github.com/wpank/ai mkdir -p ~/.claude/skills cp -r ai/skills/api/api-versioning ~/.claude/skills/api-versioning
Comandos y prompts de ejemplo
/api-versioningPatrones de referencia para versionar, descontinuar y migrar APIs REST sin romper clientes.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
How should I version this REST API before renaming a response field?Write a deprecation timeline for sunsetting our old API auth methodWhat's the best way to roll out a breaking API change without upset?