# Dovednosti Codexu: Jak vytvořit dovednost pro opakující se úkoly > Struktura souboru SKILL.md, cesty načítání, explicitní a automatické vyvolání, kritéria výsledku a přenos dovednosti do Claude Code. Source: https://ailoot.ai/blog/cs/codex-skills/ Canonical: https://ailoot.ai/blog/cs/codex-skills/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-084 Revision: sha256-7e7057c12e98d9f104c2e4127a685ee5df81244ef0ea70c442e48f45d5e64124 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](https://ailoot.ai/blog/cs/openai-codex-install/). [Praktické informace o používání Ailootu najdete v dokumentaci](https://ailoot.ai/docs/). ## Co je dovednost v Codexu?
Hlavní poznatek Dovednost Codexu je složka se souborem `SKILL.md`, který popisuje proces: co dělat, z čeho vycházet a jak vypadá dobrý výsledek. Codex má nejprve v kontextu pouze názvy a popisy dovedností a úplné pokyny načte, až když se rozhodne některou použít.
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](https://ailoot.ai/blog/cs/hermes-agent-skills/). Tento článek se zabývá pouze Codexem. ## Z čeho se skládá dovednost v Codexu?
Hlavní poznatek Dovednost musí obsahovat alespoň jeden soubor `SKILL.md` se dvěma povinnými poli: `name` a `description`. Volitelně můžete přidat složky `scripts/`, `references/` a `assets/` i soubor `agents/openai.yaml` s nastaveními.
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: ```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á?
Hlavní poznatek Codex hledá dovednosti na čtyřech úrovních: ve složce `.agents/skills` projektu (kontroluje aktuální složku a všechny nadřazené složky až po kořen repozitáře), v osobní složce `$HOME/.agents/skills`, v systémové složce `/etc/codex/skills` a mezi vestavěnými dovednostmi OpenAI.
| Úroveň | Cesta | Účel | |----|----|----| | Projekt | `.agents/skills` v aktuální složce a jejích nadřazených složkách až po kořen repozitáře | Dovednosti pro konkrétní projekt, které lze spolu s kódem uložit do gitu | | Uživatel | `$HOME/.agents/skills` | Vaše osobní dovednosti dostupné ve všech projektech na počítači | | Systém | `/etc/codex/skills` | Dovednosti sdílené všemi uživateli počítače nebo kontejneru | | Vestavěné | Součást Codexu | Základní dovednosti od OpenAI, například tvůrce dovedností | 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](https://ailoot.ai/blog/cs/skills-subagents-mcp-plugins-claude-code/). ## Jak Codex rozhoduje, kterou dovednost vyvolat?
Hlavní poznatek Dovednost můžete vyvolat výslovně: v rozhraní Codex CLI nebo IDE zadejte do požadavku `$skill-name` nebo ji vyberte přes `/skills`. Při implicitním vyvolání Codex dovednost vybere automaticky, pokud váš úkol odpovídá jejímu popisu. Dovednost musí být dostupná a automatické vyvolání musí být povoleno.
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`: ```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
Hlavní poznatek Vyberte jeden opakující se úkol, vytvořte dovednost pomocí vestavěného asistenta `$skill-creator` nebo ručně, napište pokyny s jasně určeným výsledkem, vyzkoušejte její vyvolání běžným jazykem a po každém spuštění ji dolaďte.
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
Hlavní poznatek Kritéria přijetí uveďte přímo v dovednosti: co musí výsledek obsahovat a jak má agent před předáním zkontrolovat svou práci. To nezaručuje správnost; výsledek musíte stále zkontrolovat sami.
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: ```markdown ## 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?
Hlavní poznatek Začněte modelem, na kterém dovednost fungovala, a potom vyzkoušejte levnější modely: pokud kvalita zůstane, ponechte si levnější. Níže jsou ceny API a výchozí možnosti pro první spuštění k 20. září 2026.
| Model | Vstup, $/milion tokenů | Výstup, $/milion tokenů | Na čem ho nejprve vyzkoušet | |----|----|----|----| | GPT-6 Astra | 10 | 50 | Dovednosti vyžadující rozsáhlé uvažování, práci s obrázky a prohlížečem | | GPT-5.6 Sol | 4 | 20 | Textové dovednosti střední složitosti | | GPT-5.6 Terra | 2.50 | 15 | Jednoduché procesy s jasným výsledkem | | GPT-5.6 Luna | 0.20 | 1.20 | Mechanické úkoly: přeformátování, výpočty, sestavení seznamu | 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
Hlavní poznatek Vyberte jeden opakující se proces, vytvořte dovednost pomocí `$skill-creator`, vyzkoušejte její vyvolání vlastními slovy a přidejte závěrečný krok s kritérii přijetí. Po několika spuštěních upravte popis a pokyny podle nalezených chyb.
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](https://ailoot.ai/blog/cs/claude-code-skills-library/); srovnání Codexu a Claude Code pak v článku [Codex vs Claude Code](https://ailoot.ai/blog/cs/codex-vs-claude-code-choice/).
### Zdroje - [OpenAI Developers: Tvorba dovedností — dokumentace Codexu](https://developers.openai.com/codex/skills) - [OpenAI Developers: Přehled Codexu](https://developers.openai.com/codex/) - [OpenAI Platform: Modely a sazby API](https://platform.openai.com/docs/models) - [Agent Skills: Otevřený standard a specifikace](https://agentskills.io) - [Dokumentace Anthropic: Rozšíření Claude o dovednosti](https://docs.claude.com/en/docs/claude-code/skills) - [Anthropic Engineering: Tvorba efektivních agentů](https://www.anthropic.com/engineering/building-effective-agents) - [OpenAI Developers: Tvorba pluginů](https://developers.openai.com/plugins/build/plugins)
[Otevřete Ailoot](https://ailoot.ai/). ## Časté otázky ### Proč funguje výslovné vyvolání skillu, ale ne automatický výběr? Ověřte viditelnost skillu v /skills a povolené implicitní vyvolání. Jsou-li obě podmínky splněny, upravte popis tak, aby začínal úkolem a obsahoval slova, která běžně používáte. Potom zopakujte stejné běžné zadání. ### Co ověřit ve výstupu skillu pro prodejní report? Zkontrolujte zahrnutí všech manažerů ze vstupního exportu, shodu celkového součtu se zdrojem, číselné podklady pro každou tvrzenou změnu a uložení požadovaného souboru reportu. Pokud chybí předchozí období, má to report uvést. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.