Una skill que pone orden en tus skills

Instrucciones que no hay que repetir

La documentación de Claude Code, la herramienta de programación con agentes de Anthropic, la empresa de IA que desarrolla Claude, aconseja crear una skill «cuando sigues pegando en el chat las mismas instrucciones, lista de comprobación o procedimiento de varios pasos».

En Claude Code, las personales van en `~/.claude/skills/<nombre>/SKILL.md` y sirven en todos los proyectos; las de un proyecto, en `.claude/skills/`. Se invocan con `/nombre`, o el asistente las usa cuando vienen al caso.

Codex, el agente de programación de OpenAI, la empresa que desarrolla ChatGPT, lee el mismo formato y guarda las personales en `~/.agents/skills`. Su documentación avisa de que el asistente elige skill leyendo solo nombre y descripción: esta debe ser corta y decir pronto cuándo se usa.

El parte del día y el asesor del año

Una skill puede hacer de jefe de gabinete: lee correo y calendario y entrega cada mañana una lista numerada de lo que pide atención, con el siguiente paso de cada punto. Otra puede ser un asesor que contrasta decisiones con los objetivos del año. El parte mira el día; el asesor, el rumbo.

Peter Yang, que escribe el boletín Behind the Craft en Substack, la plataforma de boletines por suscripción, describió el 17 de junio de 2026 su asesor como «básicamente una carpeta con unos cuantos ficheros de texto». Su regla clave: el SKILL.md «no debería contener un montón de información personal», sino decirle a la IA qué papel hacer, qué contexto leer, cómo aconsejar y qué recordar. Los objetivos van en otro fichero, plan.md. La skill dice cómo; el plan, qué.

En el ejemplo, el asesor cabe en cuatro instrucciones; la última, no editar los objetivos.

Una página que escribes tú

El plan lo escribe la persona, no la IA, y lo dice arriba: «Zona sin slop. Este documento lo escribo yo. La IA puede sugerir cambios, nunca hacerlos».

El del ejemplo es el de una ilustradora ficticia, Marta: tres metas, como llegar a 12 clientes fijos de ilustración editorial; lo que no hará, como logotipos por menos de 600 euros o ferias en fin de semana; lo que le da y le quita energía, con las mañanas sin reuniones antes de las 11:00; la familia, y cómo quiere los consejos.

Con esa página, Claude Haiku 5.5, el más rápido y barato de la gama actual de Anthropic, respondió el 12 de noviembre de 2026 a tres decisiones desde la línea de órdenes de Claude Code. Dijo que no a las tres citando la parte del plan con la que chocaban, aunque en la primera sugirió reunirse «en tu tarde libre si no es miércoles», una frase confusa.

El documento quedó intacto, pero el modelo solo tenía permiso de lectura: la orden de no editarlo no se puso a prueba.

El parte matinal, con un buzón de mentira

El parte se probó con seis correos inventados en ficheros .eml, el formato estándar de un correo guardado, con dominios .test, reservados para pruebas, y un calendario .ics. El «hoy» es un martes ficticio, el 12 de enero de 2027, y no se conectó ninguna cuenta real.

La skill tiene cinco instrucciones: leer buzón y calendario; lista numerada con lo importante primero; una línea por punto con qué es, de quién viene y el siguiente paso; agenda de hoy y mañana, y borradores sí, envíos nunca. El modelo no envió nada, pero su parte, en la imagen, metió un boletín y una publicidad, propuso confirmar una videollamada a las 9:30 y dejó en tercer lugar una factura de 1.200 euros que sigue sin pagarse porque falta el número de cuenta.

Cuatro precauciones. La práctica se hace solo con datos inventados, nunca con el correo real. Se piden borradores, no envíos. Si algún día se conecta un correo, con permiso solo de lectura. Y solo se usan skills propias o de fuentes de confianza: la documentación de Claude advierte de que una skill maliciosa puede llevar al asistente a usar herramientas o ejecutar código de forma distinta a la que anuncia, con riesgo de fuga de datos.

Cinco correcciones, dos caminos

Las mismas cinco correcciones, redactadas para el ejemplo, se aplicaron de dos maneras. Pedían quitar boletín y publicidad, avisar de las reuniones antes de las 11:00, poner primero la factura, quitar otra vez el boletín y, al final, enseñar las convocatorias que trae el boletín.

En el primer camino, tras cada corrección se pidió «actualiza la skill para que no vuelva a pasar», y la skill creció en las cinco rondas. En el segundo, una skill «editor-de-skills» leyó las cinco conversaciones a la vez con siete instrucciones: leerlo todo antes de proponer, regla solo para lo repetido, generalizar, no duplicar, ante una contradicción, quedarse con la más reciente o preguntar, mantenerla corta y devolver los cambios «antes → después» para aprobarlos uno a uno.

Luego cada versión hizo el parte del mismo buzón. La remendada quitó boletín y publicidad, pero también las convocatorias, porque se contradecía: una regla mandaba sacarlas siempre en el parte y otra, solo cuando se pidieran.

Es un solo buzón inventado: no mide la calidad de Claude Haiku 5.5 ni de ningún otro modelo.

El editor propone, tú decides

El editor tampoco acertó solo. En la primera pasada hizo dos cambios y dejó como preguntas la reunión antes de las 11:00 y la factura, porque «aparecen una vez cada una»: su propia regla de atender solo lo repetido le hizo aparcar una petición explícita. Con esa versión, el parte cumplió tres de cinco y se inventó que un presupuesto «vence el viernes 15, según su correo», cuando el correo decía «esta semana».

Tras responder que sí a las dos preguntas, el editor las añadió en dos frases y el parte cumplió las cinco. El editor propone; la última palabra es de la persona, cambio a cambio.

Y un parte que acierta no basta. Según la documentación de Claude Code, ver que una skill se activa «te dice que Claude la encontró, no que hiciera lo que pretendías». Propone probar varias peticiones realistas, cada una en una sesión nueva con la skill y sin ella: lo que queda en el contexto de haberla escrito tapa los huecos de sus instrucciones.

Hazlo tú

Hace falta Claude Code o Codex en la línea de órdenes, una carpeta de prueba y datos inventados.

Paso 1: escribe a mano `objetivos.md`, una página como la del ejemplo, con la línea de que la IA sugiere pero no edita. Paso 2: crea `.claude/skills/asesor/SKILL.md` en Claude Code, o `~/.agents/skills/asesor/SKILL.md` en Codex, con `name`, `description` y cuatro instrucciones: leer el plan; veredicto, por qué y qué harías; ser directo, y no editar el plan. Pruébala con `/asesor ¿acepto este encargo?`.

Paso 3: crea una carpeta `buzon/` con cinco o seis `.eml` inventados, con dominios `.test`, y un `calendario.ics`; añade la skill `parte-matinal` y pide el parte. Paso 4: durante una semana, apunta cada corrección en la plantilla; luego, en una sesión nueva, pásalas todas a `editor-de-skills`, aprueba cambio a cambio y prueba la skill con ella y sin ella.