Soubor SKILL.md je soubor ve formátu Markdown s krátkou hlavičkou YAML, která učí agenta s umělou inteligencí, jak provádět konkrétní úkol. Je uložen ve složce, volitelně se skripty, referenční dokumentací a šablonami, a agent jej načte pouze tehdy, když si to úkol vyžádá. Soubory SKILL.md se řídí otevřenou specifikací dovedností agenta, takže jedna dovednost funguje napříč mnoha kódovacími agenty. Pro produktové týmy je soubor SKILL.md novými vstupními dveřmi: způsobem, jakým se agent učí správně používat váš produkt. Pro bezpečnostní týmy se jedná o soubor ve formátu prostého textu, který mění, co agent dělá, a zaslouží si stejnou pozornost jako kód.
Co je soubor SKILL.md? #
Agenti umělé inteligence jsou schopní, ale obecní. Vědí, jak psát kód a volat nástroje. Neznají váš proces nasazení, konvence API ani tři příznaky, které vaše CLI potřebuje k bezpečnému běhu v CI. Až donedávna bylo řešením vložit to vše do systémového příkazového řádku, který načítal každou relaci a soutěžil se skutečnou prací o kontext.
Soubor SKILL.md to řeší jinak. Zabalí jednu funkci (nasazení této služby, třídění těchto zjištění, generování této zprávy) do složky, kterou agent může objevit, číst, když je to relevantní, a jinak ignorovat. Formát byl vyvinut společností Anthropic a vydán jako otevřený. standardse Specifikace dovedností agentaa od té doby jej přijal stále větší počet agentů, včetně OpenAI Codex, GitHub Copilot a Cursor.
Tým, který se ptá, co je soubor SKILL.md, se tedy ve skutečnosti ptá na dvě otázky: jak naučíme agenty správně používat naše nástroje a jak zabráníme tomu, aby se agenti učili něco špatného? → Co je zabezpečení s využitím umělé inteligence (AI) od Agentu?
Význam souboru SKILL.md: Co soubor skutečně obsahuje #
Význam souboru SKILL.md je jednodušší než humbuk kolem něj. Dovednost je složka s jedním povinným souborem:

