Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Vytvorenie zručnosti pomocou SKILL.md

Lekcia 6 z 14 Aktualizované 2. novembra 2026 Pokročilý
Na tejto strane
  1. Zručnosti: Opakovane použiteľné komponenty
  2. Anatómia súboru SKILL.md
  3. Polia vo YAML frontmatteri
  4. Telo súboru SKILL.md
  5. Vytvorenie tvojej prvej zručnosti
  6. Osvedčené postupy
  7. Kľúčové poznatky

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-tools sa čí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.md obsahujú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: true sprístupňuje zručnosť prostredníctvom lomkového príkazu
  • Vytváraj špecializované zručnosti s minimálnym potrebným počtom nástrojov