Kirjoita uudelleenkäytettävä taito
Tällä sivulla
Jos GPT:n ohjeet ovat sen sydän, taito (skill) on lisäosan sydän. Se on muoto, jota käytät uudelleenkäytettävän työnkulun kirjoittamiseen: ohjeet, resurssit ja tarvittaessa skriptit. OpenAI:n taidot noudattavat avointa standardia nimeltä “agent skills” (agentskills.io), mikä tarkoittaa, että hyvin kirjoitettu taito ei ole lukittu yhteen työkaluun. Tässä oppitunnissa opit kirjoittamaan sellaisen.
Taidon anatomia
Taito on kansio, joka sisältää yhden pakollisen tiedoston, SKILL.md, sekä valinnaisia elementtejä.
synthese-document/
├── SKILL.md ← pakollinen: ohjeet + metadata
├── scripts/ ← valinnainen: suoritettava koodi
├── references/ ← valinnainen: dokumentaatio
├── assets/ ← valinnainen: mallipohjat, resurssit
└── agents/
└── openai.yaml ← valinnainen: ulkoasu ja riippuvuudet
SKILL.md-tiedoston on sisällettävä name ja description. Tässä on minimaalinen esimerkki:
---
name: synthese-document
description: Tiivistää annetun asiakirjan kolmeen osaan (yleiskatsaus, keskeiset kohdat, avoimet kysymykset). Käytä, kun käyttäjä pyytää liitetyn asiakirjan yhteenvetoa tai raporttia.
---
# Asiakirjan yhteenveto
1. Lue koko asiakirja ennen kirjoittamista.
2. Kirjoita kolme osiota: Yleiskatsaus (3 lausetta), Keskeiset kohdat (max 5 luettelokohtaa), Avoimet kysymykset.
3. Luota vain asiakirjaan; jos tietoja puuttuu, kirjoita "ei annettu".
4. Käytä muotoiluun mallipohjaa kohdassa `assets/modele.md`.
Kuvaus on keskeisin osa
ChatGPT ja Codex aktivoivat taidon kahdella tavalla. Joko kutsut sitä eksplisiittisesti – kirjoittamalla @ ChatGPT:ssä tai /skills ja $ Codexissä – tai työkalu valitsee sen automaattisesti, kun pyyntösi vastaa sen kuvausta. Siksi dokumentaatiossa korostetaan tätä kenttää: tarvitset tiiviin kuvauksen, joka alkaa ensisijaisella käyttötarkoituksella ja käynnistyssanoilla, ja joka määrittelee selkeästi sen rajat.
Tätä vaatimusta ohjaa tietty mekanismi: progressiivinen paljastaminen (progressive disclosure). Aluksi ChatGPT ja Codex lukevat vain jokaisen asennetun taidon nimen ja kuvauksen; ne lataavat täydelliset ohjeet tiedostosta SKILL.md vasta, kun taitoa todella käytetään. Tämä mahdollistaa monien taitojen asentamisen tukkimatta kontekstia, mutta se tarkoittaa myös sitä, että epämääräinen kuvaus johtaa taitoon, jota ei joko koskaan valita oikeaan aikaan – tai joka valitaan väärään aikaan.
Valinnaiset asetukset
Tiedosto agents/openai.yaml antaa sinun hioa näyttöä työpöytäsovelluksessa (nimi, lyhyt kuvaus, kuvakkeet, väri, oletuskehote), määritellä työkalut, joista taito on riippuvainen – esimerkiksi MCP-palvelin – ja asettaa kutsumiskäytännön. Asettamalla allow_implicit_invocation: false estät ChatGPT:tä valitsemasta taitoa itsestään: tämä on hyödyllistä arkaluonteisissa työnkuluissa, jotka haluat käynnistää vain pyynnöstä.
Missä taidot sijaitsevat ja miten niitä jaetaan
Itsenäinen taito toimii ChatGPT:n työpöytäsovelluksessa, Codexissä komentorivin kautta ja sen editorilaajennuksessa; Codexissä projektin taidot sijoitetaan repositorion .agents/skills-kansioon. Jotta taito olisi muiden saatavilla, OpenAI suosittelee sen pakkaamista lisäosaksi (plugin): lisäosa voi niputtaa useita taitoja ja lisätä yhteyksiä MCP-palvelimiin tai esityselementtejä. Lisäosaan sisällytetyt taidot tulevat sitten saataville Chat- ja Work-tiloissa ChatGPT:ssä verkossa, työpöydällä ja mobiililaitteissa. ChatGPT:ssä verkossa Skills-välilehti lisäosahakemistossa antaa sinun myös luoda taidon keskustelun avulla (käyttäen sisäänrakennettua skill-creator-taitoa), editorilla tai tuomalla sen, sekä jakaa sen työtilassasi; tämä välilehti on varattu oikeutetuille Business-, Enterprise-, Healthcare- ja Edu-suunnitelmille.
Sinun vuorosi
GPT:stä taidoksi. Ota ohjeet GPT:stä, jonka rakensit oppitunneilla 4–7. Muunna ne SKILL.md:ksi: lyhyt nimi, kuvaus, joka kertoo milloin sitä käytetään ja milloin ei, numeroidut vaiheet ja tietotiedostosi, jotka on tallennettu kansioon references/. Testaa sitten taitoa kahdesti: kerran kutsumalla sitä @-merkillä ja kerran tavallisella pyynnöllä, jonka pitäisi käynnistää se.
Viralliset lähteet: Build skills (ChatGPT-dokumentaatio: SKILL.md, kuvaus, sijainnit) · Skills in ChatGPT (OpenAI Help Center: Skills-välilehti, suunnitelmat, jakaminen)
Keskeiset asiat
- Taito on kansio, jossa on
SKILL.md(pakollinen nimi + kuvaus) ja valinnaisia resursseja; se noudattaa avointa agent skills -standardia - Kuvaus ratkaisee, milloin taito valitaan: aloita käyttötarkoituksella, käynnistyssanoilla ja rajoituksilla
- Progressiivinen paljastaminen: vain nimi ja kuvaus luetaan ensin; ohjeet latautuvat käyttöhetkellä
- Jaa taito pakkaamalla se lisäosaksi
Testaa tietämyksesi
GPT:stä lisäosiin: validoimalla koko matka.
1. Custom Instructions, Memory, GPT: mikä on ero?
Vastaus: Custom Instructions sävyttää kaikkia keskustelujasi; Memory tallentaa faktoja sinusta ajan myötä; GPT on paketoitu avustaja – ohjeet, tieto, työkalut – jaettavissa muiden kanssa.
2. Mitä hyvä GPT-järjestelmäohje sisältää?
Vastaus: Roolin, laajuuden (mitä se tekee ja mitä ei), sävyn, vastausmuodon ja poikkeustilanteiden käsittelyn – kirjoitettuna kuin työkuvaus, ei toivelista.
3. Mihin tietokantaa (Knowledge base) käytetään?
Vastaus: Antamaan GPT:lle viiteasiakirjoja, joita se konsultoi vastatessaan – oppaasi, luettelosi tai menettelytapasi, eikä luottamaan pelkästään sen koulutusmuistiin.
4. Mitä GPT:n toiminnoille tapahtuu siirryttäessä lisäosaan?
Vastaus: Niitä ei siirretä: sinun on tarkistettava, onko sovellus jo olemassa lisäosahakemistossa, muuten rakenna integraatio uudelleen, esimerkiksi MCP-palvelimella. Ohjeista tulee taito ja tietokannasta viitetiedostoja.
5. Mitä tarkistat ennen GPT:n tai lisäosan jakamista?
Vastaus: Testit todellisissa tapauksissa ja poikkeustilanteissa, käyttöehtojen noudattaminen, kuvauksen selkeys, tietosuojakäytäntö kaikille julkisille toiminnoille ja sen varmistaminen, ettei ohjeissa tai tiedostoissa piile arkaluonteisia tietoja.
Jaettu työkalu sitoo tekijänsä: testaa ikään kuin käyttäjäsi olisivat jo paikalla, ja siirrä GPT:si ennen 11. joulukuuta 2026.