Přenositelnost SKILL.md: Technický pohled na Claude Code vs. Codex CLI

Formát SKILL.md je jednoduchý a mocný standard pro rozšiřování schopností kódovacích agentů. Podporují ho jak Claude Code od Anthropic, tak Codex CLI od OpenAI. To vede k zásadní otázce pro vývojáře: běží stejný soubor SKILL.md na obou? Jednoduchá odpověď je ano, soubor samotný je přenositelný. Užitečnější odpověď je složitější a souvisí méně s formátem souboru a více s prostředím pro spouštění, které každý agent poskytuje.

V SkillProof instalujeme a spouštíme dovednosti pro Claude Code na reálné práci, abychom zjistili, zda projdou. Zveřejňujeme výsledky, včetně selhání. Z 2090 dovedností testovaných v prostředí Claude Code jich 1291 prošlo (62 %), 697 fungovalo až po konfiguraci, kterou musí popis explicitně uvést, a 102 skončilo s verdiktem "selhalo": některé se spustily a zanechaly vás v horší situaci, než kdybyste žádnou dovednost nepoužili, jiné se nespustily vůbec kvůli chybějícímu CLI, mrtvé závislosti nebo příkladu, který padá. Nikdy jsme nespustili žádnou dovednost na Codex CLI. Celý náš soubor dat je založen na spouštění v Claude Code.

Náš testovací korpus však obsahuje unikátní, jednosměrnou sadu důkazů. Tento článek zkoumá technické rozdíly ve způsobu, jakým oba agenti zpracovávají SKILL.md, a co naše data, pocházející pouze z Claude, odhalují o přenositelnosti z Codexu do Claude.

Společný základ: Formát SKILL.md

Než začneme porovnávat agenty, je nezbytné pochopit, co je soubor SKILL.md. Je to textový soubor, který kombinuje instrukce pro agenta s metadaty. Struktura je jednoduchá:

1. YAML Frontmatter: Blok na začátku souboru, ohraničený ---, obsahuje páry klíč–hodnota. Základní jsou name a description. Agent používá popis k rozhodnutí, kdy dovednost vyvolat. Volitelný klíč allowed-tools jmenuje nástroje, které chce mít dovednost předem schválené, aby se nezastavovala a neptala se uprostřed běhu. Jde o pole pro pohodlí, ne o sandbox: neodebírá modelu nástroje. Podrobný rozpis najdete v naší referenci frontmatteru.
2. Tělo v Markdownu: Pod frontmatterem se nachází sada instrukcí pro agenta, napsaná v prostém markdownu. Ta modelu říká, jak úkol splnit, krok za krokem.
3. Přibalené soubory: Dovednost může obsahovat další soubory, jako jsou skripty nebo referenční data, které jsou s ní zabaleny.

Zásadní je, že SKILL.md neobsahuje žádné signatury funkcí ani schémata argumentů. Je to formát instrukcí v přirozeném jazyce, ne strukturovaný manifest pro volání funkcí. To je doména MCP, samostatného a odlišného protokolu. Pro hlubší pohled na toto téma si přečtěte naše srovnání Claude Skills vs. MCP.

Protože SKILL.md je jen strukturovaný text, jakýkoli kompatibilní parser ho dokáže přečíst. Jak Claude Code, tak Codex CLI mohou načíst stejný soubor bez úprav. Rozdíl je v tom, co se stane potom.

Načítání a spouštění: Dvě různá prostředí

Zatímco soubor je stejný, kontext, ve kterém běží, nikoli. Architektura agenta, výchozí nastavení a dostupné nástroje definují prostředí pro spouštění. Zde se objevují praktické rozdíly mezi Claude Code a OpenAI Codex.

Claude Code

V naší práci testujeme výhradně s Claude Code. Dovednosti se načítají z ~/.claude/skills pro osobní dovednosti a z .claude/skills uvnitř projektu pro ty vázané na repozitář. Když agentovi zadáte úkol, porovná váš prompt s polem description všech dostupných dovedností. Můžete také jednu přímo zavolat jménem pomocí příkazu s lomítkem.

