Stvori vještinu pomoću SKILL.md
Na ovoj stranici
Lekcija ažurirana 2. studenog 2026. na temelju stranice Skills u Vibe dokumentaciji: vještina je skup uputa (ne dodaje alate),
allowed-toolsse čita, ali ne provodi, a dodana su dva polja (disable-model-invocation,compatibility). Izvor: Skills.
Vještine: Komponente za višekratnu uporabu
Agenti definiraju tko izvršava zadatak. Vještine definiraju što: one su skupovi uputa za višekratnu uporabu koji Mistral Vibeu dodaju procedure i slash naredbe. Razlika postaje konkretna kada je primijeniš na svoj tim – agent odražava osobni radni stav, dok vještina encapsulira proceduru koju svi moraju izvršavati na isti način.
Vještina je direktorij koji sadrži datoteku SKILL.md s YAML frontmatterom. Ova struktura prati otvorenu specifikaciju Agent Skills, čineći vještine prenosivima i dijeljivima: ista mapa radi na računalu tvog kolege bez ikakvih prilagodbi.
Anatomija datoteke SKILL.md
Evo potpune strukture vještine, ilustrirane primjerom automatiziranog pregleda koda:
---
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
Polja u YAML frontmatteru
Polje name jedinstveni je identifikator vještine. Koristi se za omogućivanje, onemogućivanje i referenciranje vještine u konfiguracijama. Ovo ime također postaje slash naredba, pa ga vrijedi održavati kratkim.
name: code-review
Polje description, do 1024 znaka, fraza je koja se pojavljuje kada Vibe izlistava dostupne vještine. Piši ga iz perspektive nekoga tko traži: trebalo bi mu omogućiti odabir između dviju sličnih vještina bez otvaranja datoteka.
description: Performs automated code reviews with quality analysis
Polje license označava licencu vještine, što postaje važno čim je podijeliš izvan vlastite radne stanice.
license: MIT
Booleovo polje user-invocable, koje je prema zadanim postavkama true, izlaže vještinu kao slash naredbu. Postavi ga na false kako bi je sakrio iz izbornika /: agent je i dalje može automatski učitati kada zadatak to zahtijeva.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Polje disable-model-invocation, kada je postavljeno na true, sprječava agenta da samostalno učita vještinu: ona se pokreće samo ako ti upišeš /ime-vještine. Ovo rezerviraj za procedure koje nijedan model ne smije pokrenuti bez tvog izričitog pristanka, poput implementacije u produkciju.
disable-model-invocation: true
Dva informativna polja kompletiraju popis: compatibility, koje bilježi preduvjete („Requires git“), i allowed-tools, koje nabraja alate koje vještina namjerava koristiti. Budi oprezan s potonjim: dokumentacija navodi da Vibe to čita, ali ne provodi. Vještina može pozvati bilo koji alat koji aktivni agent odobrava. Da bi ograničio što vještina može učiniti, ograniči alate i dopuštenja samog agenta (Lekcije 2 i 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Tijelo datoteke SKILL.md
Nakon frontmattera, tijelo datoteke je Markdown slobodnog formata. Služi i kao dokumentacija i kao prompt: Vibe ga čita kako bi razumio kako vještina funkcionira i u kojem kontekstu je primijeniti. Ovdje opisuješ što vještina radi, korake njezinog rada, očekivani format izlaza i primjere korištenja. Nejasno tijelo rezultira nepredvidivom vještinom; precizno tijelo rezultira vještinom koja daje isti rezultat iz tjedna u tjedan.
Stvori svoju prvu vještinu
Izgradimo vještinu za generiranje testova. Započni stvaranjem njezinog direktorija:
mkdir -p ~/.vibe/skills/test-generator
Unutra postavi sljedeću datoteku SKILL.md. Primijeti kako tijelo odgovara na pitanja koja bi Vibe inače morao nagađati: koji okvir odabrati, kako imenovati blokove, gdje zapisati izlaznu datoteku.
---
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.
Čim je datoteka stvorena, vještina je odmah dostupna: nema naredbe za instalaciju, nema ponovnog pokretanja. Pokreni Vibe i pozovi je na stvarnoj datoteci.
vibe
# > /test-generator src/utils/math.ts
Vibe učitava vještinu, čita njezin SKILL.md kako bi razumio očekivano ponašanje i izvršava zadatak s ovlaštenim alatima. Odvoji vrijeme za čitanje rezultata: usporedbom izlaza s onim što si zamislio, usavršit ćeš tijelo datoteke.
Najbolje prakse
Drži se jedne vještine po funkcionalnosti. Miješanje pregleda koda i generiranja testova u jednoj datoteci stvara prompt koji oklijeva i sprječava te da onemogućiš jedno bez gubitka drugog. Slično tome, ograniči ovlaštene alate samo na one koje vještina stvarno treba.
Ostalo ovisi o kvaliteti pisanja. Tijelo SKILL.md datoteke tvoj je prompt: budi precizan i uključi konkretne primjere onoga što vještina proizvodi – primjer izlaza vrijedi više od tri reda opisa. Naposljetku, testiraj svoju vještinu na nekoliko slučajeva, uključujući jedan zamršen, prije nego je podijeliš s timom.
Ključne točke
- Vještina je direktorij s datotekom
SKILL.mdkoja sadrži YAML frontmatter - Frontmatter definira ime, opis, dopuštene alate i mogućnost pozivanja
- Markdown tijelo služi i kao dokumentacija i kao prompt za Vibe
user-invocable: truečini vještinu dostupnom putem slash naredbe- Stvaraj specijalizirane vještine s minimalnim potrebnim alatima