Samotný soubor SKILL.md má dvě části: #
- Tělo Markdownu. Pokyny: kroky, pravidla, příklady a odkazy na podpůrné soubory, které by měl agent otevřít, když je potřebuje.
- Úvodní stránka YAML. Minimálně a
nameadescriptionPopis je nejdůležitějším řádkem v souboru, protože si ho agent přečte, aby rozhodl, zda se daná dovednost vztahuje.
Co neobsahuje: přihlašovací údaje, obchodní logiku, která patří do kódu, ani instrukce, které dávají smysl pouze pro jednu konverzaci.
Proč se soubory SKILL.md staly standard #
Protože kontext je konečný. Každý token utracený za instrukce, které agent nepotřebuje, je token, který nebyl utracený za daný úkol. Dovednosti se načítají ve vrstvách, takže agent jich může nést desítky a neplatit téměř nic, dokud se jedna z nich neprojeví jako relevantní.
Přenositelnost se postarala o zbytek. Dovednost napsaná jednou běží v jakémkoli agentovi, který implementuje danou specifikaci. Pro produktovou společnost to mění ekonomiku podpory agentů: místo jedné integrace na asistenta publikujete jednu dovednost.
A z agentů se stali uživatelé. Vývojáři stále častěji žádají agenta, aby „nastavil skener“ nebo „opravil pipeline„…místo čtení samotné dokumentace. Pokud se agent naučí váš produkt ze zastaralého příspěvku na fóru, bude ho používat špatně. Soubor SKILL.md vám umožňuje rozhodnout, co se agent naučí.
Principem designu je postupné zveřejňování: metadata při spuštění, instrukce při aktivaci, zdroje při spuštění. Proto je také popis tolik důležitý. Vágní popis znamená, že se dovednost nikdy nespustí, nebo se spustí, když by neměla.
Jak strukturovat produkt pro AI agenty
#
Zacházejte s dovednostmi agentů jako s povrchem produktu, se stejnou péčí, jakou věnujete referenci API.
- Jedna dovednost na práci, ne jedna dovednost na produkt. „Konfigurace skenování v CI“ a „třídění nálezů“ jsou oddělené dovednosti. Jedna dovednost, která se snaží pokrýt vše, se spouští nepředvídatelně a nabírá kontext, který načítá.
- Napište popis jako spouštěč. Uveďte, co daná dovednost dělá a kdy ji použít, a to slovy, která uživatelé skutečně píší.
- Udržujte tělo krátké a imperativní. Kroky, guardrails a výchozí hodnoty. Posuňte hloubku do
references/takže se načítá jen když je potřeba. - Vložte deterministickou práci do skriptů. Pokud se musí krok provést pokaždé stejným způsobem (ověření konfigurace, formátování výstupu), odešlete skript místo textu, který musí model interpretovat.
- Zakódujte bezpečnou cestu. Uveďte, co agent nesmí nikdy dělat: přeskočit validaci, zakázat kontroly, používat produkční přihlašovací údaje. Agenti dodržují explicitní pravidla mnohem lépe než implicitní.
- Verze a otestujte ji jako kód. Uchovávejte dovednosti v repozitáři, kontrolujte změny v pull requests a před vydáním je otestovat na reálných úkolech.
Pokud váš produkt zpřístupňuje akce, spárujte dovednost se serverem MCP. MCP dává agentovi přístup k vašim nástrojům; dovednost ho naučí, jak je správně používat. → Co je protokol kontextu modelu (MCP)?
Co není soubor SKILL.md? Sousední termíny
#
Ty se pak pletou, což komplikuje jak diskuze o designu, tak i o recenzi.
- AGENTS.md a CLAUDE.md jsou soubory vždy zapnuté: konvence pro celý repozitář se načítají při každé relaci. Dovednosti se načítají na vyžádání.
- Server MCP zpřístupňuje nástroje a data. Soubor SKILL.md obsahuje znalosti a postupy. Vzájemně se doplňují.
- Systémová výzva je pevná instrukce pro jednu aplikaci. Dovednost je přenositelná a opakovaně použitelná mezi agenty.
- Soubor s pravidly (například soubor s pravidly kurzoru) řídí chování asistenta v rámci jednoho nástroje. Stejný rizikový profil, užší přenositelnost.
- llms.txt pomáhá modelům číst vaši dokumentaci. Dovednost říká agentovi, co s ní má dělat.
Jsou to vrstvy, ne konkurenti. Společné je, že každá z nich je prostý text, který mění činnost agenta umělé inteligence, a každá z nich je obvykle posuzována jako dokumentace.
Standardkteré utvářejí význam rizika v SKILL.md #
Posuzujte zdroj podle statusu publikace, ne podle toho, jak aktuálně zní.
Riziko je zdokumentované, nikoli hypotetické. MITRE ATLAS katalogizuje útok, při kterém skryté instrukce v souboru pravidel vedou asistenta k vygenerování backdooru bez viditelné stopy. Škodlivý soubor SKILL.md funguje stejným způsobem a dovednost, která obsahuje skripty, může spouštět kód i instruovat. Instalace komunitní dovednosti s sebou nese stejnou důvěryhodnost, jakou...cision jako instalace balíčku. → Co je to okamžitá injekce?
Od definice k programu #
Vědět, co je soubor SKILL.md, vám neříká, kolik jich je již ve vašich repozitářích, kdo je přidal ani co mají agenti dělat.
Tato mezera se uzavírá v předvídatelném pořadí. Objevte všechny dovednosti, soubory pravidel a konfigurace MCP v celém kódu, včetně těch, které nikdo nedeklaroval. Analyzujte je jako bezpečnostní artefakty, nikoli jako dokumentaci. Poté udržujte záznamy aktuální, aby auditor nebo pracovník reagující na incidenty mohl vidět, která aktiva agenta existují a jak jsou propojena.
Zabezpečení umělé inteligence Xygeni vytváří tento záznam z vašeho kódu. Dovednosti se nacházejí vedle modelů, datových sad, inferenčních koncových bodů, agentů, MCP serverů, výzev, guardrails a nástroje pro kódování umělé inteligence v průběžném inventáři umělé inteligence, každý s hodnocením rizika, poskytovatelem, typem a přesným umístěním v kódu. Xygeni analyzuje soubory dovedností, soubory pravidel a konfigurace MCP jako bezpečnostní artefakty a označuje škodlivé. Graf umělé inteligence ukazuje, který agent se k danému nástroji dostane, a ze stejného objevu se exportuje strojově čitelný seznam AI-BOM. → Co je to kusovník s umělou inteligencí? a Co je stínová umělá inteligence?
Naplánujte si ukázku abyste viděli dovednosti agenta, které již máte ve svém inventáři AI.
Nejčastější dotazy #
Soubor Markdown, který učí agenta s umělou inteligencí, jak provádět jeden konkrétní úkol, a načítá se pouze tehdy, když se tento úkol objeví.
Ve složce pro každou dovednost, obvykle v repozitáři projektu nebo v konfiguračním adresáři agenta uživatele. Přesné umístění závisí na agentovi.
Ano, pokud oba splňují specifikaci dovedností agenta. Stejný soubor SKILL.md běží v jakémkoli kompatibilním agentovi beze změn.
Pokud vývojáři používají k nastavení nebo provozu vašeho produktu agenty umělé inteligence, ano. Je to nejpřímější způsob, jak zajistit, aby jej agenti používali správně a bezpečně.
Mohou být. Dovednost je instrukce, kterou agent dodržuje, a může sdružovat spustitelné skripty. Prověřujte dovednosti, jako je kód, instalujte komunitní dovednosti pouze ze zdrojů, kterým důvěřujete, a veďte si seznam dovedností, které existují ve vašich repozitářích.
