Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Stvori vještinu pomoću SKILL.md

Lekcija 6 od 14 Ažurirano 2. studenoga 2026. Napredno
Na ovoj stranici
  1. Vještine: Komponente za višekratnu uporabu
  2. Anatomija datoteke SKILL.md
  3. Polja u YAML frontmatteru
  4. Tijelo datoteke SKILL.md
  5. Stvori svoju prvu vještinu
  6. Najbolje prakse
  7. Ključne točke

Lekcija ažurirana 2. studenog 2026. na temelju stranice Skills u Vibe dokumentaciji: vještina je skup uputa (ne dodaje alate), allowed-tools se č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.md koja 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