Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Loo oskus failiga SKILL.md

Õppetund 6 / 14 Värskendatud 2. november 2026 Edasijõudnutele
Sellel lehel
  1. Oskused: Taaskasutatavad komponendid
  2. Faili SKILL.md ehitus
  3. YAML-i päise väljad
  4. Faili SKILL.md sisu
  5. Loo oma esimene oskus
  6. Parimad tavad
  7. Peamised punktid

Tund uuendatud 2. novembril 2026 põhinedes Vibe dokumentatsiooni lehele Skills: oskus on juhiste kogum (see ei lisa tööriistu), allowed-tools loetakse, kuid seda ei jõustata, ning lisatud on kaks välja (disable-model-invocation, compatibility). Allikas: Skills.

Oskused: Taaskasutatavad komponendid

Agendid määratlevad, kes ülesande täidab. Oskused määratlevad, mida: need on taaskasutatavad juhiste kogumid, mis lisavad Mistral Vibe’ile protseduure ja kaldkriipsu käske. See eristus muutub konkreetseks, kui rakendad seda oma meeskonnas – agent peegeldab isiklikku tööstiili, samas kui oskus kapseldab protseduuri, mida igaüks peab täitma ühtmoodi.

Oskus on kataloog, mis sisaldab YAML-i päistega faili SKILL.md. See struktuur järgib avatud Agent Skills spetsifikatsiooni, muutes oskused portatiivseks ja jagatavaks: sama kaust töötab sinu kolleegi arvutis ilma kohandusteta.

Faili SKILL.md ehitus

Siin on oskuse täielik struktuur, illustreerituna automatiseeritud koodi ülevaatuse näitega:

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

YAML-i päise väljad

Väli name on oskuse kordumatu identifikaator. Seda kasutatakse oskuse lubamiseks, keelamiseks ja viitamiseks konfiguratsioonides. See nimi muutub ka kaldkriipsu käsks, seega tasub see hoida lühike.

name: code-review

Väli description (kuni 1024 märki) on fraas, mis ilmub, kui Vibe loetleb saadaolevaid oskusi. Kirjuta see kellegi vaatenurgast, kes otsib lahendust: see peaks võimaldama valida kahe sarnase oskuse vahel ilma faile avamata.

description: Performs automated code reviews with quality analysis

Väli license näitab oskuse litsentsi, mis muutub oluliseks niipea, kui jagad seda väljaspool oma tööjaama.

license: MIT

Boole’i tüüpi user-invocable (vaikimisi true) avaldab oskuse kaldkriipsu käsuna. Määra see väärtuseks false, et peita see / menüüst: agent saab selle siiski automaatselt laadida, kui ülesanne sobib.

user-invocable: true   # Ligipääsetav käsuga /code-review
user-invocable: false  # Peidetud / menüüst, agent saab selle siiski laadida

Väli disable-model-invocation, kui see on määratud väärtuseks true, takistagendil oskust iseseisvalt laadimast: see käivitub ainult siis, kui sisestad ise /oskuse-nimi. Kasuta seda protseduuride puhul, mida ükski mudel ei tohiks ilma sinu selge nõusolekuta käivitada, näiteks kasutuselevõtt (deployment).

disable-model-invocation: true

Nimekirja täiendavad kaks informatiivset välja: compatibility, mis märgib eeltingimused („Nõuab git-i“), ja allowed-tools, mis loetleb tööriistad, mida oskus kavatseb kasutada. Ole viimasega ettevaatlik: dokumentatsioon täpsustab, et Vibe loeb seda, kuid ei jõusta. Oskus saab kutsuda ükskõik millist tööriista, mida aktiivne agent lubab. Oskuse tegevuspiirangute seadmiseks piira agendi tööriistu ja õigusi (tunnid 2 ja 3).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

Faili SKILL.md sisu

Pärast päist on faili sisu vabas vormingus Markdown. See toimib nii dokumentatsiooni kui ka sisendjuhise (promptina): Vibe loeb seda, et mõista, kuidas oskus töötab ja millises kontekstis seda rakendada. Siin kirjeldad, mida oskus teeb, selle toimimise samme, oodatavat väljundvormingut ja kasutusnäiteid. Ebamäärane sisu annab ettearvamatu oskuse; täpne sisu annab oskuse, mis toodab nädalast nädalasse sama tulemuse.

Loo oma esimene oskus

Ehitame testi genereerimise oskuse. Alusta selle kataloogi loomisest:

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

Paiguta sinna järgmine SKILL.md. Pane tähele, kuidas sisu vastab küsimustele, mida Vibe muidu peaks arvama: millist raamistikku valida, kuidas plokke nimetada, kuhu väljundfail kirjutada.

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

Kui fail on loodud, on oskus kohe saadaval: paigalduskäsku ega taaskäivitust pole vaja. Käivita Vibe ja kutsu see reaalse faili peal.

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

Vibe laadib oskuse, loeb selle SKILL.md-faili, et mõista oodatavat käitumist, ja täidab ülesande lubatud tööriistadega. Võta aega tulemuse lugemiseks: võrreldes väljundit sellega, mida ette kujutasid, saad faili sisu täpsustada.

Parimad tavad

Jää ühe oskuse juurde ühe funktsiooni kohta. Koodi ülevaatuse ja testi genereerimise segamine ühte faili tekitab sisendjuhise, mis jääb ebamääraseks, ja takistab ühe keelamist ilma teiseta jäämata. Samuti piira lubatud tööriistad nendega, mida oskus tegelikult vajab.

Ülejäänu sõltub kirjutamise kvaliteedist. Faili SKILL.md sisu on sinu sisendjuhise: ole täpne ja lisa konkreetsed näited sellest, mida oskus toodab – väljundi näide on väärtuslikum kui kolm rida kirjeldust. Lõpuks testi oma oskust mitmel juhul, sealhulgas keerulisel, enne kui jagad seda meeskonnaga.

Peamised punktid

  • Oskus on kataloog, mis sisaldab YAML-i päistega faili SKILL.md
  • Päis määratleb nime, kirjelduse, lubatud tööriistad ja käivitatavuse
  • Markdown-i sisu toimib nii dokumentatsiooni kui ka Vibe’i sisendjuhise (promptina)
  • user-invocable: true teeb oskuse kaldkriipsu käsuga ligipääsetavaks
  • Loo spetsialiseeritud oskusi, kasutades minimaalset vajalikku tööriistade hulka