# Codex Skills: Ustvarjanje veščine za ponavljajoče se naloge > Zgradba datoteke SKILL.md, poti za nalaganje, izrecni in samodejni priklic, merila za rezultat ter prenos veščine v Claude Code. Source: https://ailoot.ai/blog/sl/codex-skills/ Canonical: https://ailoot.ai/blog/sl/codex-skills/ Language: sl Publisher: Ailoot (https://ailoot.ai/) Translation: guide-084 Revision: sha256-2bd6342fb93a72fe493275e8ec4c7d0c53fb631627f8229306bd2421539cfbec Če Codexu petkrat na teden razložite isto—kako oblikovati poročilo, pregledati e-pošto ali pripraviti besedilo v vašem slogu—lahko ta navodila enkrat zapišete v veščino. Nato jo lahko agent poišče na podlagi opisa, kadar se opis ujema z nalogo, ali pa jo prikličete izrecno. Veščina je običajna mapa z besedilno datoteko z imenom `SKILL.md`; za osnovno uporabo ne potrebujete programiranja. Spodaj obravnavamo zgradbo veščine, mesta, kjer jo Codex išče, njeno postopno ustvarjanje in izbiro modela glede na stroške. Ukazi in cene temeljijo na uradni dokumentaciji OpenAI z dne 20. septembra 2026. Navodil za namestitev Codexa tukaj ne ponavljamo; najdete jih v vodniku [Codex podjetja OpenAI: kaj je, kako ga namestiti in zagnati](https://ailoot.ai/blog/sl/openai-codex-install/). [Praktične informacije o uporabi Ailoota so na voljo v dokumentaciji](https://ailoot.ai/docs/). ## Kaj je veščina v Codexu?
Ključna ugotovitev Veščina Codex je mapa z datoteko `SKILL.md`, ki opisuje proces: kaj je treba narediti, na čem naj temelji in kako je videti dober rezultat. Codex sprva v kontekstu hrani samo imena in opise veščin, celotna navodila pa naloži, ko se odloči, da bo veščino uporabil.
Ta oblika se imenuje Agent Skills. Gre za odprt standard, ki ga je prvotno razvil Anthropic in objavil na agentskills.io. Podpirajo ga različni agenti, med njimi Codex, Claude Code in drugi združljivi odjemalci. Preprosto veščino, ki vsebuje samo besedilna navodila, lahko prenesete med njimi tako, da kopirate mapo. Če vsebuje skripte, odvisnosti ali datoteko `agents/openai.yaml`, po prenosu preverite veščino: nekatere nastavitve so specifične za posameznega odjemalca. Ta način nalaganja se imenuje postopno razkrivanje. Agent na podlagi imena in opisa veščine ugotovi, kdaj je ta ustrezna. Ko se naloga ujema z opisom, agent prebere celotno datoteko `SKILL.md` in upošteva njena navodila. Tako lahko v Codexu hranite na desetine veščin, ne da bi v kontekst naložili vsa navodila: začetni seznam zasede največ 2 % kontekstnega okna (ali 8.000 znakov, če velikost okna ni znana). Če je veščin veliko, Codex najprej skrajša njihove opise; pri zelo velikem naboru lahko nekatere izpusti s seznama in vas o tem obvesti. Veščino je lahko zamenjati za `AGENTS.md`. Codex to datoteko prebere v vsaki projektni seji. Vsebuje stalna pravila: tehnološki sklad, konvencije in slog kodiranja. Veščina se naloži po potrebi, ko se naloga ujema z njo. Zato stalna pravila umestite v `AGENTS.md`, ponavljajoči se proces s koraki pa v veščino. Veščine Hermes Agent delujejo podobno, vendar so shranjene v drugih mapah in se nameščajo drugače. Opisane so v ločenem vodniku: [Hermes Agent Skills: namestitev in ustvarjanje](https://ailoot.ai/blog/sl/hermes-agent-skills/). Ta članek obravnava samo Codex. ## Iz česa je sestavljena veščina?
Ključna ugotovitev Veščina ima vsaj eno datoteko `SKILL.md` z dvema obveznima poljema: `name` in `description`. Po želji lahko dodate mape `scripts/`, `references/` in `assets/` ter datoteko `agents/openai.yaml` z nastavitvami.
Mapa veščine ima naslednjo strukturo: ``` my-skill/ SKILL.md - obvezno: metapodatki in navodila scripts/ - izbirno: izvršljiva koda references/ - izbirno: dokumenti za nalaganje po potrebi assets/ - izbirno: predloge in viri agents/ openai.yaml - izbirno: videz in odvisnosti ``` Datoteka `SKILL.md` se začne z blokom metapodatkov med tremi vezaji, ki mu sledi besedilo navodil v Markdownu: ```markdown --- name: weekly-sales-report description: Sestavi tedensko poročilo o prodaji iz izvoza CSV. Uporabi, ko kdo zahteva tedensko poročilo o prodaji ali povzetek po vodji. --- 1. Preberi izvoženo datoteko na poti, ki jo je navedel uporabnik. 2. Vrstice združi po vodji ter izračunaj skupni znesek in število poslov. 3. Primerjaj s prejšnjim tednom, če je datoteka za prejšnji teden v bližini. Če je ni, to jasno povej v poročilu. 4. Rezultat shrani v report.md: tabelo po vodjih, skupni znesek in do tri ključne spremembe s številkami, kolikor jih podpirajo podatki. ``` Tri pravila iz uradnih priporočil OpenAI: - Ena veščina, ena naloga. Namesto »Uredi vse moje trženje« izberi konkretno nalogo: »sestavi prodajno poročilo iz tega izvoza«. Večji proces razdeli na ločene veščine, ki jih je mogoče priklicati zaporedno. - Korake zapiši neposredno, z jasno določenimi vhodi in izhodi: kaj uporabiti, kaj narediti in kam shraniti rezultat. - Začni z besedilnimi navodili. Skripte v `scripts/` uporabi, kadar se mora korak vsakič izvesti povsem enako—na primer za pretvorbo datoteke ali klic zunanjega sistema. Codex za nalogo izbere veščino na podlagi polja `description`, zato opis začnite z nalogo in besedami, ki jih običajno uporabljate za njen opis. ## Kje Codex išče veščine?
Ključna ugotovitev Codex išče veščine na štirih ravneh: v projektni mapi `.agents/skills` (preveri trenutno mapo in vse nadrejene mape do korena repozitorija), v osebni mapi `$HOME/.agents/skills`, v sistemski mapi `/etc/codex/skills` in med vgrajenimi veščinami OpenAI.
| Raven | Pot | Namen | |----|----|----| | Projekt | `.agents/skills` v trenutni mapi in njenih nadrejenih mapah do korena repozitorija | Veščine za določen projekt, ki jih lahko shranite v git skupaj s kodo | | Uporabnik | `$HOME/.agents/skills` | Vaše osebne veščine, na voljo v vseh projektih na računalniku | | Sistem | `/etc/codex/skills` | Veščine, ki si jih delijo vsi uporabniki računalnika ali vsebnika | | Vgrajeno | Priloženo Codexu | Osnovne veščine OpenAI, na primer ustvarjalnik veščin | Projektne veščine je priročno hraniti v gitu skupaj s kodo, da ima celotna ekipa enak nabor. Osebne veščine so primerne za vaše lastne procese, na primer slog e-pošte. Če imata dve veščini na različnih ravneh isto ime, ju Codex ne združi: obe se pojavita na seznamu, zato je izbira težja. Imeni naj bosta različni. Za primerjavo: veščine Claude Code so shranjene v `.claude/skills`, vsaka ima svojo datoteko `SKILL.md` in uporablja isti odprti standard. Preprosto veščino lahko prenesete tja s kopiranjem njene mape, nato pa jo zaženite in preverite, ali se prikliče. Za primerjavo razširitev Claude Code glejte [Skills, Subagents, MCP ali Plugins](https://ailoot.ai/blog/sl/skills-subagents-mcp-plugins-claude-code/). ## Kako Codex izbere veščino za priklic?
Ključna ugotovitev Veščino lahko prikličete izrecno: v Codex CLI ali razširitvi IDE v zahtevo vnesite `$skill-name` ali jo izberite prek `/skills`. Pri implicitnem priklicu Codex samodejno izbere veščino, če se vaša naloga ujema z njenim opisom. Veščina mora biti na voljo, samodejni priklic pa mora biti dovoljen.
Izrecni priklic je na začetku zanesljivejši: v Codex CLI vnesite `$weekly-sales-report`, da izberete ta konkretni proces. Implicitni priklic je priročnejši za vsakodnevno delo. Ko napišete veščino, jo preizkusite z običajnim besedilom: prosite Codex, naj opravi nalogo z vašimi besedami, brez `$`, in preverite, ali izbere veščino. Če je ne, najprej preverite, ali Codex vidi veščino v `/skills`, ali je veščina v eni od map za nalaganje ter ali veščina oziroma njen samodejni priklic ni onemogočen. Če je veščina na voljo in so nastavitve pravilne, izboljšajte `description`: navedite nalogo in običajne načine oblikovanja zahteve. Če želite, da je veščina na voljo samo prek izrecnega ukaza, lahko nastavite tudi to: parameter `allow_implicit_invocation: false` v `agents/openai.yaml` onemogoči samodejni priklic, `$name` pa še vedno deluje. Veščino lahko povsem onemogočite, ne da bi jo izbrisali, z datoteko `~/.codex/config.toml`: ```toml [[skills.config]] path = "/full/path/to/the/skill/SKILL.md" enabled = false ``` Po urejanju datoteke `config.toml` znova zaženite Codex. Codex spremembe v mapah veščin zazna samodejno, če pa se nova veščina ne prikaže, znova zaženite Codex. ## Kako ustvariti lastno veščino: korak za korakom
Ključna ugotovitev Izberite eno ponavljajočo se nalogo, ustvarite veščino z vgrajenim pomočnikom `$skill-creator` ali ročno, napišite navodila z jasno opredeljenim rezultatom, preizkusite priklic z običajnim besedilom in veščino po vsaki izvedbi izpopolnite.
1. ### Izberite eno nalogo Izberite proces, ki ga redno ponavljate in ima jasen rezultat: poročilo, tabelo, pismo ali analizo. Če takšnega rezultata še niste prejeli, najprej nalogo ročno opravite z agentom. Dobljeni rezultat uporabite kot merilo za navodila. 2. ### Ustvarite veščino Če želite veščino ustvariti z vgrajenim pomočnikom, v sejo Codexa vnesite `$skill-creator`. Vprašal vas bo, kaj veščina počne, kdaj naj se prikliče in ali so potrebne skripte, nato pa bo pripravil ogrodje. Če jo želite ustvariti ročno, v projektu ustvarite mapo `.agents/skills` s podmapo za veščino, na primer `.agents/skills/weekly-sales-report`, in vanjo po zgornjem primeru dodajte datoteko `SKILL.md`. 3. ### Napišite navodila Korake zapišite kot oštevilčen seznam z izrecno določenimi vhodi in izhodi. Če proces zahteva natančnost (prenos podatkov, preimenovanje, računanje), podrobno opišite vsak korak. Pri ustvarjalnih nalogah (pisanje besedil, izbira argumentov) določite omejitve in merila dobrega rezultata, modelu pa pustite prostor za delo. 4. ### Preizkusite priklic Prosite Codex, naj opravi nalogo z vašimi besedami, ne da bi navedli ime veščine. Če izbere pravo veščino, je opis ustrezal tej formulaciji. Nato preizkusite izrecni priklic z `$name`. Če se veščina ne prikliče, preverite mapo, ali se pojavi v `/skills`, in nastavitve onemogočanja, opisane zgoraj. Če se nova veščina ne prikaže na seznamu, znova zaženite Codex. Če izrecni priklic deluje in je samodejni priklic dovoljen, Codex pa se na zahtevo, zapisano z vašimi besedami, ne odzove, izboljšajte začetek polja `description`: najprej navedite nalogo, nato pa običajne načine njenega opisa. Znova preizkusite. 5. ### Izboljšujte po izvedbah Po vsaki izvedbi preglejte rezultat in agentu povejte, kaj naj spremeni v veščini: »Naslednjič v zbirno tabelo dodaj stolpec, ki prikazuje delež.« Če prva različica ne da rezultata, ki ga potrebujete, veščino za ustvarjalno delo izboljšajte na podlagi povratnih informacij. Vnaprej pripravljene veščine OpenAI in skupnosti namestite z `$skill-installer` in imenom veščine. Če želite svojo veščino deliti z drugimi, jo distribuirajte kot vtičnik—gre za ločen način pakiranja, ki ga za osebno uporabo ne potrebujete. ## Kako preveriti rezultat agenta
Ključna ugotovitev Merila sprejemljivosti vključite neposredno v veščino: kaj mora rezultat vsebovati in kako naj agent pred predajo preveri svoje delo. To ne zagotavlja pravilnosti; rezultat morate še vedno preveriti sami.
Preverjanja so lahko objektivna ali subjektivna. Objektivna preverjanja so merljiva: »poročilo vključuje vseh 12 vodij iz izvoza« ali »vsota v tabeli se ujema s skupno vsoto v CSV-ju.« Zapišite jih kot stroge zahteve. Subjektivna preverjanja se nanašajo na kakovost: »Besedilo zveni, kot da sem ga napisal jaz« ali »sklepi so kratki.« Tudi te lahko formalizirate: v veščino vključite primer dobrega odlomka in prosite agenta, naj svoj rezultat primerja z njim. Uporabna tehnika je cikel pregleda: agent po pripravi rezultata pregleda seznam meril, popravi vse, kar odkrije, in vam ga pokaže šele nato. Anthropic uporablja podoben vzorec, imenovan evaluator-optimizer: en agent opravi delo, ločen ocenjevalec ga pregleda in posreduje povratne informacije, postopek pa se ponavlja do sprejetja. Znotraj ene same veščine je to običajno poenostavljena različica—končni samopregled po seznamu. Upoštevajte omejitev: šibkejši je od neodvisnega ocenjevalca, ker agent, ki je opravil delo, morda ne bo opazil lastne napake. Primer bloka za preverjanje našega poročila: ```markdown ## Pred oddajo preveri - V tabeli so vsi vodje iz izvoza; nihče ni izpuščen. - Skupni znesek se do zadnjega centa ujema z vsoto v CSV-ju. - Vsako ključno spremembo podpirajo številke; če ni podatkov za primerjavo, poročilo to jasno pove. - Datoteka je shranjena kot report.md, pot do nje pa je bila posredovana uporabniku. ``` ## Kateri model izbrati za veščino?
Ključna ugotovitev Začnite z modelom, na katerem je veščina delovala, nato pa preizkusite cenejše modele: če se kakovost ohrani, obdržite cenejšega. Cene API-ja in izhodišča za prve izvedbe so navedeni spodaj; stanje na 20. september 2026.
| Model | Vhod, $/milijon žetonov | Izhod, $/milijon žetonov | Za kaj ga najprej preizkusiti | |----|----|----|----| | GPT-6 Astra | 10 | 50 | Veščine, ki vključujejo daljše sklepanje, slike in uporabo brskalnika | | GPT-5.6 Sol | 4 | 20 | Besedilne veščine srednje zahtevnosti | | GPT-5.6 Terra | 2.50 | 15 | Preprosti procesi z jasnim rezultatom | | GPT-5.6 Luna | 0.20 | 1.20 | Mehanske naloge: preoblikovanje, računanje, sestavljanje seznama | Skrajni desni stolpec predlaga naloge za začetno preverjanje. Ne gre za razvrstitev ali rezultat primerjave: pravi model za svojo veščino lahko določite šele, ko jo zaženete in rezultat primerjate z referenčnim. Cene v tabeli so cene API-ja s strani modelov na dan 20. septembra 2026, ne cene naročnin na ChatGPT. Pri uporabi naročnine se poraba odšteva od njenih omejitev. Na ta datum ima Sol promocijsko ceno $4/$20, ki velja vsaj do 21. novembra 2026; običajna cena je $5/$30. Pred obsežno ponavljajočo se izvedbo preverite cenik: promocije OpenAI se spreminjajo. Isto veščino zaženite na naslednjem cenejšem modelu in primerjajte rezultat z referenčnim. Če se kakovost ohrani, preizkusite naslednjega, še cenejšega. Če kakovost pade, se vrnite na prejšnjega. Modeli imajo tudi ravni napora: Astra sega od low do max, družina 5.6 pa od none do max. Tudi te preizkusite z isto referenco: najprej izberite model, nato raven napora. Redno izvajanje veščine pomeni ponavljajoče se stroške. Vhodna cena Astre je 50-krat višja od Lunine, zato lahko uporaba različnih modelov za isto ponavljajočo se veščino povzroči opazno različne stroške. Pri veščini za analizo posnetkov zaslona in dokumentov je lahko šibkejši model dražji zaradi dodatnega dela. ## Pogoste napake pri ustvarjanju in uporabi veščine - Veščina »za vse«. En proces, ena veščina—to priporoča tudi OpenAI. Univerzalno desetstransko veščino je težko natančno opisati, Codex pa veščino za nalogo izbere na podlagi njenega opisa. - Nejasen opis. »Pomaga pri poročilih« ne pojasni, za kakšna poročila je veščina namenjena. Na začetek polja `description` postavite nalogo in običajne načine njenega opisa. - Navodila brez določenega rezultata. Če ne določite, kaj je treba ustvariti in kam to shraniti, se lahko rezultati med izvedbami razlikujejo. - Brez preverjanj. Brez zadnjega koraka z merili je lahko rezultat nedokončan osnutek, ki ga boste morali sami v celoti pregledati. - Privzeta uporaba najzmogljivejšega modela. Najprej preverite, ali nalogo zmore cenejši model: zaženite isto veščino in primerjajte rezultat z referenčnim. Zamenjajte model le, če se kakovost ohrani. - Enaka imena v različnih mapah. Codex veščin z enakim imenom ne združi, zato je težje izbrati pravo. ## Kako začeti in prenesti veščino v Claude Code
Ključna ugotovitev Izberite en ponavljajoči se proces, ustvarite veščino z `$skill-creator`, preizkusite priklic z lastnimi besedami in dodajte zadnji korak z merili sprejemljivosti. Po nekaj izvedbah izpopolnite opis in navodila glede na odkrite napake.
Če delate z več agenti, lahko v Claude Code prenesete mapo, ki vsebuje samo besedilna navodila in datoteko `SKILL.md`. Tam so veščine shranjene v `.claude/skills` in se prikličejo z `/name`. Po prenosu preverite veščino, če vsebuje skripte, odvisnosti ali `agents/openai.yaml`. Vodnik po knjižnici veščin Claude Code najdete v [Claude Code Skills: kako zgraditi lastno zbirko](https://ailoot.ai/blog/sl/claude-code-skills-library/); primerjavo Codexa in Claude Code pa v [Codex vs Claude Code](https://ailoot.ai/blog/sl/codex-vs-claude-code-choice/).
### Viri - [OpenAI Developers: izdelava veščin—dokumentacija Codexa](https://developers.openai.com/codex/skills) - [OpenAI Developers: pregled Codexa](https://developers.openai.com/codex/) - [OpenAI Platform: modeli in cene API-ja](https://platform.openai.com/docs/models) - [Agent Skills: odprti standard in specifikacija](https://agentskills.io) - [Anthropic Docs: razširite Claude z veščinami](https://docs.claude.com/en/docs/claude-code/skills) - [Anthropic Engineering: gradnja učinkovitih agentov](https://www.anthropic.com/engineering/building-effective-agents) - [OpenAI Developers: izdelava vtičnikov](https://developers.openai.com/plugins/build/plugins)
[Odprite Ailoot](https://ailoot.ai/). ## Vprašanja in odgovori: Codex Skills: Ustvarjanje veščine za ponavljajoče se naloge ### Zakaj izrecni klic deluje, samodejna izbira spretnosti pa ne? Preverite, da je spretnost vidna v /skills in da je implicitni klic omogočen. Če je oboje pravilno, opis izboljšajte tako, da začne z nalogo in vsebuje besede, ki jih običajno uporabljate, nato znova preizkusite isto običajno zahtevo. ### Kaj preverim v izhodu spretnosti za prodajno poročilo? Preverite zastopanost vsakega vodje iz vhodnega izvoza, ujemanje skupne vsote z izvornimi podatki, podporne številke za vsako zatrjevano spremembo ter shranjeno zahtevano poročilo. Če manjka prejšnje obdobje, naj poročilo to pove. ## Ailoot · Podjetje in njegov portfelj projektov Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI. Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah. Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.