Jedno kritické chování, které jsme zdokumentovali, je jeho režim selhání. Pokud je YAML frontmatter v souboru SKILL.md chybně zformátován – špatně umístěný tabulátor, chybějící uvozovka – Claude Code nevygeneruje validační chybu. Dovednost se pro agenta jednoduše stane neviditelnou. Nebude uvedena v seznamu a nikdy se nespustí. Toto tiché selhání může být obtížné ladit, což je téma, kterému se věnujeme v našem příspěvku o tom, co dělat, když se dovednost nespouští.

Naše metodika zahrnuje spuštění každé dovednosti na reálném úkolu. Výsledky z našich 2090 testů ukazují, že verdikt 'prošlo' není zaručen. Těch 697 dovedností, které skončily s verdiktem 'vyžaduje nastavení', potřebovalo netriviální konfiguraci, kterou jsme museli zdokumentovat. Těch 102, které 'selhaly', se buď nespustily vůbec kvůli chybějícím závislostem, nebo vytvořily výsledek horší, než kdyby se žádná dovednost nepoužila.

Codex CLI

Codex CLI je open-source terminálový kódovací agent od OpenAI. Není to obal na API; je to samostatný nástroj, který čte kódovou základnu, provádí úpravy ve více souborech a spouští příkazy ve vašem lokálním prostředí. Podporu SKILL.md přidal v prosinci 2025, původně jako experimentální funkci.

Cesty pro objevování dovedností se od té doby změnily, což je dobré vědět, pokud se řídíte starším návodem. Aktuální dokumentace OpenAI uvádí .agents/skills v pracovním adresáři a jeho nadřazených adresářích pro dovednosti vázané na repozitář, $HOME/.agents/skills pro osobní a /etc/codex/skills pro celosystémové dovednosti. Původní umístění ~/.codex/skills je to, které stále uvidíte ve většině README souborů dovedností třetích stran. Dovednost lze vyvolat explicitně napsáním $ a výběrem ze seznamu, nebo se může spustit implicitně, pokud úkol odpovídá jejímu popisu.

Jeho hlavní konfigurační soubor je ~/.codex/config.toml a jeho základní sadu instrukcí lze přizpůsobit pomocí souboru s názvem AGENTS.md. To poskytuje jiný vstupní bod pro přizpůsobení ve srovnání s modelem Claude Code, který je zaměřený na dovednosti.

Podporuje tedy Codex SKILL.md? Ano, nativně. Formát souboru je plnohodnotnou součástí. Odlišnost pochází z prostředí, které pro spuštění tohoto souboru poskytuje.

Jednosměrná přenositelnost: Co ukazují naše data

Toto je jádro problému. Nikdy jsme netestovali žádnou dovednost na Codex CLI. Nemůžeme poskytnout míru úspěšnosti pro Codex ani přímé srovnání na základě našich vlastních testovacích dat. Tvrdit opak by znamenalo vymýšlet si data.

Co můžeme poskytnout, je upřímný pohled na specifický vzorec ve výsledcích našich testů na Claude Code. Z 2090 dovedností, které jsme testovali, naše poznámky ukazují, že 47 z nich zmiňuje nebo předpokládá prostředí Codex. Tyto dovednosti byly napsány pro Codex, ale my jsme je spustili v prostředí Claude Code. To nám dává unikátní, jednosměrný pohled na přenositelnost.

Výsledky pro těchto 47 dovedností jsou:

• Prošlo: 11
• Vyžaduje nastavení: 34
• Selhalo: 2

To říká jasný příběh: soubor SKILL.md napsaný pro Codex bude s vysokou pravděpodobností vyžadovat ruční nastavení, aby běžel na Claude Code. Není to proto, že by soubor byl neplatný, ale protože instrukce dovednosti se spoléhají na nástroje nebo cesty, které v novém prostředí neexistují.

