Proč prompt nestačí: agenti potřebují dovednosti, ne instrukce

Rozdíl mezi promptem a skill je v tom, co se stane po skončení konverzace. Prompt je jednorázová instrukce — napíšete ji, agent ji splní a při dalším sezení začínáte od nuly. Skill je znovupoužitelný soubor pracovního postupu, který leží přímo v projektu. Agent ho načte vždy, když se objeví odpovídající úkol, a pokaždé postupuje stejně.

Čísla to potvrzují. SkillsBench, první peer-reviewed benchmark pro agent skills (únor 2026), testoval 87 úloh napříč 8 doménami. Kurátorované skilly zvedly průměrnou úspěšnost agentů z 33,9 % na 50,5 % — tedy o 16,6 procentního bodu, přičemž u jednotlivých konfigurací se zlepšení pohybovala od +4,1 do +25,7 p.b. Modely, které si zkoušely psát skilly samy, nezaznamenaly žádné spolehlivé zlepšení. Kvalita skillu je rozhodující proměnná.

Co je SKILL.md a jak funguje progressive disclosure

Skill je ve skutečnosti jen složka se souborem SKILL.md. Ten má dvě části: krátkou hlavičku ve formátu YAML s názvem a popisem dovednosti a tělo s instrukcemi v prostém Markdownu. Volitelně může obsahovat složky scripts/ (spustitelný kód), references/ (dokumentace) a assets/ (šablony).

Klíčová vlastnost standardu se jmenuje progressive disclosure — agent nenačítá všechny nainstalované skilly na začátku každého sezení, protože by tím zaplavil kontext. Místo toho funguje systém ve třech úrovních:

• Objevování: na startu sezení čte agent jen název a jednořádkový popis každého skillu (30–50 tokenů za skill)
• Aktivace: když úkol sedí na popis, agent načte celé tělo SKILL.md do kontextu
• Provádění: referenční soubory a skripty se načítají až ve chvíli, kdy je daný krok potřebuje

Díky tomu si můžete nainstalovat desítky skillů, aniž by se agent zpomalil. Formát původně vyvinul Anthropic a v prosinci 2025 ho uvolnil jako otevřený standard. Během tří měsíců ho přijaly OpenAI Codex, Google Gemini CLI, GitHub Copilot, Cursor i VS Code — dnes ho podle oficiálního seznamu podporuje 44 produktů od Databricks po JetBrains Junie.

Co je skill, co prompt a co konfigurační soubor

Tyto tři pojmy se pletou nejčastěji. Prompt je jednorázová instrukce do chatu, která po sezení zmizí. Konfigurační soubor (CLAUDE.md, AGENTS.md, .cursorrules) se agentovi tlačí na začátku každého sezení automaticky — platí vždy a na všechno. Skill sedí mezi nimi: není vždy zapnutý (to by plýtvalo kontextem) ani jednorázový (to by plýtvalo vaší prací). Načítá se na vyžádání, když úkol odpovídá jeho popisu. Odborně se tomu říká push versus pull — konfigurace instrukce tlačí, skilly si agent tahá sám.

Čtyři selhání agentů a skill, který je řeší

Autoři průvodce tvrdí, že agenti selhávají předvídatelně — a že každý z těchto čtyř problémů řeší specifický typ skillu:

• Agent dělá něco jiného, než jste chtěli. Příčinou je nepoměr představ — řeší to „grilling skill", který agenta nutí, aby vás před psaním kódu vyzpovídal a prošel každou větev rozhodovacího stromu.
• Agent je ukecaný. Každé sezení znovu objevuje váš slovník. Řešením je skill sdíleného jazyka, který udržuje glosář (CONTEXT.md) — koncept známý z Domain-Driven Designu jako „ubiquitous language".
• Kód nefunguje. Agent píše naslepo, bez zpětné vazby. Řešením je TDD skill s nevyjednatelným pořadím red–green–refactor.
• Kódová základna se mění v bahno. Agenti zrychlují vznikající entropii. Architektonický skill, spouštěný jednou týdně, hledá místa, kde se moduly dají prohloubit.

Bezpečnost: třetina veřejných skillů má chyby

Komunitní skilly nejsou automaticky důvěryhodné. Výzkum Snyk ToxicSkills z února 2026 našel bezpečnostní chyby ve 36 % zkoumaných skillů, celkem 1 467 zranitelných dovedností, včetně aktivních škodlivých payloadů mířících na uživatele OpenClaw, Claude Code a Cursoru — od exfiltrace dat po prompt injection přesměrovávající agenty na neautorizované příkazy. Než skill nainstalujete, přečtěte celý SKILL.md, projděte každý soubor ve složce scripts/, zjistěte si, kdo ho publikoval, a vyzkoušejte ho nejdřív na nepotřebném projektu. Je to stejná hygiena jako u npm balíčků.

Jak začít a co to znamená pro české vývojáře

Doporučený postup je záměrně skromný: vyberte si jeden problém, který vás stojí nejvíc času, napište jeden SKILL.md pod 30 řádků a týden ho používejte. Své preference pak už nemusíte každé ráno opisovat do chatu — žijí v souborech, které agent vytáhne sám. A protože je formát otevřený, vaše skilly přežijí i přechod mezi nástroji: z Claude Code do Codex, z Cursoru do Gemini CLI.

Pro české a slovenské vývojáře i firmy je podstatné, že podporované nástroje — GitHub Copilot, VS Code, Cursor, Gemini CLI — jsou běžně dostupné na českém trhu a standard je vendor-neutrální. Skilly jsou jen soubory ve vašem repozitáři: verzované v gitu, prohledávatelné a bez nutnosti posílat data do dalšího cloudu. Pro společnosti řešící GDPR je to vítaná změna oproti proprietárním konfiguracím jednotlivých nástrojů. Jediné, co musíte hlídat, je původ komunitních skillů — viz bezpečnostní sekce výše.