Detectar y reducir drift entre skills instaladas y agent-skills

[LucasLeguizamo]

Contexto

Durante una revisión del diseño del CLI y la skill de FreeTicket encontré que la skill instalada localmente en la máquina (~/.codex/skills/freeticket-cli) estaba detrás de la versión actual del repo AppFreeticket/agent-skills.

La versión del repo ya documenta cambios recientes de @freeticket/cli 0.5/0.6:

• usar npx @freeticket/cli@latest para evitar caches/versiones globales viejas;
• comandos nuevos (tickets, discounts, webhooks, sales create, sales tickets, plans subscribers, subscriptions cancel);
• reportes nuevos (by-event, timeseries, inventory, export attendees);
• filtros nuevos de ventas y exports.

La copia local instalada no tenía esos cambios, por lo que un agente podría dar instrucciones obsoletas aunque el repo fuente ya esté corregido.

Fricción

Las skills son parte operacional del producto: si se quedan atrás, el agente puede:

• omitir comandos disponibles;
• recomendar instalación global vieja en vez de npx @latest;
• duplicar issues ya resueltos en CLI/docs;
• responder distinto según la máquina donde corre.

Propuesta

Agregar un mecanismo explícito de versión/actualización para skills de FreeTicket, por ejemplo:

• incluir metadata de versión/fecha/CLI compatible en SKILL.md;
• documentar un comando estándar para reinstalar/actualizar la skill desde agent-skills;
• añadir una nota de troubleshooting: si ft --version o la tabla de comandos no coincide con la skill, actualizar skill local;
• idealmente un script/check que compare hash local vs repo y avise cuando hay drift.

Criterio de aceptación

• Un agente o mantenedor puede saber rápidamente si la skill instalada es la última.
• La ruta de actualización local está documentada en el repo.
• La skill de FreeTicket declara la versión mínima recomendada de @freeticket/cli.

Reportado tras revisión del CLI + freeticket-cli skill.

[LucasLeguizamo]

Atacado del lado de la skill en #13:

• SKILL.md ahora declara su revisión (fecha) y la versión mínima de ft que documenta.
• Regla explícita para cuando no coinciden: si ft --help lista un comando que la skill no tiene, o un flag documentado es rechazado, el CLI manda — reinstalar con npx skills add AppFreeticket/agent-skills y avisar, para que el drift se corrija arriba en vez de repetirse en silencio en cada máquina.

Eso cubre el caso concreto que reportaste (copia local vieja dando instrucciones obsoletas) sin agregar maquinaria: la skill se autodescribe y el agente tiene una regla de desempate.

Lo que no cubre y sería el paso siguiente si molesta de nuevo: chequeo automático de drift (comparar la tabla de comandos contra ft --help en runtime). Dejo el issue abierto por eso.