Escribir una Skill
Una ejecución crea o rediseña una skill. El resultado se juzga por el comportamiento cuando la skill se ejecuta, no por cómo se lee: esta ejecución instala el proceso del usuario, no una plantilla genérica de skill.
Antes de escribir, sigue el puntero de contexto en reference.md — ahí vive la mecánica del frontmatter.
Pasos
- Fijar el disparador. Pregunta quién debe alcanzar la skill y cuándo. Una skill que solo se ejecuta a propósito es invocada por el usuario (
disable-model-invocation: true, la descripción se convierte en un resumen humano de una línea, <100 caracteres). Una skill que el agente debe alcanzar sin que se le pida es invocada por el modelo: su descripción es el puntero siempre cargado, y su redacción decide si ocurre la activación. Hecho-cuando: la elección de invocación nombra la carga que está pagando — contexto, o tu memoria. - Inventariar cómo funciona realmente el trabajo. Recuerda la última ejecución real de este trabajo: qué se devolvió, corrigió o repitió. Esas correcciones son el contenido de la skill; lo que el modelo hace sin ayuda no lo es. Hecho-cuando: el borrador cita al menos un fallo real que previene.
- Escribir pasos, luego punteros. Cada paso es un procedimiento con una condición de finalización explícita, ordenado para que la ejecución entregue algo comprobable primero. El material de apoyo que solo necesitan algunas pasadas va en
reference.mddetrás de un puntero que nombra cuándo leerlo. Hecho-cuando: cada paso es verificable sin preguntar al agente si tuvo éxito. - Elegir las palabras clave. Para cada idea recurrente, toma la palabra compacta que ya vive en el preentrenamiento del modelo y deja que ella cargue el significado: los punteros, pasos y condiciones de finalización reutilizan esas palabras. Renombra la jerga dentro de ellas en lugar de explicar alrededor. Hecho-cuando: cada palabra clave aparece en más de un lugar y dirige en cada uno.
- Podar con la prueba de no-operación. Frase por frase: elimínala, pregunta qué se rompió. Nada se rompió — la frase se va. Las frases enteras se eliminan, nunca palabras recortadas; las duplicaciones colapsan en una única fuente de verdad en lugar de dos desvanecimientos. Hecho-cuando: ya no puedes ejecutar la prueba de no-operación sin pases; el archivo es más corto que la versión anterior.
Referencia
- reference.md — mecánica del frontmatter por tipo de invocación, las reglas para escribir punteros y la batería de lista de verificación para revisar una skill existente.
- La skill que produce esta ejecución se itera contra ejecuciones reales, no se escribe una vez: cuando una ejecución se comporta mal, la referencia de lectura califica el fallo antes de cualquier reescritura.