SKILL.md: convertir una manera de hacer en un procedimiento
Qué descubrí al convertir una forma de preparar materiales en un procedimiento reutilizable para trabajar con Codex.
Del criterio intuitivo al procedimiento
Como profe, sé que un buen taller de ejercicios no debería comenzar con el problema más difícil. Primero propondría una actividad que active una idea conocida; después, una aplicación directa; luego, una conexión conceptual y, recién entonces, un problema desafiante.
También revisaría el cronograma, mi banco de ejercicios y los materiales usados anteriormente. Ese conjunto de decisiones, que muchas veces aplicamos de manera casi intuitiva, puede convertirse en una skill:
- Revisar el objetivo y los materiales disponibles.
- Activar un concepto conocido.
- Avanzar desde la aplicación hacia la conexión conceptual.
- Cerrar con un problema desafiante.
- Revisar el resultado antes de entregarlo.
La transformación es sencilla de describir:
criterio profesional → procedimiento explícito y reutilizable.
La skill no inventa ese criterio ni reemplaza el juicio de quien conoce a sus estudiantes. Lo deja disponible para que pueda aplicarse de forma más consistente.
¿En qué se diferencia de un prompt?
Un prompt es el pedido de una tarea puntual. AGENTS.md reúne las reglas generales del proyecto. Una skill describe cómo realizar una tarea específica y reúne sus instrucciones principales en un archivo llamado SKILL.md.
Si AGENTS.md es el reglamento interno de una empresa, una skill es el manual de uno de sus procesos.
No todas las tareas necesitan una. Pero si cada vez que pido algo termino corrigiendo las mismas omisiones, probablemente hay una forma de trabajar que conviene hacer explícita.
Yo tampoco partí sabiendo que necesitaba crear skills. Primero expliqué cómo trabajaba y después fui reconociendo el nombre técnico de las piezas que Codex iba organizando o me iba sugiriendo a propósito de mis preguntas. Preguntarle qué era cada archivo, para qué servía y por qué era importante se convirtió en una forma de aprender.
En resumen, una skill es un procedimiento especializado. Su archivo principal, SKILL.md, indica cuándo usarla, qué información necesita, qué pasos seguir, qué decisiones tomar y cómo comprobar el resultado.
Una skill convierte una buena manera de hacer algo en una capacidad que puede volver a utilizarse, sin tener que empezar desde cero cada vez.