Vytvoření dovednosti pomocí SKILL.md
Na této stránce
Lekce aktualizována 2. listopadu 2026 na základě stránky Skills v dokumentaci Vibe: dovednost je sada pokynů (nepřidává nástroje),
allowed-toolsse čte, ale nevynucuje, a byla přidána dvě nová pole (disable-model-invocation,compatibility). Zdroj: Skills.
Dovednosti: Opakovaně použitelné komponenty
Agenti definují, kdo úkol provádí. Dovednosti definují co: jsou to opakovaně použitelné sady pokynů, které přidávají do Mistral Vibe procedury a lomítkové příkazy. Rozdíl je zřejmý, když ho aplikuješ na svůj tým – agent odráží osobní pracovní styl, zatímco dovednost zapouzdřuje postup, který musí všichni provádět stejným způsobem.
Dovednost je adresář obsahující soubor SKILL.md s YAML frontmatterem. Tato struktura vychází z otevřené specifikace Agent Skills, což činí dovednosti přenositelnými a sdílitelnými: stejná složka funguje na počítači tvého kolegy bez jakýchkoli úprav.
Anatomie souboru SKILL.md
Zde je úplná struktura dovednosti ilustrovaná na příkladu automatizované kontroly kódu:
---
name: code-review
description: Performs automated code reviews with quality analysis
license: MIT
user-invocable: true
allowed-tools:
- read_file
- grep
- ask_user_question
---
# Code Review Skill
This skill analyzes source code quality by checking:
1. **Naming conventions** — variables, functions, classes
2. **Cyclomatic complexity** — functions that are too long or nested
3. **Duplication** — copy-pasted code to refactor
4. **Security** — dangerous patterns (eval, SQL injection, XSS)
## Usage
Run `/code-review` followed by the path or description of the code to analyze.
## Output format
The report is structured in three levels:
- 🔴 **Critical** — fix immediately
- 🟡 **Warning** — fix before merging
- 🟢 **Suggestion** — optional improvement
Pole ve frontmatteru YAML
Pole name je jedinečný identifikátor dovednosti. Používá se k povolení, zakázání a odkazování na dovednost v konfiguracích. Tento název se také stává lomítkovým příkazem, proto stojí za to udržet ho stručný.
name: code-review
Pole description (až 1 024 znaků) je fráze, která se zobrazí, když Vibe vypíše dostupné dovednosti. Piš ji z pohledu někoho, kdo hledá: měla by mu umožnit vybrat si mezi dvěma podobnými dovednostmi bez nutnosti otevírat soubory.
description: Performs automated code reviews with quality analysis
Pole license uvádí licenci dovednosti, což je důležité zejména tehdy, když ji sdílíš mimo svou vlastní pracovní stanici.
license: MIT
Booleovská hodnota user-invocable, která je ve výchozím nastavení true, zpřístupňuje dovednost jako lomítkový příkaz. Nastav ji na false, pokud ji chceš skrýt z nabídky /: agent ji může stále automaticky načíst, když se hodí k danému úkolu.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Pole disable-model-invocation, pokud je nastaveno na true, zabrání agentovi v automatickém načtení dovednosti: spustí se pouze tehdy, když sám zadáš /skill-name. Vyhraď si toto nastavení pro postupy, které by žádný model neměl spouštět bez tvého výslovného souhlasu, například nasazení.
disable-model-invocation: true
Seznam doplňují dvě informační pole: compatibility, které uvádí předpoklady („Requires git“), a allowed-tools, které vypisuje nástroje, které dovednost plánuje použít. U tohoto druhého buď opatrný: dokumentace specifikuje, že Vibe toto pole čte, ale nevynucuje ho. Dovednost může volat jakýkoli nástroj, který povoluje aktivní agent. Pokud chceš omezit, co může dovednost dělat, musíš omezit nástroje a oprávnění samotného agenta (lekce 2 a 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Tělo souboru SKILL.md
Za frontmatterem následuje tělo souboru ve volném formátu Markdown. Slouží zároveň jako dokumentace i prompt: Vibe ho čte, aby pochopil, jak dovednost funguje a v jakém kontextu ji použít. Zde popisuješ, co dovednost dělá, kroky jejího fungování, očekávaný formát výstupu a příklady použití. Vágní tělo vede k nepředvídatelné dovednosti; přesné tělo vytváří dovednost, která produkuje stejný výsledek týden co týden.
Vytvoření první dovednosti
Vytvořme si dovednost pro generování testů. Začni vytvořením jejího adresáře:
mkdir -p ~/.vibe/skills/test-generator
Umísti do něj následující SKILL.md. Všimni si, jak tělo odpovídá na otázky, které by jinak musel Vibe hádat: který framework vybrat, jak pojmenovat bloky, kam zapsat výstupní soubor.
---
name: test-generator
description: Generates unit tests for TypeScript/JavaScript functions
license: MIT
user-invocable: true
allowed-tools:
- read_file
- write_file
- grep
---
# Test Generator
Generates comprehensive unit tests for
TypeScript and JavaScript functions.
## Process
1. Read the target source file
2. Identify all exported functions
3. For each function, generate:
- Happy path test
- Test with empty/null inputs
- Edge case tests
- Expected error tests
4. Write tests to an adjacent `.test.ts` file
## Conventions
- Framework: Vitest (default) or Jest if detected
- Naming: `describe` per function, `it` per test case
- Assertions: `expect` with precise matchers
- No mocks unless necessary (external dependencies)
## Example
For a file `utils/math.ts` containing `add(a, b)`,
the skill generates `utils/math.test.ts` with corresponding tests.
Jakmile je soubor vytvořen, je dovednost okamžitě k dispozici: žádný instalační příkaz, žádný restart. Spusť Vibe a zavolej ji na reálný soubor.
vibe
# > /test-generator src/utils/math.ts
Vibe načte dovednost, přečte její SKILL.md, aby pochopil očekávané chování, a provede úkol pomocí autorizovaných nástrojů. Vezmi si čas na prostudování výsledku: porovnáním výstupu s tím, co jsi očekával, vyladíš tělo souboru.
Osvědčené postupy
Dodržuj pravidlo jedna dovednost na jednu funkci. Míchání kontroly kódu a generování testů v jediném souboru vytváří prompt, který tápe, a brání ti vypnout jednu část, aniž bys ztratil druhou. Podobně omez autorizované nástroje pouze na ty, které dovednost skutečně potřebuje.
Zbytek závisí na kvalitě psaní. Tělo SKILL.md je tvůj prompt: buď přesný a zahrň konkrétní příklady toho, co dovednost produkuje – jeden příklad výstupu má větší hodnotu než tři řádky popisu. Nakonec svou dovednost otestuj na několika případech, včetně nějakého záludného, než ji sdílíš s týmem.
Klíčové poznatky
- Dovednost je adresář se souborem
SKILL.mdobsahujícím YAML frontmatter - Frontmatter definuje název, popis, povolené nástroje a možnost vyvolání
- Tělo v Markdown slouží jako dokumentace i jako prompt pro Vibe
user-invocable: truezpřístupňuje dovednost prostřednictvím lomítkového příkazu- Vytvářej specializované dovednosti s minimem nezbytných nástrojů