Podívejme se na konkrétní příklady z našeho katalogu:

• Generate 2D Map (Verdikt: Vyžaduje nastavení): README soubor původního projektu explicitně uvádí, že je určen pro Codex/Grok a uvádí instalační cesty ~/.codex/skills a ~/.grok/skills, nikoli ~/.claude/skills, jak tvrdil jeho popis. Jeho hlavní pipeline potřebuje vestavěnou dvojici nástrojů pro generování a prohlížení obrázků, kterou Claude Code nemá. Testovali jsme ho na jediné větvi, která nepotřebuje obrázky – vytváření ortogonální mapy Tiled jako JSON – a dovednost se přesně vyrovnala základnímu modelu: bajtově identická pole dlaždic, identická metadata pro spawn a exit. Soubor se načetl; část, kvůli které se vyplatilo ho instalovat, se nespustila.

• Generate 2D Sprite (Verdikt: Vyžaduje nastavení): Tato dovednost má stejný problém. Je pevně závislá na schopnostech generování obrázků, které jsou součástí Codexu a Groku, ale ne Claude Code. Dokáže naplánovat sprite sheet, ale nedokáže provést poslední krok vytvoření grafiky.

• Ablation Planner (Verdikt: Vyžaduje nastavení): Hlavní mechanika této dovednosti spočívá v předání návrhářské práce specifickému nástroji Codex. Když jsme ji spustili v našem prostředí Claude Code, tento nástroj nebyl k dispozici. Krok musel být proveden ručně, což je definice verdiktu 'vyžaduje nastavení'.

Tyto příklady ukazují, že soubor SKILL.md je přenositelný, ale logika dovednosti být nemusí. Instrukce jsou jen text; pokud agentovi nařizují použít nástroj, který není k dispozici, proces se zastaví.

Naopak, 11 z těchto dovedností orientovaných na Codex prošlo bez problémů. Dovednosti jako Better Codex a PinMe Share prošly našimi testy na Claude Code. Obě mají svou hodnotu v textu, nikoli v nástrojích konkrétního dodavatele. Better Codex je čistě promptová behaviorální nadstavba bez externích souborů nebo skriptů, a přesto porazila základní model v úloze parsování konfigurace, kde základní model tiše selhal na hodnotách obsahujících rovnítko. PinMe Share se instaluje z jediného platného SKILL.md bez visících odkazů a její výhoda spočívá v přesné znalosti běžného npm CLI: vygenerovala kanonický příkaz pro nahrání a požadované kroky pro autentizaci, zatímco základní model příkaz hádal a vynechal přihlášení. To je podoba přenositelné dovednosti. Potřebuje nástroj, který si můžete nainstalovat, ne vestavěný nástroj, který je součástí agenta jednoho dodavatele.

Klíčové rozdíly v kostce

Přímé srovnání zdůrazňuje kompromisy při zvažování codex cli nebo claude code pro kódování s dovednostmi.

Funkce	Claude Code	Codex CLI
Cesta k dovednostem	~/.claude/skills (osobní), .claude/skills (projekt)	$HOME/.agents/skills (osobní), .agents/skills (repozitář), /etc/codex/skills (systém)
Konfigurace	settings.json, plus CLAUDE.md pro instrukce	~/.codex/config.toml, plus AGENTS.md pro instrukce
Sandboxing	Opt-in; proměnné prostředí se dědí z rodičovského shellu	Zapnutý ve výchozím nastavení v režimu zápisu do pracovního prostoru, síť vypnutá, pokud není povolena
Chybně zformátovaný SKILL.md	Načtení tiše selže	(Chování jsme netestovali)

Kompromis v sandboxingu

Nejvýznamnějším rozdílem v prostředích pro spouštění je výchozí chování sandboxingu.

