Dovednosti Codexu: Jak vytvořit dovednost pro opakující se úkoly

Pokud Codexu pětkrát týdně vysvětlujete totéž — jak formátovat zprávu, probírat se e-maily nebo připravit text ve vašem stylu — můžete tyto pokyny jednou sepsat do dovednosti. Potom ji agent může najít podle popisu, pokud popis odpovídá úkolu, nebo ji můžete vyvolat výslovně. Dovednost je obyčejná složka s textovým souborem nazvaným SKILL.md; pro základní použití není potřeba žádné programování.

Níže se podíváme na strukturu dovednosti, na to, kde ji Codex hledá, jak ji krok za krokem vytvořit a jak zvolit model s ohledem na cenu. Příkazy a ceny vycházejí z oficiální dokumentace OpenAI k 20. září 2026. Pokyny k instalaci Codexu zde neopakujeme; najdete je v průvodci Codex od OpenAI: Co to je, jak ho nainstalovat a spustit.

Praktické informace o používání Ailootu najdete v dokumentaci.

Co je dovednost v Codexu?#

Tento formát se nazývá Agent Skills. Jde o otevřený standard, který původně vyvinula společnost Anthropic a zveřejnila na agentskills.io. Podporují jej různí agenti, včetně Codexu, Claude Code a dalších kompatibilních klientů. Jednoduchou dovednost tvořenou pouze textovými pokyny lze mezi nimi přenést zkopírováním složky. Pokud obsahuje skripty, závislosti nebo soubor agents/openai.yaml, po přenosu ji zkontrolujte: některá nastavení jsou specifická pro daného klienta.

Tento způsob načítání se nazývá postupné zpřístupňování. Agent podle názvu a popisu dovednosti určí, kdy je relevantní. Když úkol odpovídá popisu, agent přečte celý soubor SKILL.md a řídí se jím. Díky tomu můžete mít v Codexu desítky dovedností, aniž by se všechny pokyny načítaly do kontextu: počáteční seznam zabírá nejvýše 2 % kontextového okna (nebo 8 000 znaků, pokud velikost okna není známa). Pokud je dovedností mnoho, Codex jejich popisy nejprve zkrátí; při velmi velkém počtu může některé ze seznamu vynechat a upozornit vás.

Dovednost lze snadno zaměnit za AGENTS.md. Codex tento soubor čte při každém sezení v projektu. Obsahuje trvalá pravidla: technologický stack, konvence a styl programování. Dovednost se načítá na vyžádání, když se úkol shoduje s jejím zaměřením. Trvalá pravidla tedy patří do AGENTS.md a opakující se proces s jednotlivými kroky do dovednosti.

Dovednosti Hermes Agent fungují podobně, ale ukládají se do jiných složek a instalují se jiným způsobem. Věnuje se jim samostatný průvodce: Dovednosti Hermes Agent: Instalace a tvorba. Tento článek se zabývá pouze Codexem.

Z čeho se skládá dovednost v Codexu?#

Složka dovednosti má tuto strukturu:

my-skill/
  SKILL.md        - povinné: metadata a pokyny
  scripts/        - volitelné: spustitelný kód
  references/     - volitelné: dokumenty k načtení podle potřeby
  assets/         - volitelné: šablony a zdroje
  agents/
    openai.yaml   - volitelné: vzhled a závislosti

Samotný soubor SKILL.md začíná blokem metadat mezi třemi pomlčkami, za ním následuje text pokynů ve formátu Markdown:

---
name: weekly-sales-report
description: Sestavte týdenní přehled prodeje z exportu CSV. Použijte při žádosti o týdenní přehled prodeje nebo souhrn podle manažera.
---

1. Přečtěte exportní soubor v cestě zadané uživatelem.
2. Seskupte řádky podle manažera a vypočítejte celkovou hodnotu a počet obchodů.
3. Porovnejte výsledek s předchozím týdnem, pokud je soubor za předchozí týden poblíž. Pokud tam není, uveďte to přímo ve zprávě.
4. Uložte výsledek do souboru report.md: tabulku podle manažera, celkovou hodnotu a až tři klíčové změny s čísly, podle toho, kolik jich data dokládají.

Tři pravidla z oficiálních doporučení OpenAI:

• Jedna dovednost, jeden úkol. Místo „Vyřiď všechen můj marketing“ zvolte konkrétní úkol: „Sestav přehled prodeje z tohoto exportu.“ Větší proces rozdělte na samostatné dovednosti, které lze vyvolávat za sebou.
• Pište kroky přímo a s výslovně uvedenými vstupy a výstupy: co použít, co udělat a kam výsledek uložit.
• Začněte textovými pokyny. Skripty ve složce scripts/ použijte, když se nějaký krok musí pokaždé provést naprosto stejně — například převést soubor nebo zavolat externí systém.

Codex vybírá dovednost pro úkol podle pole description, proto začněte popis úkolem a slovy, kterými jej obvykle popisujete.

Kde Codex dovednosti hledá?#

