Skill on kansio, joka sisältää ohjeet ja tarvittaessa myös tiedostot ja skriptit yhteen toistuvaan työtehtävään. Tekoäly ottaa sen käyttöön itse silloin kun tehtävä vastaa skillin kuvausta. Tämä sivu käy läpi, miten skill eroaa promptista ja ohjetiedostosta, mihin se sopii yrityksessä ja milloin sitä ei kannata tehdä.
Lyhyesti: prompti on kertaluonteinen ohje, ohjetiedosto on aina mukana, skill on ohje joka ladataan vain silloin kun sitä tarvitaan. Ero ratkaisee silloin kun toistuvia työtehtäviä on kymmeniä: kaikkea ei voi pitää muistissa yhtä aikaa, mutta kaiken pitää olla saatavilla.
Skill on kansio, jonka ytimessä on SKILL.md-tiedosto. Sen alussa on lyhyt määritysosa, jossa on kaksi pakollista kenttää: name ja description. Description kertoo sekä sen mitä skill tekee että sen milloin sitä käytetään — juuri tämän perusteella tekoäly päättää ottaako se skillin käyttöön.
Kansiossa voi olla myös muita markdown-tiedostoja, skriptejä ja aineistoja. Niitä ei ladata etukäteen: tekoäly avaa ne vasta jos kyseinen tehtävä sitä vaatii.
Nimelle ja kuvaukselle on rajat: name on enintään 64 merkkiä ja sisältää vain pieniä kirjaimia, numeroita ja väliviivoja, ja description enintään 1 024 merkkiä. Rajat ovat pieni yksityiskohta, mutta description on koko rakenteen tärkein yksittäinen rivi — huono kuvaus tarkoittaa, ettei skill koskaan aktivoidu.
Ero ei ole sisällössä vaan siinä, milloin ohje on tekoälyn muistissa.
Käytännön järjestys on siis: yrityksen pysyvät säännöt ohjetiedostoon, toistuvat työtehtävät skilleiksi, kertaluonteiset asiat prompteina. Gamebook on tässä mallissa se ohjetiedosto: yrityksen konteksti, jonka päälle yksittäiset skillit toimivat.
Skill maksaa ylläpitoa. Se kannattaa vain silloin kun sama työ toistuu ja sen tekeminen oikein vaatii enemmän kuin yhden kappaleen ohjetta.
| Tilanne | Ratkaisu | Miksi |
|---|---|---|
| Toistuva tehtävä, oma prosessi ja pohjat | Skill | Ohje ja pohjat kulkevat yhdessä ja latautuvat vain tarvittaessa. |
| Yrityksen brandääni ja perustiedot | Ohjetiedosto (Gamebook) | Pätee joka tehtävässä, joten sen pitää olla aina mukana. |
| Kertaluonteinen erikoistapaus | Prompti | Ylläpidettävää rakennetta ei kannata luoda kertakäyttöön. |
| Tieto elää ja päivittyy jatkuvasti | Ei skill | Skill on staattinen tiedosto. Jatkuvasti muuttuva tieto haetaan lähteestä, ei kopioida ohjeeseen. |
| Toiminto toisessa järjestelmässä | Ei skill | Skill on ohje, ei yhteys. Toisen järjestelmän käyttö vaatii rajapinnan. |
Kaksi viimeistä riviä ovat yleisimmät virheet. Skillä käytetään usein tiedon säilömiseen, jolloin siitä tulee vanhentuva kopio. Ja skilliä yritetään käyttää integraationa, vaikka se ei avaa yhteyttä mihinkään — se vain kertoo miten jokin tehdään.
Paras ensimmäinen skill on työ, jonka olet selittänyt tekoälylle useamman kerran alusta asti. Se kertoo, että ohje on olemassa mutta väärässä paikassa.
Kuvaus on se, minkä perusteella skill aktivoituu. Kirjoita siihen sekä tehtävä että tilanne: mitä tämä tekee ja milloin sitä käytetään. Tämä rivi ratkaisee toimiiko koko skill.
Vaiheet järjestyksessä, hyvän lopputuloksen tuntomerkit ja ne kohdat, joissa yleensä menee pieleen. Älä selitä mitä tekoäly jo osaa.
Pitkät mallipohjat, tarkistuslistat ja aineistot kuuluvat erillisiin tiedostoihin, jotka avataan vain tarvittaessa. SKILL.md pysyy luettavana.
Jos skill ei aktivoidu, vika on yleensä kuvauksessa eikä ohjeessa. Jos se aktivoituu väärään aikaan, kuvaus on liian lavea.
Skillit ovat käytössä useammassa Claude-tuotteessa, mutta ne eivät siirry näiden välillä automaattisesti.
Omat skillit lisätään kuhunkin ympäristöön erikseen: yhteen paikkaan ladattu skill ei ilmesty toiseen itsestään. Yrityksessä tämä kannattaa ratkaista heti alussa — pidä skillit versionhallinnassa tai jaetussa kansiossa, jotta yksi kappale on totuus ja muut ovat kopioita siitä.
Toinen käytännön asia on omistajuus. Skill on prosessikuvaus, joten se vanhenee samaan tahtiin kuin prosessi. Jos kukaan ei omista skilliä, se muuttuu muutamassa kuukaudessa ohjeeksi, joka kuvaa sitä miten asiat ennen tehtiin.
Kolmas: skill ei ole tietoturvaratkaisu. Se ei rajoita sitä, mitä tekoäly voi tehdä — se ohjaa miten tehtävä tehdään. Valtuudet ja rajat ratkaistaan muualla.
Ei. SKILL.md on tavallinen tekstitiedosto, jossa on lyhyt määritysosa ja ohjeet selkokielellä. Skriptit ovat mahdollisia mutta eivät pakollisia — valtaosa hyödyllisistä skilleistä on pelkkää tekstia.
Gamebook on yrityksen konteksti, joka pätee joka tehtävässä: ääni, asiakkaat, palvelut, rajat. Skill on yhden toistuvan työtehtävän ohje, joka otetaan käyttöön vain silloin kun sitä tarvitaan. Ne täydentävät toisiaan.
Aloita yhdestä ja lisää vasta kun edellinen on oikeasti käytössä. Koska skillit latautuvat vain tarvittaessa, määrä ei ole tekninen ongelma — ylläpito on.
Ei itsessään. Skill kertoo miten tehtävä tehdään; yhteys toiseen järjestelmään tarvitsee erillisen rajapinnan. Skill voi kylläkin ohjeistaa, miten olemassa olevaa yhteyttä käytetään oikein.
Lähes aina syy on kuvauksessa. Jos siinä lukee vain mitä skill tekee muttei sitä milloin sitä käytetään, tekoälyllä ei ole perustetta valita sitä. Lisää kuvaukseen ne sanat, joilla työtehtävästä oikeasti puhutaan.
Ilman yrityksen kirjoitettua kontekstia jokainen skill joutuu toistamaan samat perusasiat — ja ne päätyvät eri versioina eri tiedostoihin.