Codex CLI, podle své dokumentace, funguje s přísnějším výchozím bezpečnostním postojem. V jeho režimu zápisu do pracovního prostoru je přístup k síti zakázán, pokud ho explicitně nepovolíte v config.toml. Zápisy do souborového systému jsou omezeny na aktuální pracovní prostor a politika schvalování agenta ve výchozím nastavení vyžaduje potvrzení před provedením akce. Jedná se o model 'default-deny' (vše zakázáno).

Claude Code, jak dokumentuje Anthropic, zaujímá jiný přístup. Sandboxing je něco, co zapínáte, nikoli vypínáte, a i když je zapnutý, shell ve výchozím nastavení dědí prostředí rodičovského procesu. To znamená, že pokud máte ve své terminálové relaci exportované přihlašovací údaje jako AWS_ACCESS_KEY_ID, dovednost vyvolaná Claude Code je může potenciálně přečíst. Díky tomu dovednosti, které komunikují s externími službami nebo lokálními přihlašovacími údaji, fungují ihned po instalaci, a přenáší to na vás břemeno správy tohoto rizika.

Žádný přístup není sám o sobě lepší; je to kompromis. Model Codexu prioritizuje bezpečnost ve výchozím nastavení, což může vyžadovat více konfigurace pro spuštění dovednosti pracující se sítí. Model Claude Code prioritizuje funkčnost ihned po instalaci, což potenciálně odhaluje více z hostitelského prostředí. Dovednost, která volá API pomocí curl, může na Claude Code jednoduše fungovat, ale na Codex CLI bude ve výchozím nastavení zablokována.

Pravidlo pro rozhodování: Posuzujte prostředí, ne soubor

Takže, Claude Code vs Codex CLI: který z nich byste měli používat pro dovednosti?

Naše data poskytují upřímnou, i když neúplnou, odpověď. Samotný formát souboru SKILL.md není rozhodujícím faktorem. Stejný soubor se načte na obou platformách. Skutečné rozhodnutí závisí na prostředí pro spouštění a na závislostech dovedností, které chcete používat.

1. Zkontrolujte závislosti na nástrojích: Spoléhá se dovednost na vestavěné, pro agenta specifické nástroje (jako je generování obrázků v Generate 2D Map)? Pokud ano, nebude přenositelná.
2. Zkontrolujte závislosti na univerzálních CLI: Používá dovednost pouze všudypřítomné nástroje příkazového řádku? Má vysokou šanci na přenositelnost, jak ukázalo 11 dovedností orientovaných na Codex, které prošly v našem prostředí Claude Code.
3. Zvažte své preference ohledně sandboxingu: Dáváte přednost systému, který je ve výchozím nastavení uzamčen a vyžaduje explicitní povolení (Codex CLI)? Nebo dáváte přednost systému, který funguje s menším třením ihned po instalaci, ale dědí váš plný kontext prostředí (Claude Code)?

Nemůžeme vyhlásit univerzálního vítěze, protože jsme netestovali na obou platformách. Volba závisí na vašich specifických potřebách a bezpečnostním postoji. Co můžeme s jistotou říci, je, že předpokládat, že dovednost bude fungovat jen proto, že je soubor SKILL.md kompatibilní, je chyba. Prostředí je všechno.

Související čtení: AGENTS.md vs Claude Skills pokrývá druhou polovinu otázky napříč nástroji – instruktážní soubor, který každý agent čte před načtením jakékoli dovednosti. A pokud si vybíráte mezi terminálovými agenty z jiných důvodů než kvůli dovednostem, Claude Code vs Cursor tento kompromis rozebírá.

V SkillProof je naše hodnota v odstraňování této nejistoty pro ekosystém Claude Code. Provádíme testování za vás. Každý verdikt 'prošlo' v našem katalogu představuje dovednost, kterou jsme nainstalovali a spustili na Claude Code, na reálné práci. Pro kurátorovaný začátek naše balíčky dovedností podle rolí shromažďují deset testovaných dovedností pro jednu pracovní funkci – vývojář, bezpečnostní audit, marketing, design a čtyři další – za 10 dolarů za balíček, přičemž verdikt každé dovednosti je uveden předem.