Loo oskus failiga SKILL.md
Sellel lehel
Tund uuendatud 2. novembril 2026 põhinedes Vibe dokumentatsiooni lehele Skills: oskus on juhiste kogum (see ei lisa tööriistu),
allowed-toolsloetakse, 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: trueteeb oskuse kaldkriipsu käsuga ligipääsetavaks- Loo spetsialiseeritud oskusi, kasutades minimaalset vajalikku tööriistade hulka