Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Vytvoření dovednosti pomocí SKILL.md

Lekce 6 z 14 Aktualizováno 2. listopadu 2026 Pokročilý
Na této stránce
  1. Dovednosti: Opakovaně použitelné komponenty
  2. Anatomie souboru SKILL.md
  3. Pole ve frontmatteru YAML
  4. Tělo souboru SKILL.md
  5. Vytvoření první dovednosti
  6. Osvědčené postupy
  7. Klíčové poznatky

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-tools se č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.md obsahují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: true zpřístupňuje dovednost prostřednictvím lomítkového příkazu
  • Vytvářej specializované dovednosti s minimem nezbytných nástrojů