Gentleman-Programming/gentle-ai-skill-improver

Contrato de Activación

Usa este skill cuando audites, refactorices, normalices o mejoras archivos SKILL.md existentes. Usa gentle-ai-skill-creator cuando crees un skill nuevo a partir de un patrón reutilizable.

Reglas Estrictas

• Lee primero docs/skill-style-guide.md y trátalo como el contrato normativo de estilo.
• Trata SKILL.md como la fuente de verdad; preserva la intención del autor, las reglas críticas, la semántica de activación y los requisitos de salida.
• Usa .atl/skill-registry.md como un índice de nombres de skills, disparadores, ámbitos y rutas exactas cuando estén disponibles.
• Por defecto, solo audita. Modifica archivos solo cuando el usuario solicite explícitamente aplicar mejoras.
• Nunca elimines contenido significativo silenciosamente; mueve explicaciones largas, ejemplos, plantillas o esquemas a references/ o assets/ locales.
• No inventes disparadores, políticas o reglas de dominio. Marca los casos ambiguos para revisión humana.

Puertas de Decisión

Situación	Acción
Frontmatter faltante o inválido	Corrige name, description (una línea entrecomillada), license y metadata
El skill parece documentación tutorial	Convierte a instrucciones de ejecución y mueve el contexto a references/
El cuerpo excede el presupuesto	Preserva reglas, mueve ejemplos/contexto a archivos de soporte
Lógica de ramificación oculta en prosa	Convierte a una tabla de decisión compacta
Reglas en conflicto o intención poco clara	Reporta el problema; no reescribas esa regla automáticamente

Pasos de Ejecución

1. Lee docs/skill-style-guide.md.
2. Lee .atl/skill-registry.md; usa las rutas listadas para seleccionar skills. Si falta, escanea directorios conocidos de skills en busca de */SKILL.md.
3. Para cada skill seleccionado, audita metadatos, claridad del disparador, orden de secciones, presupuesto del cuerpo, capacidad de acción, puertas de decisión, contrato de salida y referencias locales.
4. Devuelve un informe de auditoría agrupado por skill con severidad y cambios propuestos exactos.
5. En modo aplicar, edita solo problemas seguros, preserva contenido, crea archivos de soporte cuando sea necesario, luego refresca o solicita /skill-registry:refresh.

Contrato de Salida

Devuelve:

• Skills auditados y rutas usadas.
• Problemas encontrados, agrupados por severidad.
• Archivos modificados, si se solicitó modo aplicar.
• Recomendación de refresco del registro cuando los metadatos o rutas del skill hayan cambiado.
• Ambigüedades que necesiten revisión humana.

Referencias

• docs/skill-style-guide.md — guía de estilo normativa para skills orientados a LLM.
• skills/skill-registry/SKILL.md — contrato de refresco e indexación del registro.