Tune skill
El ajuste fino es un conjunto de ediciones pequeñas y con evidencia a un skill que ya existe. No es una reescritura. El objetivo es un skill que se active en las solicitudes correctas, que no interfiera con sus skills hermanos y que pase el trabajo de una manera definida.
Reglas básicas
- Lee el SKILL.md real primero. Los README, las descripciones de repositorio y los listados se desvían del archivo que el agente realmente carga. Cualquier afirmación sobre un skill debe provenir de su SKILL.md o de sus referencias. Si no puedes abrir un archivo, nómbralo y di qué estás infiriendo en su lugar.
- Verifica tus propias afirmaciones. Si un archivo que lees más tarde contradice algo que dijiste antes, dilo claramente y corrígelo. No lo evites en silencio.
- Ediciones mínimas, la voz del autor. Cambia solo lo que la auditoría encontró y nada más. Conserva las claves de frontmatter que no reconozcas (
version,argument-hint,user-invocable). Nunca debilites las reglas de honestidad, seguridad o privacidad. - No afirmes lo que no ejecutaste. Di qué comprobaciones se ejecutaron, qué casos de prueba solo se escribieron y qué archivos nunca viste.
Flujo de trabajo
1. Recopilar
Obtén el SKILL.md del skill objetivo y de cada skill hermano que toque, más cualquier referencia que puedas alcanzar. Si el usuario da un enlace que no puedes abrir, pide el texto del archivo o su URL. Si el skill es una carpeta en disco, ejecuta el script de verificación (paso 6) ahora para una primera lectura.
2. Mapear
Escribe un breve inventario por skill: qué promete su descripción, sus modos o comandos, los archivos de referencia que nombra, y qué entrega y a quién. Coloca las descripciones de los skills hermanos y las listas de comandos una al lado de la otra. Las superposiciones solo se ven cuando puedes ver ambas.
3. Auditar
Trabaja a través de references/audit-checklist.md. Para cada hallazgo, registra la evidencia (cita la línea), la gravedad (rompe la activación, confuso o cosmético) y la corrección más pequeña. Reporta primero el más grave.
4. Establecer límites
Cuando dos skills reclaman la misma solicitud, asígnale un propietario. Usa la división que el diseño del usuario ya utiliza (por ejemplo, veredicto frente a artefacto: un skill juzga, el otro escribe). Pregunta al usuario solo cuando su diseño no lo resuelva, y pregunta una vez.
5. Editar
Haz el cambio más pequeño que solucione cada hallazgo. Cuando el usuario vaya a colocar el resultado directamente en un repositorio, devuelve archivos de reemplazo completos y copia exactamente el texto sin modificar. Cuando una corrección necesite una nueva pieza compartida (un formato de entrega, por ejemplo), añade un nuevo archivo de referencia en lugar de editar uno que no has visto. Enumera los archivos de referencia que probablemente necesiten una actualización coincidente.
6. Validar
Ejecuta el script de verificación en cada carpeta de skill:
python scripts/check_skill.py <ruta-a-la-carpeta-del-skill>
Verifica que el nombre coincida con la carpeta, la descripción cumpla el límite de 1024 caracteres y tenga redacción de activación y límites, el H1 coincida con el nombre, los archivos referenciados existan y el cuerpo tenga una longitud razonable. Corrige cada FALLO. Juzga cada ADVERTENCIA. Si solo tienes texto pegado, guarda el SKILL.md en una carpeta nombrada según el skill y ejecútalo allí; las advertencias de referencia faltante son esperadas en ese caso.
7. Escribir casos de prueba
Sigue references/test-cases.md. Cada límite que cambiaste obtiene un caso a cada lado. Ejecútalos manualmente contra las descripciones. Algunos agentes envían un bucle de activación automatizado en su herramienta de autoría; si no ejecutaste uno, no des a entender que lo hiciste. Di cuáles ejecutaste.
8. Reportar
Mantenlo breve:
- Qué cambió, por skill, y por qué (una línea cada uno).
- Correcciones a cualquier cosa que hayas dicho antes.
- Qué no pudiste ver o no ejecutaste.
- Un siguiente paso.
Empieza con los cambios, no con el proceso.