Skill Fixer

Skill Fixer es una skill que corrige automaticamente otras skills cuando Claude detecta un error durante su ejecucion, encuentra una solucion valida y confirma que la causa raiz esta en los archivos de la skill.

Su objetivo es convertir arreglos puntuales en mejoras permanentes para evitar repetir errores en futuras ejecuciones.

Que problema resuelve

Cuando una skill falla por instrucciones desactualizadas o incorrectas, Claude puede resolver el problema en el momento. Skill Fixer formaliza ese arreglo para que no se pierda.

Ejemplos comunes:

• Rutas equivocadas o inexistentes
• Comandos no disponibles en el entorno
• Flags obsoletos
• Scripts con errores
• Dependencias faltantes
• Diferencias entre sistemas operativos
• Documentacion desactualizada

Cuando se activa

Skill Fixer se usa cuando se cumplen estas 3 condiciones:

1. Claude estaba ejecutando otra skill y encontro un error o tuvo que desviarse de las instrucciones.
2. Claude encontro una forma de completar la tarea con exito.
3. La causa raiz estaba en los archivos de la skill (por ejemplo SKILL.md o scripts asociados).

Tambien puede activarse cuando el usuario pide explicitamente algo como:

• "fix this skill"
• "update the skill"
• "save this fix"
• "patch the skill"

Flujo de trabajo

1. Localizar la skill y validar que sea editable.
2. Identificar con precision que fallo y cual fue la solucion real.
3. Proponer un cambio minimo y concreto.
4. Pedir confirmacion explicita al usuario.
5. Aplicar el parche en los archivos correctos.
6. Verificar el cambio y reportar el resultado.

Principios de diseno

• Cambios minimos y quirurgicos
• Sin refactors innecesarios
• Transparencia del problema y de la solucion
• Confirmacion del usuario antes de escribir
• Verificacion despues de aplicar el parche

Casos en los que no aplica

No se debe usar Skill Fixer cuando:

• El error fue causado por la entrada del usuario
• El workaround fue algo unico y no repetible
• La skill esta en una ruta de solo lectura y no existe copia editable

Estructura esperada

Por defecto, busca skills en:

• ~/.agents/skills/

Y corrige principalmente:

• SKILL.md
• Scripts asociados dentro de la carpeta de la skill

Resultado esperado

Despues de aplicar Skill Fixer, la skill corregida debe poder ejecutarse sin repetir el error original, reduciendo friccion y consumo innecesario de tokens.