Taitojen luominen tekoälyagenttien käyttöön: Mekaniikka, parhaat käytännöt ja muuttaminen liitännäiseksi

Kirjoittaja, rpa-skills-repositorion kehittäjä, kertoo yksityiskohtaisesti, miten tekoälyagenttien taitoja (skills) luodaan oikein. Taito ei ole yksittäinen Markdown-tiedosto vaan kansio, jossa on pakollinen SKILL.md-tiedosto, joka sisältää YAML-otsakkeen (nimi, kuvaus) ja ohjetekstin, sekä valinnaiset hakemistot references/, scripts/, assets/ ja README.md. Progressiivisen paljastamisen periaate lataa järjestelmään vain taitokuvauksen; itse runko haetaan aktivoinnin yhteydessä, joten rungon tulisi olla enintään 500 riviä, ja raskas sisältö siirretään references/-hakemistoon. Kuvaustekstissä on tärkeää määritellä selvästi tarkoitus ja laukaisuehdot, välttäen yleisiä sanoja kuten MUST, jotta malli ei aktivoi taitoa satunnaisesti. Kirjoittaja korostaa taitojen ja sääntöjen (rules) eroa: säännöt (joissa alwaysApply: true) ovat aina aktiivisia ja sopivat koodityyliin tai virheiden käsittelyyn, kun taas taidot ovat parempia monivaiheisiin proseduureihin (käyttöönotto, BDD, bugianalyysi). Taitojen kuvaukset ja rungot tulisi kirjoittaa englanniksi tokenisoinnin vuoksi: kyrilliset merkit vievät keskimäärin kaksi kertaa enemmän tokeneita kuin latinalaiset, mikä säästää kontekstia. Mukana on Anthropicin käytäntöjä: vapausasteet (tiukat reunat kriittisille tehtäville, avoin kenttä luoville), deterministiset toiminnot tulisi siirtää skripteihin, pakollinen osio yleisille virheille (Gotchas), nimet gerundimuodossa (esim. processing-pdfs), ja liiallisen variaation välttäminen – parempi antaa yksi pääratkaisu ja yksi vararatkaisu. Taidon testaamiseksi ajetaan alagentti puhtaalla kontekstilla ja tarkistetaan, aktivoituuko taito automaattisesti, missä se teki virheitä ja vastaako tulos odotuksia. Vähintään kolme ajoa eri tehtävillä ja eri malleilla, myös pienillä, jotka noudattavat ohjeita kirjaimellisesti, on suositeltavaa. Markkinapaikalle tarkoitettu taito paketoidaan lisäosana (plugin) – kansio, jossa on manifest-tiedosto plugin.json (Claude Code:ssa .claude-plugin/, Codex:ssä .codex-plugin/), joka sisältää metatiedot, ja nimi vastaa SKILL.md:n nimeä ja versio on synkronoitu. Lisäosa voi sisältää myös vinoviivakomentoja, alagentteja, hookkeja ja MCP-palvelimia.