Projektové dovednosti je praktické ukládat do gitu spolu s kódem, aby měl celý tým stejnou sadu. Osobní dovednosti se hodí pro vaše vlastní procesy, například styl e-mailů. Pokud mají dvě dovednosti na různých úrovních stejný název, Codex je nesloučí: obě se zobrazí v seznamu a výběr bude obtížnější. Jejich názvy proto udržujte jedinečné.

Pro srovnání, dovednosti Claude Code se ukládají do složky .claude/skills, každá s vlastním souborem SKILL.md, a používají stejný otevřený standard. Jednoduchou dovednost tam lze přenést zkopírováním složky; potom ji spusťte a ověřte, že se vyvolává. Srovnání rozšíření Claude Code najdete v článku Skills, Subagents, MCP nebo Plugins.

Jak Codex rozhoduje, kterou dovednost vyvolat?#

Výslovné vyvolání je zpočátku spolehlivější: v Codex CLI zadejte $weekly-sales-report a vyberte tak konkrétní proces. Implicitní vyvolání je pohodlnější při každodenní práci. Po napsání dovednosti ji vyzkoušejte běžným jazykem: požádejte Codex, aby úkol provedl vlastními slovy, bez znaku $, a ověřte, zda dovednost vybere. Pokud ji nevybere, nejprve zkontrolujte, zda Codex dovednost vidí v /skills, zda je v některé ze složek, ze kterých se načítají dovednosti, a zda není zakázána dovednost nebo její automatické vyvolání. Pokud je dostupná a nastavení jsou správná, upravte description: uveďte úkol a typické způsoby, jakými se žádost formuluje.

Pokud chcete, aby byla dovednost dostupná pouze prostřednictvím výslovného příkazu, můžete nastavit i toto: v souboru agents/openai.yaml parametr allow_implicit_invocation: false zakáže automatické vyvolání, zatímco $name bude dál fungovat. Dovednost můžete úplně zakázat bez jejího odstranění prostřednictvím souboru ~/.codex/config.toml:

[[skills.config]]
path = "/full/path/to/the/skill/SKILL.md"
enabled = false

Po úpravě config.toml Codex restartujte. Změny ve složkách dovedností Codex zachytí automaticky, ale pokud se nová dovednost nezobrazí, Codex restartujte.

Jak vytvořit vlastní dovednost: krok za krokem#

1. Vyberte jeden úkol

   Zvolte proces, který pravidelně opakujete a který má jasný výsledek: zprávu, tabulku, dopis nebo analýzu. Pokud jste takový výsledek ještě nikdy nedostali, nejprve úkol dokončete ručně s agentem. Získaný výsledek použijte jako měřítko pro pokyny.

2. Vytvořte dovednost

   Chcete-li dovednost vytvořit pomocí vestavěného asistenta, zadejte v sezení Codexu $skill-creator. Zeptá se, co dovednost dělá, kdy se má vyvolat a zda jsou potřeba skripty, a potom za vás připraví její základ. Chcete-li ji vytvořit ručně, vytvořte v projektu složku .agents/skills a v ní podsložku pro dovednost, například .agents/skills/weekly-sales-report, a vložte do ní soubor SKILL.md podle výše uvedeného příkladu.

3. Napište pokyny

   Kroky napište jako číslovaný seznam s výslovnými vstupy a výstupy. Pokud proces vyžaduje přesnost (přenos dat, přejmenování, výpočty), popište podrobně každý krok. U kreativních úkolů (psaní textů, výběr argumentů) stanovte hranice a kritéria dobrého výsledku, ale ponechte modelu prostor k práci.

4. Vyzkoušejte vyvolání

   Požádejte Codex, aby úkol provedl vlastními slovy, aniž byste uvedli název dovednosti. Pokud vybere správnou dovednost, popis pro tuto formulaci funguje. Potom vyzkoušejte výslovné vyvolání pomocí $name. Pokud se dovednost nevyvolá, zkontrolujte složku, zda se zobrazuje v /skills, a nastavení zakázání popsaná výše. Pokud se nová dovednost v seznamu nezobrazí, Codex restartujte. Jestliže výslovné vyvolání funguje a automatické vyvolání je povoleno, ale Codex nereaguje na žádost formulovanou vašimi slovy, upravte začátek description: nejprve uveďte úkol a za ním typické způsoby jeho formulace. Potom test opakujte.

5. Dolaďte ji po spuštěních

   Po každém spuštění zkontrolujte výsledek a řekněte agentovi, co má v dovednosti změnit: „Příště přidej do souhrnné tabulky sloupec s podílem.“ Pokud první verze kreativního úkolu nepřinese požadovaný výsledek, upravte dovednost podle zpětné vazby.

Hotové dovednosti od OpenAI a komunity se instalují pomocí $skill-installer a názvu dovednosti. Chcete-li vlastní dovednosti sdílet s ostatními, distribuujte je jako pluginy — jde o samostatný způsob balení, který při osobním použití není potřeba.

Jak zkontrolovat výsledek agenta#

