Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Ustvari veščino s SKILL.md

Lekcija 6 od 14 Posodobljeno 2. november 2026 Napredni
Na tej strani
  1. Veščine: Ponovno uporabne komponente
  2. Anatomija datoteke SKILL.md
  3. Polja v glavi YAML
  4. Telo datoteke SKILL.md
  5. Ustvari svojo prvo veščino
  6. Najboljše prakse
  7. Ključne ugotovitve

Lekcija posodobljena 2. novembra 2026 na podlagi strani Skills v dokumentaciji Vibe: veščina je niz navodil (ne dodaja orodij), allowed-tools se prebere, vendar ni vsiljeno, dodani pa sta bili dve polji (disable-model-invocation, compatibility). Vir: Skills.

Veščine: Ponovno uporabne komponente

Agenti določajo kdo izvrši nalogo. Veščine določajo kaj: so ponovno uporabni nizi navodil, ki Mistral Vibe dodajo postopke in postranske ukaze (slash commands). Razlika postane očitna, ko jo uporabiš v svoji ekipi – agent odraža osebni delovni slog, medtem ko veščina zajema postopek, ki ga morajo vsi izvajati enako.

Veščina je mapa, ki vsebuje datoteko SKILL.md z glavo YAML. Ta struktura sledi odprti specifikaciji Agent Skills, kar omogoča prenosljivost in souporabo veščin: ista mapa deluje na računalniku tvojega kolega brez prilagajanja.

Anatomija datoteke SKILL.md

Tukaj je popolna struktura veščine, prikazana na primeru avtomatiziranega pregleda kode:

---
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 v glavi YAML

Polje name je edinstven identifikator veščine. Uporablja se za omogočanje, onemogočanje in sklicevanje na veščino v konfiguracijah. To ime postane tudi postranski ukaz, zato ga je vredno ohraniti kratko.

name: code-review

description, dolg do 1.024 znakov, je stavek, ki se prikaže, ko Vibe izpiše razpoložljive veščine. Napiši ga z vidika nekoga, ki išče: omogočiti mu mora izbiro med dvema podobnima veščinama brez odpiranja datotek.

description: Performs automated code reviews with quality analysis

Polje license označuje licenco veščine, kar postane pomembno, takoj ko jo deliš zunaj svoje delovne postaje.

license: MIT

Boolova vrednost user-invocable, privzeto true, razkrije veščino kot postranski ukaz. Nastavi jo na false, da jo skriješ iz menija /: agent jo lahko še vedno samodejno naloži, ko se naloga ujema.

user-invocable: true   # Dostopno prek /code-review
user-invocable: false  # Skrito v meniju /, agent jo lahko še vedno naloži

Polje disable-model-invocation, ko je nastavljeno na true, prepreči agentu samodejno nalaganje veščine: zažene se le, če tipkaš /ime-veščine. To rezerviraj za postopke, ki jih noben model ne sme sprožiti brez tvojega izrecnega soglasja, na primer za uvedbo v proizvodno okolje (deployment).

disable-model-invocation: true

Seznam dopolnjujeta dve informativni polji: compatibility, ki navaja predpogoje („Zahteva git”), in allowed-tools, ki našteva orodja, ki jih veščina namenoma uporablja. Pri slednjem bodi previden: dokumentacija določa, da Vibe to prebere, vendar ne vsili. Veščina lahko pokliče katero koli orodje, ki ga dovoli aktivni agent. Če želiš omejiti, kaj veščina lahko stori, omeji orodja in dovoljenja agenta (lekciji 2 in 3).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

Telo datoteke SKILL.md

Za glavo je telo datoteke poljubno oblikovan Markdown. Služi kot dokumentacija in poziv (prompt): Vibe ga prebere, da razume, kako veščina deluje in v kakšnem kontekstu jo uporabiti. Tu opišeš, kaj veščina počne, korake njenega delovanja, pričakovano obliko izpisa in primere uporabe. Nejasno telo prinaša nepredvidljivo veščino; natančno telo prinaša veščino, ki tedne zaporedoma proizvaja enak rezultat.

Ustvari svojo prvo veščino

Zgradimo veščino za generiranje testov. Najprej ustvari njeno mapo:

mkdir -p ~/.vibe/skills/test-generator

Vanjo postavi naslednjo datoteko SKILL.md. Opazi, kako telo odgovarja na vprašanja, ki bi jih Vibe sicer moral ugibati: kateri okvir izbrati, kako poimenovati bloke, kam zapisati izhodno datoteko.

---
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.

Ko je datoteka ustvarjena, je veščina takoj na voljo: ni ukaza za namestitev, ni potrebe po ponovnem zagonu. Zaženi Vibe in jo pokliči na realni datoteki.

vibe
# > /test-generator src/utils/math.ts

Vibe naloži veščino, prebere njen SKILL.md, da razume pričakovano obnašanje, in izvrši nalogo z avtoriziranimi orodji. Vzemi si čas za branje rezultata: s primerjavo izpisa s tem, kar si si zamislil, boš izpopolnil telo datoteke.

Najboljše prakse

Drži se ene veščine na funkcijo. Mešanje pregleda kode in generiranja testov v eno datoteko ustvari poziv, ki se izmika, in ti prepreči onemogočiti eno, ne da bi izgubil drugo. Prav tako omeji avtorizirana orodja na tista, ki jih veščina dejansko potrebuje.

Preostalo je odvisno od kakovosti zapisa. Telo SKILL.md je tvoj poziv: bodi natančen in vključi konkretne primere tega, kar veščina proizvede – primer izpisa velja več kot tri vrstice opisa. Nazadnje, preden veščino deliš z ekipo, jo preizkusi na več primerih, vključno z zapletenim.

Ključne ugotovitve

  • Veščina je mapa z datoteko SKILL.md, ki vsebuje glavo YAML
  • Glava določa ime, opis, dovoljena orodja in možnost priklica
  • Telo v formatu Markdown služi kot dokumentacija in poziv za Vibe
  • user-invocable: true omogoča dostop do veščine prek postranskega ukaza
  • Ustvari specializirane veščine z minimalnim številom potrebnih orodij