skill-audit

name	skill-audit
description	Audita y sugiere/actualiza skills existentes tras cambios en patrones, convenciones o arquitectura. Detecta drift entre el codebase y la documentación de skills, y alerta si se requiere crear un skill nuevo.
license	MIT
metadata	{"author":"myquota","version":"1.0","auto_invoke":["QA Checklist","Antes de crear PR","Al modificar patrones globales"]}

Propósito

Evitar drift entre el codebase y los skills documentados. Detecta si los cambios recientes afectan patrones documentados en algún skill, sugiere/aplica actualizaciones y alerta si falta crear un skill nuevo.

---

¿Cuándo se invoca?

• Antes de crear un PR (QA Checklist)
• Al modificar AGENTS.md, copilot-instructions.md, o skills existentes
• Al agregar un nuevo patrón global

---

¿Qué hace?

1. Analiza los cambios recientes (diff, PR, staged files)
2. Detecta si afectan patrones documentados en skills (estructura, reglas, templates, checklists)
3. Sugiere/aplica actualizaciones a los SKILL.md afectados
4. Alerta si se requiere crear un skill nuevo (nuevo patrón, módulo, flujo)
5. Recomienda correr skill-sync si se modificó metadata.auto_invoke

---

Ejemplo de uso

• Modificaste la estructura de módulos → skill-audit detecta que myquota-module y myquota-routes deben actualizarse
• Cambiaste la validación de env vars → skill-audit sugiere actualizar AGENTS.md y myquota-auth
• Agregaste un nuevo flujo (ej: notificaciones) → skill-audit alerta que falta crear skill myquota-notifications

---

Checklist

• ¿Todos los skills reflejan los patrones actuales?
• ¿Hay drift entre codebase y skills?
• ¿Falta crear un skill nuevo?
• ¿Se debe correr skill-sync para actualizar AGENTS.md?