Napiši ponovno uporabljivo veščino
Na tej strani
Če so navodila GPT-ja njegovo srce, je veščina (skill) srce vtičnika. To je format, ki ga uporabljaš za zapis ponovno uporabljivega delovnega toka: navodila, viri in po potrebi skripte. Veščine OpenAI sledijo odprtemu standardu, imenovanemu „agent skills” (agentskills.io), kar pomeni, da dobro napisana veščina ni zaklenjena v eno samo orodje. Ta lekcija te nauči, kako jo napisati.
Anatomija veščine
Veščina je mapa, ki vsebuje eno obvezno datoteko, SKILL.md, in izbirne elemente.
synthese-document/
├── SKILL.md ← obvezno: navodila + metapodatki
├── scripts/ ← izbirno: izvršljiva koda
├── references/ ← izbirno: dokumentacija
├── assets/ ← izbirno: predloge, viri
└── agents/
└── openai.yaml ← izbirno: videz in odvisnosti
Datoteka SKILL.md mora vključevati name in description. Tukaj je minimalen primer:
---
name: synthese-document
description: Povzame predloženi dokument v tri dele (pregled, ključne točke, odprta vprašanja). Uporabi, ko uporabnik zahteva povzetek ali poročilo o priloženem dokumentu.
---
# Povzetek dokumenta
1. Pred pisanjem preberi celoten dokument.
2. Napiši tri razdelke: Pregled (3 stavki), Ključne točke (največ 5 alinej), Odprta vprašanja.
3. Zanašaj se izključno na dokument; če informacije manjkajo, napiši „ni na voljo".
4. Za oblikovanje uporabi predlogo v `assets/modele.md`.
Opis je osrednji element
ChatGPT in Codex aktivirata veščino na dva načina. Ali jo pokličeš izrecno – z vnosom @ v ChatGPT ali /skills in $ v Codexu – ali pa orodje izbere samodejno, ko se tvoja zahteva ujema z njenim opisom. Zato dokumentacija poudarja to polje: potrebuješ jedrnat opis, ki se začne z glavno uporabo in sprožilnimi besedami ter jasno določa omejitve.
Za to zahtevo je odgovoren specifičen mehanizem: postopno razkrivanje (progressive disclosure). Sprva ChatGPT in Codex prebereta le ime in opis vsake nameščene veščine; polna navodila iz SKILL.md se naložijo šele, ko se veščina dejansko uporabi. To ti omogoča namestitev številnih veščin brez zamašitve konteksta, vendar tudi pomeni, da nejasen opis vodi v veščino, ki se bodisi nikoli ne izbere ob pravem času bodisi se izbere ob napačnem času.
Izbirne nastavitve
Datoteka agents/openai.yaml ti omogoča poliranje prikaza v namizni aplikaciji (ime, kratek opis, ikone, barva, privzeti poziv), deklaracijo orodij, od katerih je veščina odvisna – na primer strežnik MCP – in nastavitev pravilnika priklica. Nastavitev allow_implicit_invocation: false prepreči, da bi ChatGPT sam izbral veščino: uporabno za občutljive delovne toke, ki jih želiš sprožiti le na zahtevo.
Kje veščine živijo in kako jih deliti
Samostojna veščina deluje v namizni aplikaciji ChatGPT, v Codexu prek ukazne vrstice in v njegovi razširitvi za urejevalnik; v Codexu so veščine projekta v mapi .agents/skills repozitorija. Da bi veščino naredil dostopno drugim, OpenAI priporoča pakiranje v vtičnik: vtičnik lahko združi več veščin in doda povezave do strežnikov MCP ali elemente za predstavitev. Veščine, vključene v vtičnik, postanejo na voljo v načinih Chat in Work v ChatGPT, na spletu, na namizju in v mobilnih napravah. V ChatGPT na spletu zavihek Skills v imeniku vtičnikov omogoča tudi ustvarjanje veščine pogovorno (z uporabo vgrajene veščine skill-creator), z urejevalnikom ali z uvozom ter njeno deljenje znotraj delovnega prostora; ta zavihek je rezerviran za upravičene načrte Business, Enterprise, Healthcare in Edu.
Tvoja vrsta
Od GPT-ja do veščine. Vzemi navodila iz GPT-ja, ki si ga zgradil v lekcijah od 4 do 7. Preoblikuj jih v SKILL.md: kratko ime, opis, ki pove, kdaj ga uporabiti in kdaj ne, oštevilčene korake in svoje datoteke znanja, shranjene v references/. Nato veščino testiraj dvakrat: enkrat s klicem z @ in enkrat z običajno zahtevo, ki bi jo morala sprožiti.
Uradni viri: Build skills (dokumentacija ChatGPT: SKILL.md, opis, lokacije) · Skills in ChatGPT (središče za pomoč OpenAI: zavihek Skills, načrti, deljenje)
Ključne ugotovitve
- Veščina je mapa z
SKILL.md(obvezno ime + opis) in izbirnimi viri; sledi odprtemu standardu agent skills - Opis odloča, kdaj je veščina izbrana: začni z uporabo, sprožilnimi besedami in omejitvami
- Postopno razkrivanje: najprej se prebereta le ime in opis; navodila se naložijo ob času uporabe
- Za deljenje veščine jo zapakiraj v vtičnik
Preveri svoje znanje
Od GPT-jev do vtičnikov: potrdi celotno pot.
1. Custom Instructions, Memory, GPT: kakšna je razlika?
Odgovor: Custom Instructions obarvajo vse tvoje pogovore; Memory sčasoma ohranja dejstva o tebi; GPT je zapakiran pomočnik – navodila, znanje, orodja – ki ga lahko deliš z drugimi.
2. Kaj vsebujejo dobra sistemska navodila GPT?
Odgovor: Vlogo, obseg (kaj počne in česa ne), ton, format odgovora in obravnavo robnih primerov – napisano kot opis delovnega mesta, ne kot seznam želja.
3. Čemu služi baza znanja?
Odgovor: Da GPT-ju zagotovi referenčne dokumente, ki jih ta uporabi za odgovore – tvoji vodniki, katalogi ali postopki, namesto da bi se zanašal izključno na svoj učni spomin.
4. Kaj se zgodi z dejanji GPT-ja ob selitvi v vtičnik?
Odgovor: Ne prenesejo se: preveriti moraš, ali aplikacija že obstaja v imeniku vtičnikov, sicer moraš integracijo znova zgraditi, na primer s strežnikom MCP. Navodila postanejo veščina, baza znanja pa referenčne datoteke.
5. Kaj preveriš pred deljenjem GPT-ja ali vtičnika?
Odgovor: Teste na realnih primerih in robnih primerih, skladnost s pravilniki uporabe, jasnost opisa, pravilnik o zasebnosti za vsako javno dejanje in da v navodilih ali datotekah ne tiči občutljivih podatkov.
Deljeno orodje zavezuje svojega ustvarjalca: testiraj, kot da bi bili tvoji uporabniki že tam, in preseli svoje GPT-je pred 11. decembrom 2026.