Kontroly mohou být objektivní nebo subjektivní. Objektivní kontroly lze změřit: „zpráva obsahuje všech 12 manažerů z exportu“ nebo „součet v tabulce odpovídá celkovému součtu v CSV“. Tyto body uveďte jako pevné požadavky. Subjektivní kontroly se týkají kvality: „text zní jako můj“ nebo „závěry jsou stručné“. I ty lze formalizovat: do dovednosti vložte příklad dobré pasáže a požádejte agenta, aby s ním svůj výsledek porovnal.

Užitečnou technikou je cyklus kontroly: po přípravě výsledku agent projde seznam kritérií, opraví vše, co zjistí, a teprve potom vám výsledek ukáže. Anthropic používá podobný vzor nazvaný evaluator-optimizer: jeden agent odvede práci, samostatný hodnotitel ji zkontroluje a vrátí připomínky a proces se opakuje až do přijetí. V rámci jediné dovednosti jde obvykle o zjednodušenou verzi — závěrečnou sebekontrolu podle seznamu. Její omezení mějte na paměti: je slabší než nezávislé hodnocení, protože agent, který práci provedl, si nemusí všimnout vlastní chyby.

Příklad kontrolního bloku pro naši zprávu:

## Před odevzdáním zkontrolujte
- V tabulce jsou všichni manažeři z exportu; nikdo nechybí.
- Celková hodnota odpovídá součtu v CSV až na poslední cent.
- Každá klíčová změna je podložena číslem; pokud nejsou k dispozici srovnávací data, zpráva to uvádí přímo.
- Soubor je uložen v cestě report.md a cesta byla sdílena s uživatelem.

Jaký model pro dovednost zvolit?#

Sloupec úplně vpravo navrhuje úkoly pro počáteční kontroly. Nejde o pořadí modelů ani o výsledek srovnání: vhodný model pro svou dovednost určíte až po spuštění a porovnání s referenčním výsledkem.

Ceny v tabulce jsou sazby API uvedené na stránkách modelů k 20. září 2026, nikoli ceny předplatného ChatGPT. Při použití předplatného se spotřeba řídí jeho limity. K tomuto datu má Sol akční sazbu $4/$20 nejméně do 21. listopadu 2026; standardní cena je $5/$30. Před rozsáhlým opakovaným spuštěním zkontrolujte stránku s cenami: akce OpenAI se mění.

Spusťte stejnou dovednost na následujícím levnějším modelu a porovnejte výsledek s referenčním. Pokud kvalita zůstane, vyzkoušejte další, ještě levnější model. Pokud kvalita klesne, vraťte se k předchozímu. Modely mají také úrovně úsilí: Astra sahá od low po max a řada 5.6 od none po max. Otestujte je také se stejným referenčním výsledkem: nejprve vyberte model a potom úroveň úsilí.

Pravidelné používání dovednosti znamená opakující se náklady. Vstupní cena Astry je 50krát vyšší než u Luny, takže používání různých modelů pro tutéž opakovanou dovednost může vést ke znatelně odlišným nákladům. U dovednosti, která analyzuje snímky obrazovky a dokumenty, může slabší model vyjít dráž kvůli nutným opravám.

Časté chyby při tvorbě a používání dovednosti#

• Dovednost „na všechno“. Jeden proces, jedna dovednost — to doporučuje i OpenAI. Univerzální desetistránkovou dovednost je obtížné přesně popsat a Codex vybírá dovednost pro úkol podle jejího popisu.
• Vágní popis. „Pomáhá se zprávami“ neříká, pro jaký typ zpráv je dovednost určena. Na začátek description uveďte úkol a obvyklé způsoby jeho formulace.
• Pokyny bez definovaného výsledku. Pokud neurčíte, co se má vytvořit a kam to uložit, výsledky se mohou při jednotlivých spuštěních lišit.
• Žádné kontroly. Bez závěrečného kroku s kritérii může být výsledkem nedokončený návrh, který budete muset celý zkontrolovat sami.
• Ve výchozím nastavení nejvýkonnější model. Nejprve ověřte, zda úkol zvládne levnější model: spusťte na něm stejnou dovednost a porovnejte výsledek s referenčním. Přepněte pouze tehdy, pokud kvalita zůstane.
• Stejné názvy v různých složkách. Codex dovednosti se stejným názvem neslučuje, takže výběr té správné je obtížnější.

Jak začít a přenést dovednost do Claude Code#

Pokud pracujete s více agenty, můžete složku obsahující pouze textové pokyny a soubor SKILL.md přenést do Claude Code. Tam se dovednosti ukládají do .claude/skills a vyvolávají se pomocí /name. Pokud dovednost obsahuje skripty, závislosti nebo agents/openai.yaml, po přenosu ji zkontrolujte. Průvodce knihovnou dovedností Claude Code najdete v článku Dovednosti Claude Code: Jak si vytvořit vlastní sadu; srovnání Codexu a Claude Code pak v článku Codex vs Claude Code.

Otevřete Ailoot.