Luo taito tiedostolla SKILL.md
Tällä sivulla
Oppitunti päivitetty 2. marraskuuta 2026 Skills-sivun perusteella Vibe-dokumentaatiosta: taito on joukko ohjeita (se ei lisää työkaluja),
allowed-toolsluetaan, mutta sitä ei valvota, ja kaksi kenttää on lisätty (disable-model-invocation,compatibility). Lähde: Skills.
Taidot: Uudelleenkäytettävät komponentit
Agentit määrittelevät kenen tulee suorittaa tehtävä. Taidot määrittelevät miten: ne ovat uudelleenkäytettäviä ohjesarjoja, jotka lisäävät Menettelytapoja ja vinokomentoja Mistral Vibeen. Ero konkretisoituu, kun sovellat sitä tiimiisi: agentti heijastaa henkilökohtaista työotetta, kun taas taito kapseloi menettelyn, jonka kaikkien on suoritettava samalla tavalla.
Taito on hakemisto, joka sisältää YAML-alkuosan omaavan SKILL.md-tiedoston. Tämä rakenne noudattaa avointa Agent Skills -määrittelyä, mikä tekee taidoista siirrettäviä ja jaettavia: sama kansio toimii kollegasi koneella ilman muokkauksia.
SKILL.md:n anatomia
Tässä on taidon täydellinen rakenne, jota havainnollistaa automatisoitu koodinkatselmointiesimerkki:
---
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-alkuosan kentät
Kenttä name on taidon yksilöllinen tunniste. Sitä käytetään taidon ottamiseen käyttöön, poistamiseen käytöstä ja viittaamiseen konfiguraatioissa. Tämä nimi toimii myös vinokomentona, joten sen kannattaa pitää lyhyenä.
name: code-review
Kenttä description (enintään 1 024 merkkiä) on lause, joka näkyy, kun Vibe luettelee käytettävissä olevat taidot. Kirjoita se henkilön näkökulmasta, joka etsii tietoa: sen tulee mahdollistaa kahden samankaltaisen taidon välillä valitseminen ilman tiedostojen avaamista.
description: Performs automated code reviews with quality analysis
Kenttä license ilmoittaa taidon lisenssin, mikä muuttuu tärkeäksi heti, kun jaat sitä oman työasemasi ulkopuolelle.
license: MIT
Booleen-arvoinen user-invocable on oletuksena true, mikä altistaa taidon vinokomentona. Aseta se arvoksi false piilottaaksesi sen /-valikosta: agentti voi silti ladata sen automaattisesti, kun tehtävä sopii yhteen.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Kenttä disable-model-invocation estää agenttia lataamasta taitoa omin päin, kun se on asetettu arvoksi true: se suoritetaan vain, jos kirjoitat /taidon-nimi. Varaa tämä menettelyille, joita minkään mallin ei pitäisi käynnistää ilman nimenomaista suostumustasi, kuten käyttöönotto.
disable-model-invocation: true
Kaksi tietokenttää täydentää listan: compatibility, joka huomauttaa edellytyksistä (“Requires git”), ja allowed-tools, joka luettelee työkalut, joita taito aikoo käyttää. Varo jälkimmäistä: dokumentaatio täsmentää, että Vibe lukee sen, mutta ei valvo sitä. Taito voi kutsua mitä tahansa työkalua, jonka aktiivinen agentti valtuuttaa. Rajoittaaksesi sitä, mitä taito voi tehdä, rajoita agentin työkaluja ja oikeuksia (Oppitunnit 2 ja 3).
allowed-tools:
- read_file
- grep
- ask_user_question
SKILL.md:n sisältöosa
Alkuosan jälkeen tiedoston sisältöosa on vapaamuotoista Markdownia. Se toimii sekä dokumentaationa että kehotteena: Vibe lukee sen ymmärtääkseen, miten taito toimii ja missä kontekstissa sitä tulee soveltaa. Tässä kuvaillet, mitä taito tekee, sen toimintavaiheet, odotetun tulosteen muodon ja käyttöesimerkkejä. Epämääräinen sisältö tuottaa arvaamattoman taidon; tarkka sisältö tuottaa taidon, joka tuottaa saman tuloksen viikosta toiseen.
Luo ensimmäinen taitosi
Rakennetaan testien generointitaito. Aloita luomalla sen hakemisto:
mkdir -p ~/.vibe/skills/test-generator
Sijoita seuraava SKILL.md sinne. Huomaa, miten sisältö vastaa kysymyksiin, jotka Viben muuten pitäisi arvata: mikä kehys valita, miten nimetä lohkot, mihin kirjoittaa tulostiedosto.
---
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.
Kun tiedosto on luotu, taito on heti käytettävissä: ei asennuskomentoa, ei uudelleenkäynnistystä. Käynnistä Vibe ja kutsu sitä todellisella tiedostolla.
vibe
# > /test-generator src/utils/math.ts
Vibe lataa taidon, lukee sen SKILL.md-tiedoston ymmärtääkseen odotetun käyttäytymisen ja suorittaa tehtävän valtuutetuilla työkaluilla. Ota aikaa lukea tulos: vertaamalla tulostetta siihen, mitä kuvittelit, hienosäädät tiedoston sisältöä.
Parhaat käytännöt
Pidä yksi taito yhtä ominaisuutta kohden. Koodinkatselmoinnin ja testien generoinnin sekoittaminen samaan tiedostoon tuottaa kehotteen, joka epäröi, ja estää sinua poistamasta toista käytöstä menettämättä toista. Vastaavasti rajoita valtuutetut työkalut niihin, joita taito todella tarvitsee.
Loppu riippuu kirjoituksen laadusta. SKILL.md:n sisältöosa on kehote: ole tarkka ja sisällytä konkreettisia esimerkkejä siitä, mitä taito tuottaa – tulosteesimerkki on arvokkaampi kuin kolme riviä kuvausta. Lopuksi testaa taitosi useilla tapauksilla, mukaan lukien yksi hankala, ennen kuin jaat sen tiimin kanssa.
Keskeiset asiat
- Taito on hakemisto, jossa on
SKILL.md-tiedosto sisältäen YAML-alkuosan - Alkuosa määrittelee nimen, kuvauksen, sallitut työkalut ja kutsuttavuuden
- Markdown-sisältöosa toimii sekä dokumentaationa että Viben kehotteena
user-invocable: truetekee taidosta saavutettavan vinokomennolla- Luo erikoistuneita taitoja käyttämällä vain välttämättömiä työkaluja