Vytvorenie zručnosti pomocou SKILL.md
Na tejto strane
Lekcia aktualizovaná 2. novembra 2026 na základe stránky Skills v dokumentácii Vibe: zručnosť je súbor inštrukcií (nepridáva nástroje),
allowed-toolssa číta, ale nevynucuje, a boli pridané dve nové polia (disable-model-invocation,compatibility). Zdroj: Skills.
Zručnosti: Opakovane použiteľné komponenty
Agenti definujú, kto úlohu vykonáva. Zručnosti definujú čo: sú to opakovane použiteľné sady inštrukcií, ktoré pridávajú do Mistral Vibe procedúry a lomkové príkazy. Rozdiel je zrejmý, keď ho aplikuješ na svoj tím – agent odráža osobný pracovný štýl, zatiaľ čo zručnosť encapsuluje procedúru, ktorú musí každý vykonať rovnakým spôsobom.
Zručnosť je adresár obsahujúci súbor SKILL.md s YAML frontmatterom. Táto štruktúra nasleduje otvorenú špecifikáciu Agent Skills, vďaka čomu sú zručnosti prenosné a zdieľateľné: rovnaký priečinok funguje na počítači tvojho kolegu bez potreby úprav.
Anatómia súboru SKILL.md
Tu je kompletná štruktúra zručnosti ilustrovaná na príklade automatizovanej 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
Polia vo YAML frontmatteri
Pole name je jedinečný identifikátor zručnosti. Používa sa na povolenie, zakázanie a odkazovanie na zručnosť v konfiguráciách. Tento názov sa zároveň stáva lomkovým príkazom, preto sa oplatí udržať ho krátky.
name: code-review
Pole description (maximálne 1 024 znakov) je fráza, ktorá sa zobrazí, keď Vibe vypíše dostupné zručnosti. Napíš ju z pohľadu niekoho, kto hľadá riešenie: mala by mu umožniť vybrať si medzi dvoma podobnými zručnosťami bez otvárania súborov.
description: Performs automated code reviews with quality analysis
Pole license uvádza licenciu zručnosti, čo nadobúda na význame hneď, ako ju začneš zdieľať mimo svojho vlastného pracoviska.
license: MIT
Booleovská hodnota user-invocable, ktorá je predvolene nastavená na true, vystavuje zručnosť ako lomkový príkaz. Ak ju nastavíš na false, skryješ ju z ponuky /: agent ju však môže stále automaticky načítať, keď sa hodí k danej úlohe.
user-invocable: true # Prístupné cez /code-review
user-invocable: false # Skryté z ponuky /, agent ju môže stále načítať
Pole disable-model-invocation, ak je nastavené na true, zabráni agentovi samostatne načítať zručnosť: spustí sa iba vtedy, ak sám zadáš /názov-zručnosti. Vyhradzuj to pre procedúry, ktoré by žiadny model nemal spustiť bez tvojho výslovného súhlasu, napríklad nasadenie (deployment).
disable-model-invocation: true
Zoznam uzatvárajú dva informačné údaje: compatibility, ktorý uvádza požiadavky („Requires git“), a allowed-tools, ktorý vymenúva nástroje, ktoré zručnosť plánuje použiť. Pri tomto druhom buď opatrný: dokumentácia špecifikuje, že Vibe ho číta, ale nevynucuje. Zručnosť môže volať akýkoľvek nástroj, ktorý povoľuje aktívny agent. Ak chceš obmedziť, čo môže zručnosť robiť, musíš obmedziť nástroje a oprávnenia samotného agenta (lekcie 2 a 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Telo súboru SKILL.md
Za frontmatterom nasleduje telo súboru voľného formátu Markdown. Slúži zároveň ako dokumentácia aj prompt: Vibe ho číta, aby pochopil, ako zručnosť funguje a v akom kontexte ju má aplikovať. Tu opisuješ, čo zručnosť robí, kroky jej činnosti, očakávaný formát výstupu a príklady použitia. Vágne telo vytvára nepredvídateľnú zručnosť; presné telo vytvára zručnosť, ktorá produkuje rovnaký výsledok týždeň čo týždeň.
Vytvorenie tvojej prvej zručnosti
Vytvorme si zručnosť na generovanie testov. Začni vytvorením jej adresára:
mkdir -p ~/.vibe/skills/test-generator
Vlož doň nasledujúci súbor SKILL.md. Všimni si, ako telo odpovedá na otázky, ktoré by inak musel Vibe hádať: ktorý framework zvoliť, ako pomenovať bloky, kam zapísať výstupný súbor.
---
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.
Akonáhle je súbor vytvorený, zručnosť je okamžite dostupná: žiadny inštalačný príkaz, žiadny reštart. Spusti Vibe a zavolaj ju na reálnom súbore.
vibe
# > /test-generator src/utils/math.ts
Vibe načíta zručnosť, prečíta jej SKILL.md, aby pochopil očakávané správanie, a vykoná úlohu pomocou autorizovaných nástrojov. Venuj čas prečítaniu výsledku: porovnaním výstupu s tým, čo si si predstavoval, vylepšíš telo súboru.
Osvedčené postupy
Dodržuj pravidlo jedna zručnosť na jednu funkciu. Miešanie kontroly kódu a generovania testov v jednom súbore vytvára prompt, ktorý tápe, a bráni ti vypnúť jednu časť bez straty tej druhej. Podobne obmedz autorizované nástroje len na tie, ktoré zručnosť skutočne potrebuje.
Zvyšok závisí od kvality písania. Telo súboru SKILL.md je tvoj prompt: buď presný a zahrň konkrétne príklady toho, čo zručnosť produkuje – jeden príklad výstupu má väčšiu váhu ako tri riadky popisu. Nakoniec otestuj svoju zručnosť na viacerých prípadoch vrátane toho zložitého, skôr ako ju zdieľaš s tímom.
Kľúčové poznatky
- Zručnosť je adresár so súborom
SKILL.mdobsahujúcim YAML frontmatter - Frontmatter definuje názov, popis, povolené nástroje a možnosť vyvolania
- Telo v Markdown slúži ako dokumentácia aj ako prompt pre Vibe
user-invocable: truesprístupňuje zručnosť prostredníctvom lomkového príkazu- Vytváraj špecializované zručnosti s minimálnym potrebným počtom nástrojov