# Codex Skills: Vytvorenie skillu na opakujúce sa úlohy > Štruktúra SKILL.md, cesty načítania, explicitné a automatické vyvolanie, kritériá výsledku a prenos skillu do Claude Code. Source: https://ailoot.ai/blog/sk/codex-skills/ Canonical: https://ailoot.ai/blog/sk/codex-skills/ Language: sk Publisher: Ailoot (https://ailoot.ai/) Translation: guide-084 Revision: sha256-36c2050bef567f942e47776f0b11a126588cc536c522990d4a82c2f93b5f8de3 Ak musíte Codexu päťkrát týždenne vysvetľovať to isté — ako formátovať správu, triediť e-maily alebo pripraviť text vo vašom štýle — môžete si tieto pokyny raz zapísať do skillu. Potom ho agent nájde podľa jeho opisu, keď opis zodpovedá úlohe, alebo ho môžete vyvolať výslovne. Skill je obyčajný priečinok s textovým súborom s názvom `SKILL.md`; na základné použitie netreba programovať. Nižšie sa venujeme tomu, ako je skill štruktúrovaný, kde ho Codex hľadá, ako ho krok za krokom vytvoriť a ako vybrať model podľa ceny. Príkazy a ceny vychádzajú z oficiálnej dokumentácie OpenAI platnej k 20. septembru 2026. Pokyny na inštaláciu Codexu tu neopakujeme; nájdete ich v príručke [Codex by OpenAI: What It Is, How to Install and Run It](https://ailoot.ai/blog/sk/openai-codex-install/). [Praktické informácie o používaní Ailootu nájdete v dokumentácii](https://ailoot.ai/docs/). ## Čo je skill v Codexe?
Kľúčový poznatok Skill v Codexe je priečinok so súborom `SKILL.md`, ktorý opisuje postup: čo treba urobiť, z čoho pritom vychádzať a ako vyzerá dobrý výsledok. Codex si najprv ponechá v kontexte iba názvy a opisy skillov a úplné pokyny načíta, keď sa rozhodne niektorý použiť.
Tento formát sa volá Agent Skills. Ide o otvorený štandard, ktorý pôvodne vyvinula spoločnosť Anthropic a zverejnila na agentskills.io. Podporujú ho rôzni agenti vrátane Codexu, Claude Code a ďalších kompatibilných klientov. Jednoduchý skill pozostávajúci iba z textových pokynov možno medzi nimi preniesť skopírovaním priečinka. Ak obsahuje skripty, závislosti alebo súbor `agents/openai.yaml`, po prenose ho skontrolujte: niektoré nastavenia sú špecifické pre konkrétneho klienta. Tento spôsob načítavania sa nazýva progressive disclosure. Agent používa názov a opis skillu na určenie, kedy je relevantný. Keď úloha zodpovedá opisu, agent si prečíta celý súbor `SKILL.md` a riadi sa ním. V Codexe tak môžete mať desiatky skillov bez toho, aby sa všetky pokyny načítali do kontextu: úvodný zoznam zaberá najviac 2 % kontextového okna (alebo 8 000 znakov, ak veľkosť okna nie je známa). Ak máte veľa skillov, Codex najprv skráti ich opisy; pri veľmi veľkom počte môže niektoré zo zoznamu vynechať a upozorniť vás. Skill si možno ľahko pomýliť so súborom `AGENTS.md`. Codex číta tento súbor pri každej projektovej relácii. Obsahuje trvalé pravidlá: technologický balík, konvencie a štýl kódu. Skill sa načíta na požiadanie, keď mu zodpovedá úloha. Trvalé pravidlá preto umiestnite do súboru `AGENTS.md` a opakujúci sa postup s jednotlivými krokmi do skillu. Skills pre Hermes Agent fungujú podobne, ale ukladajú sa do iných priečinkov a inštalujú sa inak. Venuje sa im samostatná príručka: [Hermes Agent Skills: Installation and Creation](https://ailoot.ai/blog/sk/hermes-agent-skills/). Tento článok sa zaoberá výlučne Codexom. ## Z čoho sa skladá skill?
Kľúčový poznatok Skill má minimálne jeden súbor `SKILL.md` s dvoma povinnými poľami: `name` a `description`. Voliteľne môžete pridať priečinky `scripts/`, `references/` a `assets/`, ako aj súbor `agents/openai.yaml` s nastaveniami.
Priečinok skillu má takúto štruktúru: ``` my-skill/ SKILL.md - required: metadata and instructions scripts/ - optional: executable code references/ - optional: documents to load as needed assets/ - optional: templates and resources agents/ openai.yaml - optional: appearance and dependencies ``` Samotný súbor `SKILL.md` sa začína blokom metadát ohraničeným tromi pomlčkami, po ktorom nasleduje text pokynov vo formáte Markdown: ```markdown --- name: weekly-sales-report description: Zostavte týždennú správu o predaji z exportu CSV. Použite pri žiadosti o týždennú správu o predaji alebo súhrn podľa manažéra. --- 1. Prečítajte exportovaný súbor na ceste, ktorú poskytol používateľ. 2. Zoskupte riadky podľa manažéra a vypočítajte celkový súčet a počet obchodov. 3. Porovnajte údaje s predchádzajúcim týždňom, ak je súbor za predchádzajúci týždeň nablízku. Ak tam nie je, uveďte to v správe priamo. 4. Uložte výsledok do report.md: tabuľku podľa manažéra, celkový súčet a najviac tri kľúčové zmeny s číselnými údajmi, podľa toho, koľko ich údaje podporujú. ``` Tri pravidlá z oficiálnych odporúčaní OpenAI: - Jeden skill, jedna úloha. Namiesto „Vyrieš celý môj marketing“ si vyberte konkrétnu úlohu: „zostav správu o predaji z tohto exportu“. Väčší proces rozdeľte na samostatné skilly, ktoré možno vyvolávať postupne. - Jednotlivé kroky formulujte priamo a jasne určte vstupy a výstupy: čo použiť, čo urobiť a kam umiestniť výsledok. - Začnite textovými pokynmi. Skripty v priečinku `scripts/` používajte vtedy, keď sa krok musí zakaždým vykonať úplne rovnakým spôsobom — napríklad pri konverzii súboru alebo volaní externého systému. Codex vyberá skill pre danú úlohu podľa poľa `description`, preto začnite opis úlohou a slovami, ktorými ju zvyčajne opisujete. ## Kde Codex hľadá skilly?
Kľúčový poznatok Codex hľadá skilly na štyroch úrovniach: v priečinku projektu `.agents/skills` (kontroluje aktuálny priečinok a každý nadradený priečinok až po koreňový priečinok repozitára), v osobnom priečinku `$HOME/.agents/skills`, v systémovom priečinku `/etc/codex/skills` a medzi vstavanými skillmi OpenAI.
| Úroveň | Cesta | Účel | |----|----|----| | Projekt | `.agents/skills` v aktuálnom priečinku a jeho nadradených priečinkoch až po koreňový priečinok repozitára | Skilly pre konkrétny projekt, ktoré možno uložiť do gitu spolu s kódom | | Používateľ | `$HOME/.agents/skills` | Vaše osobné skilly dostupné vo všetkých projektoch na danom počítači | | Systém | `/etc/codex/skills` | Skilly zdieľané všetkými používateľmi počítača alebo kontajnera | | Vstavané | Sú súčasťou Codexu | Základné skilly od OpenAI, napríklad tvorca skillov | Projektové skilly je praktické ukladať do gitu spolu s kódom, aby mal celý tím rovnakú sadu. Osobné skilly sa hodia na vlastné postupy, napríklad váš štýl e-mailovej komunikácie. Ak majú dva skilly na rôznych úrovniach rovnaký názov, Codex ich nespojí: oba sa zobrazia v zozname a výber bude náročnejší. Názvy preto udržiavajte jedinečné. Pre porovnanie, skilly Claude Code sa ukladajú do priečinka `.claude/skills`, každý s vlastným súborom `SKILL.md`, a používajú rovnaký otvorený štandard. Jednoduchý skill tam možno preniesť skopírovaním jeho priečinka. Potom ho spustite a skontrolujte, či sa vyvolá. Porovnanie rozšírení Claude Code nájdete v článku [Skills, Subagents, MCP, or Plugins](https://ailoot.ai/blog/sk/skills-subagents-mcp-plugins-claude-code/). ## Ako Codex rozhoduje, ktorý skill vyvolať?
Kľúčový poznatok Skill môžete vyvolať výslovne: v Codex CLI alebo rozšírení pre IDE zadajte do požiadavky `$skill-name` alebo ho vyberte cez `/skills`. Pri implicitnom vyvolaní Codex vyberie skill automaticky, ak úloha zodpovedá jeho opisu. Skill musí byť dostupný a automatické vyvolávanie musí byť povolené.
Výslovné vyvolanie je spočiatku spoľahlivejšie: v Codex CLI zadajte `$weekly-sales-report` a vyberte tak konkrétny postup. Implicitné vyvolanie je pohodlnejšie pri každodennej práci. Po napísaní skillu ho otestujte bežnou formuláciou: vlastnými slovami požiadajte Codex, aby vykonal danú úlohu, bez znaku `$`, a sledujte, či vyberie skill. Ak ho nevyberie, najprv skontrolujte, či Codex vidí skill v `/skills`, či sa skill nachádza v jednom z priečinkov načítavania a či skill alebo jeho automatické vyvolávanie nie sú vypnuté. Ak je dostupný a nastavenia sú správne, spresnite `description`: uveďte úlohu a obvyklé spôsoby formulovania požiadavky. Ak chcete, aby bol skill dostupný iba cez výslovný príkaz, môžete nastaviť aj to: parameter `allow_implicit_invocation: false` v súbore `agents/openai.yaml` vypne automatické vyvolanie, no `$name` bude naďalej fungovať. Skill môžete úplne vypnúť bez toho, aby ste ho odstránili, prostredníctvom súboru `~/.codex/config.toml`: ```toml [[skills.config]] path = "/full/path/to/the/skill/SKILL.md" enabled = false ``` Po úprave súboru `config.toml` reštartujte Codex. Codex zmeny v priečinkoch skillov zachytáva automaticky, ale ak sa nový skill nezobrazí, reštartujte Codex. ## Ako si vytvoriť vlastný skill: krok za krokom
Kľúčový poznatok Vyberte si jednu opakujúcu sa úlohu, vytvorte skill pomocou vstavaného asistenta `$skill-creator` alebo manuálne, napíšte pokyny s jasne určeným výsledkom, otestujte vyvolanie bežnou formuláciou a po každom spustení skill dolaďte.
1. ### Vyberte si jednu úlohu Vyberte si postup, ktorý pravidelne opakujete a ktorý má jasný výsledok: správu, tabuľku, list alebo analýzu. Ak ste taký výsledok ešte nikdy nedostali, najprv úlohu dokončite manuálne s agentom. Výsledok použite ako referenčný štandard pre pokyny. 2. ### Vytvorte skill Ak chcete vytvoriť skill pomocou vstavaného asistenta, v relácii Codex zadajte `$skill-creator`. Asistent sa opýta, čo skill robí, kedy sa má vyvolať a či sú potrebné skripty, a potom za vás pripraví jeho základ. Ak ho chcete vytvoriť manuálne, v projekte vytvorte priečinok `.agents/skills` s podpriečinkom pre daný skill, napríklad `.agents/skills/weekly-sales-report`, a vložte doň súbor `SKILL.md` podľa vyššie uvedeného príkladu. 3. ### Napíšte pokyny Jednotlivé kroky napíšte ako číslovaný zoznam s výslovne určeným vstupom a výstupom. Ak si proces vyžaduje presnosť (prenos údajov, premenovanie, výpočty), podrobne opíšte každý krok. Pri tvorivých úlohách (písanie textov, výber argumentov) stanovte hranice a kritériá dobrého výsledku, no nechajte modelu priestor na prácu. 4. ### Otestujte vyvolanie Požiadajte Codex, aby vykonal úlohu vlastnými slovami, bez uvedenia názvu skillu. Ak vyberie správny skill, opis funguje pre danú formuláciu. Potom otestujte výslovné vyvolanie pomocou `$name`. Ak sa skill nevyvolá, skontrolujte priečinok, či sa zobrazuje v `/skills`, a vyššie uvedené nastavenia vypnutia. Ak sa nový skill nezobrazí v zozname, reštartujte Codex. Ak výslovné vyvolanie funguje a automatické vyvolávanie je povolené, no Codex nereaguje na požiadavku formulovanú vašimi slovami, upravte začiatok poľa `description`: najprv uveďte úlohu a potom bežné spôsoby jej formulovania. Otestujte znova. 5. ### Dolaďte ho po spusteniach Po každom spustení skontrolujte výsledok a povedzte agentovi, čo má v skille zmeniť: „Nabudúce pridaj do súhrnnej tabuľky stĺpec s podielom.“ Ak prvá verzia pri tvorivej práci neprinesie výsledok, ktorý potrebujete, upravte skill na základe spätnej väzby. Hotové skilly od OpenAI a komunity sa inštalujú pomocou `$skill-installer` a názvu skillu. Ak chcete svoje skilly zdieľať s inými ľuďmi, distribuujte ich ako plugins — ide o samostatný spôsob balenia, ktorý nie je potrebný na osobné použitie. ## Ako skontrolovať výsledok agenta
Kľúčový poznatok Kritériá prijatia uveďte priamo v skille: čo musí výsledok obsahovať a ako má agent skontrolovať svoju prácu pred odovzdaním. Nezaručuje to správnosť; výsledok aj tak musíte skontrolovať sami.
Kontroly môžu byť objektívne alebo subjektívne. Objektívne kontroly sú merateľné: „správa obsahuje všetkých 12 manažérov z exportu“ alebo „súčet v tabuľke sa zhoduje s celkovým súčtom v CSV“. Zapíšte ich ako pevné požiadavky. Subjektívne kontroly sa týkajú kvality: „text znie ako môj“ alebo „závery sú stručné“. Aj tie môžete formalizovať: do skillu vložte príklad kvalitnej pasáže a požiadajte agenta, aby s ním porovnal svoj výsledok. Užitočnou technikou je cyklus kontroly: po príprave výsledku agent prejde zoznam kritérií, opraví všetko, čo zistí, a až potom vám ho ukáže. Anthropic používa podobný vzor s názvom evaluator-optimizer: jeden agent vykoná prácu, samostatný hodnotiteľ ju skontroluje a vráti spätnú väzbu, pričom sa proces opakuje až do prijatia výsledku. V rámci jediného skillu ide zvyčajne o zjednodušenú verziu — záverečnú vlastnú kontrolu podľa zoznamu. Majte na pamäti jej obmedzenie: je slabšia než nezávislé hodnotenie, pretože agent, ktorý prácu vykonal, si nemusí všimnúť vlastnú chybu. Príklad kontrolného bloku pre našu správu: ```markdown ## Pred odovzdaním skontrolujte - V tabuľke je uvedený každý manažér z exportu; nikto nechýba. - Celkový súčet sa zhoduje so súčtom v CSV až do posledného centu. - Každú kľúčovú zmenu podporuje číselný údaj; ak nie sú k dispozícii porovnávacie údaje, správa to priamo uvádza. - Súbor je uložený v report.md a jeho cesta bola zdieľaná s používateľom. ``` ## Ktorý model si vybrať pre skill?
Kľúčový poznatok Začnite s modelom, na ktorom skill fungoval, a potom vyskúšajte lacnejšie modely: ak sa kvalita zachová, ponechajte si lacnejší. Nižšie uvádzame ceny API a východiskové možnosti pre prvé spustenia — platné k 20. septembru 2026.
| Model | Vstup, $/milión tokenov | Výstup, $/milión tokenov | Na čom ho najprv vyskúšať | |----|----|----|----| | GPT-6 Astra | 10 | 50 | Skilly vyžadujúce rozsiahle uvažovanie, prácu s obrázkami a používanie browsera | | GPT-5.6 Sol | 4 | 20 | Textové skilly strednej zložitosti | | GPT-5.6 Terra | 2.50 | 15 | Jednoduché postupy s jasným výsledkom | | GPT-5.6 Luna | 0.20 | 1.20 | Mechanické úlohy: preformátovanie, výpočty, zostavenie zoznamu | Stĺpec úplne vpravo navrhuje úlohy na úvodné kontroly. Nejde o rebríček ani výsledok porovnania: správny model pre svoj skill môžete určiť až po jeho spustení a porovnaní s referenčným výsledkom. Ceny v tabuľke sú sadzby API uvedené na stránkach modelov k 20. septembru 2026, nie ceny predplatného ChatGPT. Pri použití predplatného sa spotreba odpočítava z jeho limitov. K tomuto dátumu má Sol akciovú sadzbu $4/$20 najmenej do 21. novembra 2026; štandardná cena je $5/$30. Pred väčším opakovaným spustením skontrolujte stránku s cenami: akcie OpenAI sa menia. Spustite ten istý skill na nasledujúcom lacnejšom modeli a porovnajte výsledok s referenčným štandardom. Ak sa kvalita zachová, skúste ďalší, ešte lacnejší model. Ak kvalita klesne, vráťte sa k predchádzajúcemu. Modely majú aj úrovne úsilia: Astra siaha od low po max a rodina 5.6 od none po max. Aj tie otestujte podľa rovnakého referenčného štandardu: najprv vyberte model a potom úroveň úsilia. Pravidelné používanie skillu znamená opakované náklady. Cena vstupu pre Astra je 50-krát vyššia než pre Luna, takže používanie rôznych modelov pre ten istý opakovaný skill môže viesť k citeľne odlišným nákladom. Pri skille, ktorý analyzuje snímky obrazovky a dokumenty, môže slabší model stáť viac, pretože si vyžiada prepracovanie. ## Časté chyby pri tvorbe a používaní skillu - Skill „na všetko“. Jeden postup, jeden skill — to odporúča aj OpenAI. Univerzálny desaťstranový skill sa ťažko opisuje presne a Codex vyberá skill pre úlohu podľa jeho opisu. - Nejasný opis. „Pomáha so správami“ neobjasňuje, na aké správy je skill určený. Na začiatok poľa `description` dajte úlohu a bežné spôsoby jej formulovania. - Pokyny bez určeného výsledku. Ak neurčíte, čo sa má vytvoriť a kam to umiestniť, výsledky sa môžu pri jednotlivých spusteniach líšiť. - Žiadne kontroly. Bez záverečného kroku s kritériami môže byť výsledkom nedokončený návrh, ktorý budete musieť celý skontrolovať sami. - Najschopnejší model ako predvolená voľba. Najprv zistite, či úlohu zvládne lacnejší model: spustite rovnaký skill a porovnajte výsledok s referenčným štandardom. Prepnite iba vtedy, ak sa zachová kvalita. - Rovnaké názvy v rôznych priečinkoch. Codex nespája skilly s rovnakým názvom, takže výber správneho skillu je náročnejší. ## Ako začať a preniesť skill do Claude Code
Kľúčový poznatok Vyberte si jeden opakujúci sa postup, vytvorte skill pomocou `$skill-creator`, otestujte jeho vyvolanie vlastnými slovami a pridajte záverečný krok s kritériami prijatia. Po niekoľkých spusteniach upravte opis a pokyny podľa chýb, ktoré nájdete.
Ak pracujete s viacerými agentmi, môžete do Claude Code preniesť priečinok obsahujúci iba textové pokyny a súbor `SKILL.md`. Tam sa skilly ukladajú do `.claude/skills` a vyvolávajú sa pomocou `/name`. Po prenose skontrolujte skill, ak obsahuje skripty, závislosti alebo `agents/openai.yaml`. Príručku ku knižnici skillov Claude Code nájdete v článku [Claude Code Skills: How to Build Your Own Set](https://ailoot.ai/blog/sk/claude-code-skills-library/); porovnanie Codexu a Claude Code nájdete v článku [Codex vs Claude Code](https://ailoot.ai/blog/sk/codex-vs-claude-code-choice/).
### Zdroje - [OpenAI Developers: Build skills—Codex documentation](https://developers.openai.com/codex/skills) - [OpenAI Developers: Codex overview](https://developers.openai.com/codex/) - [OpenAI Platform: Models and API rates](https://platform.openai.com/docs/models) - [Agent Skills: Open standard and specification](https://agentskills.io) - [Anthropic Docs: Extend Claude with skills](https://docs.claude.com/en/docs/claude-code/skills) - [Anthropic Engineering: Building effective agents](https://www.anthropic.com/engineering/building-effective-agents) - [OpenAI Developers: Build plugins](https://developers.openai.com/plugins/build/plugins)
[Otvorte Ailoot](https://ailoot.ai/). ## Otázky a odpovede: Codex Skills: Vytvorenie skillu na opakujúce sa úlohy ### Prečo výslovné vyvolanie funguje, ale automatický výber skillu zlyhá? Overte viditeľnosť skillu v /skills a povolenie implicitného vyvolania. Ak sú obe v poriadku, upravte opis: začnite úlohou a pridajte bežne používané slová. Potom znova otestujte rovnakú bežnú požiadavku. ### Čo overiť vo výstupe skillu predajnej správy? Každý manažér zo vstupného exportu musí byť zastúpený, súčet sa musí zhodovať so zdrojom, tvrdené zmeny musia mať podporné čísla a požadovaný súbor musí byť uložený. Ak chýba predchádzajúce obdobie, správa to má uviesť. ## Ailoot · Spoločnosť a jej portfólio projektov Ailoot stavia na dlhodobých prevádzkových skúsenostiach, širokej klientskej základni, stabilných službách a priebežnom sledovaní KPI. Spoločnosť a jej portfólio projektov: milióny zákazníkov; mesačné tržby v miliardách. Ailoot využíva tieto prevádzkové skúsenosti na poskytovanie prístupu cez API k funkciám AI v produktoch zákazníkov, agentoch, aplikáciách a automatizáciách.