Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Kirjoita uudelleenkäytettävä taito

Oppitunti 17 / 17 Päivitetty 5. marraskuuta 2026 Keskitasoinen
Tällä sivulla
  1. Taidon anatomia
  2. Kuvaus on keskeisin osa
  3. Valinnaiset asetukset
  4. Missä taidot sijaitsevat ja miten niitä jaetaan
  5. Sinun vuorosi
  6. Keskeiset asiat
  7. Testaa tietämyksesi

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.

Taidon anatomia Kolme laatikkoa: SKILL.md, pakollinen, sisältää nimen, kuvauksen ja ohjeet; references-kansio, valinnainen, viitetiedostoille; scripts-kansio, valinnainen, automatisoiduille vaiheille. YKSI KANSIO, YKSI PAKOLLINEN TIEDOSTO Taidon anatomia 1 SKILL.md Nimi, kuvaus, ohjeet. Pakollinen 2 references/ Viitetiedostot. Valinnainen 3 scripts/ Automatisoidut vaiheet. Valinnainen Kuvaus ratkaisee, milloin taito käynnistyy: kerro milloin taitoa käytetään ja milloin ei käytetä.
Perustuu Build skills -sivuun ChatGPT:n dokumentaatiossa (marraskuu 2026).

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.