Una skill que posa ordre a les teves skills

Instruccions que no cal repetir

La documentació de Claude Code, l'eina de programació amb agents d'Anthropic, l'empresa d'IA que desenvolupa Claude, aconsella crear una skill «quan continues enganxant al xat les mateixes instruccions, llista de comprovació o procediment de diversos passos».

A Claude Code, les personals van a `~/.claude/skills/<nombre>/SKILL.md` i serveixen en tots els projectes; les d'un projecte, a `.claude/skills/`. S'invoquen amb `/nombre`, o l'assistent les fa servir quan escau.

Codex, l'agent de programació d'OpenAI, l'empresa que desenvolupa ChatGPT, llegeix el mateix format i desa les personals a `~/.agents/skills`. La seva documentació avisa que l'assistent tria la skill llegint només el nom i la descripció: aquesta ha de ser curta i dir aviat quan s'ha de fer servir.

L'informe del dia i l'assessor de l'any

Una skill pot fer de cap de gabinet: llegeix el correu i el calendari i lliura cada matí una llista numerada del que demana atenció, amb el pas següent de cada punt. Una altra pot ser un assessor que contrasta decisions amb els objectius de l'any. L'informe mira el dia; l'assessor, el rumb.

Peter Yang, que escriu el butlletí Behind the Craft a Substack, la plataforma de butlletins per subscripció, va descriure el 17 de juny de 2026 el seu assessor com «bàsicament una carpeta amb uns quants fitxers de text». La seva regla clau: el SKILL.md «no hauria de contenir un munt d'informació personal», sinó dir a la IA quin paper ha de fer, quin context ha de llegir, com ha d'aconsellar i què ha de recordar. Els objectius van en un altre fitxer, plan.md. La skill diu com; el pla, què.

A l'exemple, l'assessor cap en quatre instruccions; l'última, no editar els objectius.

Una pàgina que escrius tu

El pla l'escriu la persona, no la IA, i ho diu al capdamunt: «Zona sin slop. Este documento lo escribo yo. La IA puede sugerir cambios, nunca hacerlos» (zona sense slop: aquest document l'escric jo; la IA pot suggerir canvis, però mai fer-los).

El de l'exemple és el d'una il·lustradora fictícia, la Marta: tres metes, com arribar a 12 clients fixos d'il·lustració editorial; el que no farà, com logotips per menys de 600 euros o fires en cap de setmana; el que li dona i li treu energia, amb els matins sense reunions abans de les 11:00; la família, i com vol els consells.

Amb aquesta pàgina, Claude Haiku 5.5, el més ràpid i barat de la gamma actual d'Anthropic, va respondre el 12 de novembre de 2026 a tres decisions des de la línia d'ordres de Claude Code. Va dir que no a totes tres citant la part del pla amb què xocaven, tot i que a la primera va suggerir reunir-se «en tu tarde libre si no es miércoles», una frase confusa.

El document va quedar intacte, però el model només tenia permís de lectura: l'ordre de no editar-lo no es va posar a prova.

L'informe matinal, amb una bústia de mentida

L'informe es va provar amb sis correus inventats en fitxers .eml, el format estàndard d'un correu desat, amb dominis .test, reservats per a proves, i un calendari .ics. L'«avui» és un dimarts fictici, el 12 de gener de 2027, i no s'hi va connectar cap compte real.

La skill té cinc instruccions: llegir la bústia i el calendari; llista numerada amb el més important primer; una línia per punt amb què és, de qui ve i el pas següent; agenda d'avui i de demà, i esborranys sí, enviaments mai. El model no va enviar res, però el seu informe, a la imatge, hi va ficar un butlletí i una publicitat, va proposar confirmar una videotrucada a les 9:30 i va deixar en tercer lloc una factura de 1.200 euros que continua sense pagar-se perquè hi falta el número de compte.

Quatre precaucions. La pràctica es fa només amb dades inventades, mai amb el correu real. Es demanen esborranys, no enviaments. Si algun dia es connecta un correu, que sigui només amb permís de lectura. I només es fan servir skills pròpies o de fonts de confiança: la documentació de Claude adverteix que una skill maliciosa pot portar l'assistent a fer servir eines o executar codi d'una manera diferent de la que anuncia, amb risc de fuga de dades.

Cinc correccions, dos camins

Les mateixes cinc correccions, redactades per a l'exemple, es van aplicar de dues maneres. Demanaven treure el butlletí i la publicitat, avisar de les reunions abans de les 11:00, posar primer la factura, tornar a treure el butlletí i, al final, mostrar les convocatòries que porta el butlletí.

En el primer camí, després de cada correcció es va demanar «actualiza la skill para que no vuelva a pasar», i la skill va créixer en les cinc rondes. En el segon, una skill «editor-de-skills» va llegir les cinc converses alhora amb set instruccions: llegir-ho tot abans de proposar, regla només per al que es repeteix, generalitzar, no duplicar, davant d'una contradicció, quedar-se amb la més recent o preguntar, mantenir-la curta i retornar els canvis «antes → después» perquè s'aprovin un per un.

Després, cada versió va fer l'informe de la mateixa bústia. L'apedaçada va treure el butlletí i la publicitat, però també les convocatòries, perquè es contradeia: una regla manava incloure-les sempre a l'informe i una altra, només quan es demanessin.

És una sola bústia inventada: no mesura la qualitat de Claude Haiku 5.5 ni de cap altre model.

L'editor proposa, tu decideixes

L'editor tampoc no se'n va sortir sol. A la primera passada va fer dos canvis i va deixar com a preguntes la reunió abans de les 11:00 i la factura, perquè «aparecen una vez cada una»: la seva pròpia regla d'atendre només el que es repeteix li va fer aparcar una petició explícita. Amb aquesta versió, l'informe en va complir tres de cinc i es va inventar que un pressupost «vence el viernes 15, según su correo», quan el correu deia «esta semana».

Després de respondre que sí a les dues preguntes, l'editor les va afegir en dues frases i l'informe va complir les cinc. L'editor proposa; l'última paraula és de la persona, canvi a canvi.

I no n'hi ha prou que l'informe encerti. Segons la documentació de Claude Code, veure que una skill s'activa «et diu que Claude l'ha trobada, no que hagi fet el que pretenies». Proposa provar diverses peticions realistes, cadascuna en una sessió nova amb la skill i sense: el que queda al context d'haver-la escrit tapa els forats de les seves instruccions.

Fes-ho tu

Cal Claude Code o Codex a la línia d'ordres, una carpeta de prova i dades inventades.

Pas 1: escriu a mà `objetivos.md`, una pàgina com la de l'exemple, amb la línia que diu que la IA suggereix però no edita. Pas 2: crea `.claude/skills/asesor/SKILL.md` a Claude Code, o `~/.agents/skills/asesor/SKILL.md` a Codex, amb `name`, `description` i quatre instruccions: llegir el pla; veredicte, per què i què faries; ser directe, i no editar el pla. Prova-la amb `/asesor ¿acepto este encargo?`.

Pas 3: crea una carpeta `buzon/` amb cinc o sis `.eml` inventats, amb dominis `.test`, i un `calendario.ics`; afegeix la skill `parte-matinal` i demana l'informe. Pas 4: durant una setmana, apunta cada correcció a la plantilla; després, en una sessió nova, passa-les totes a `editor-de-skills`, aprova canvi a canvi i prova el resultat amb la skill i sense.