Codex Skills: Vytvorenie skillu na opakujúce sa úlohy

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.

Praktické informácie o používaní Ailootu nájdete v dokumentácii.

Čo je skill v Codexe?#

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. Tento článok sa zaoberá výlučne Codexom.

Z čoho sa skladá skill?#

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:

---
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?#

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.

Ako Codex rozhoduje, ktorý skill vyvolať?#

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:

[[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#

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#

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:

## 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?#

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#

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; porovnanie Codexu a Claude Code nájdete v článku Codex vs Claude Code.

Otvorte Ailoot.