Llevamos siglos escribiendo skills. Los llamábamos libros.

Blog · 5 min de lectura

Pídele a alguien que «escriba un skill» para su agente de IA y verás asomar un extraño pánico escénico, como si fuera un tipo de escritura que nadie hubiera hecho jamás. No lo es. Una receta es un skill. Un manual de campo es un skill. La tarjeta de seguridad plastificada detrás del asiento del avión, el runbook de incidentes en la carpeta de operaciones, la guía de estilo que tu primer editor te hizo leer dos veces — todo eso es lo mismo que ahora intentamos entregarle a un agente: así se hace esto, escrito para que alguien más pueda hacerlo sin que tú estés en la sala.

Lo que en realidad es nuevo no es la escritura. Es el lector. Un libro de cocina está escrito para alguien que lo hojea una vez, decide qué preparar para cenar y quizá se detiene en la anécdota introductoria por gusto. Un agente no quiere la anécdota. Quiere la temperatura del horno, el tiempo de reposo, el «si la masa no ha duplicado su tamaño, espera veinte minutos más, no adivines». Las buenas instrucciones siempre han tenido esa parte en algún lugar — simplemente la enterrábamos bajo todo lo que un lector humano también quería, y un agente necesita que la desentierren.

La parte que me salía mal

Durante un tiempo, «escribir un skill» se parecía bastante a traducir, y se me daba mal: leer un capítulo, retener lo importante en la cabeza, volver a escribirlo en una caja de texto. Me quedaba con la frase que sonaba convincente y perdía el número exacto dos párrafos después, porque para entonces ya había dejado de tomar notas. Lo que salía al otro lado era el ambiente del original, no el original — sonaba seguro y estaba discretamente equivocado, de una forma que no notaba hasta que un agente lo seguía hasta donde yo no esperaba.

La alternativa que probé después fue peor: pegar el capítulo entero y esperar que el agente encontrara el párrafo correcto bajo presión, igual que si le entregaras a alguien un manual de cuarenta páginas diciéndole «está por ahí, en algún lado». Ninguna de las dos cosas es realmente escribir un skill. Una tira la fuente. La otra se niega a hacer el trabajo de convertirla en un skill.

Lo que cambió

La función de Skilnu para redactar un borrador a partir de un documento hace justo lo que a mí se me daba mal: lee el documento real — un PDF, un archivo de Word, una exportación en Markdown — y devuelve un borrador de SKILL.md que conserva los detalles en lugar del ambiente. No se publica nada. Es un primer intento que queda en el formulario de redacción, esperando a que yo corrija lo que entendió mal antes de que nadie más lo vea.

El hábito que cambió es más pequeño de lo que suena. Dejé de preguntarme «cómo le explico esto a un agente» y empecé a preguntarme «¿no tendré esto ya escrito en algún sitio?». Cada vez con más frecuencia, sí lo tengo: el documento de bienvenida que escribió una excompañera y que nadie ha vuelto a abrir desde entonces, la guía de estilo que solía vivir como un PDF que nadie leía más allá de la primera página, un capítulo de un libro que sigo recomendando en voz alta en lugar de simplemente prestarlo. Cada uno de ellos resultó estar a veinte minutos y una revisión de convertirse en algo que un agente podía seguir de verdad — no solo algo que yo podía citar mal de memoria.

Nada de esto libra a los borradores de la edición. Un modelo que ha leído tu documento una vez sigue escribiendo como tal: coloca un resumen donde hacía falta una regla, se vuelve impreciso justo donde tu fuente era imprecisa. Esa parte sigue siendo tuya, igual que siempre lo fue de quien adapta un manual para un nuevo lector. Lo que desaparece es la página en blanco, y el esfuerzo de recordar qué decía en realidad el capítulo cuatro.

Tu estantería ya está llena de esto

El instinto de escribir un skill desde cero trata cada instrucción para un agente como un tipo de documento completamente nuevo. No lo es. En algún lugar del wiki de tu equipo, en una carpeta del armario de operaciones o en una estantería de verdad, la mayor parte de lo que querrías que supiera un agente ya está escrita por alguien a quien le importó lo suficiente para hacerlo bien a la primera. El trabajo nunca fue escribirlo. Es, por fin, admitir que el manual cuenta.