Készség létrehozása a SKILL.md fájllal
Ezen az oldalon
A lecke frissítve: 2026. november 2. a Vibe dokumentációjának Skills oldala alapján: a készség utasításkészlet (nem ad hozzá eszközöket), az
allowed-toolsmezőt beolvassa, de nem kényszeríti ki, és két új mező került hozzáadásra (disable-model-invocation,compatibility). Forrás: Skills.
Készségek: Újrafelhasználható komponensek
Az ügynökök határozzák meg, ki hajtja végre a feladatot. A készségek azt definiálják, mit: ezek újrafelhasználható utasításkészletek, amelyek eljárásokat és perjel (/) parancsokat adnak a Mistral Vibe-hoz. A különbség akkor válik kézzelfoghatóvá, ha alkalmazod a csapatodra: egy ügynök egyéni munkastílust tükröz, míg a készség egy olyan eljárást kapszuláz, amelyet mindenkinek ugyanúgy kell végrehajtania.
Egy készség egy könyvtár, amely egy SKILL.md fájlt tartalmaz YAML előlappal (frontmatter). Ez a struktúra a nyílt Agent Skills specifikációt követi, így a készségek hordozhatók és megoszthatók: ugyanaz a mappa működik a kollégád gépén is, átalakítás nélkül.
A SKILL.md felépítése
Íme egy készség teljes struktúrája, egy automatizált kódellenőrzési példán szemléltetve:
---
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
A YAML előlap mezői
A name mező a készség egyedi azonosítója. Ezt használjuk a készség engedélyezésére, letiltására és hivatkozására a konfigurációkban. Ez a név válik a perjel parancssá is, ezért érdemes rövidre hagyni.
name: code-review
A description (leírás), maximum 1024 karakterben, az a kifejezés, amely akkor jelenik meg, amikor a Vibe felsorolja az elérhető készségeket. Úgy írd meg, mintha egy kereső felhasználó szemszögéből néznéd: lehetővé kell tennie, hogy két hasonló készség közül válasszanak anélkül, hogy megnyitnák a fájlokat.
description: Performs automated code reviews with quality analysis
A license mező jelzi a készség licencét, ami akkor válik fontossá, ha a saját munkagépeden túl is megosztod azt.
license: MIT
A boolean user-invocable mező, amely alapértelmezetten true, készséget perjel parancsként teszi elérhetővé. Állítsd false-ra, ha el akarod rejteni a / menüből: az ügynök így is automatikusan betöltheti, ha a feladat illik hozzá.
user-invocable: true # Hozzáférhető a /code-review parancson keresztül
user-invocable: false # Rejtve a / menüből, de az ügynök mégis betöltheti
A disable-model-invocation mező, ha true-ra van állítva, megakadályozza, hogy az ügynök saját maga betöltse a készséget: csak akkor fut, ha te begépeled a /készség-neve parancsot. Ezt olyan eljárásoknak tartogasd, amelyeket egyetlen modellnek sem szabadna a te kifejezett hozzájárulásod nélkül elindítania, például egy telepítés esetén.
disable-model-invocation: true
Két információs mező zárja a sort: a compatibility, amely feljegyzi az előfeltételeket (pl. „Requires git“), és az allowed-tools, amely felsorolja azokat az eszközöket, amelyeket a készség használni szándékozik. Légy óvatos ez utóbbival: a dokumentáció specifies, hogy a Vibe beolvassa, de nem kényszeríti ki. Egy készség bármely eszközt meghívhat, amelyet az aktív ügynök engedélyez. Ha korlátozni akarod, mit tehet egy készség, az ügynök eszközeit és jogosultságait kell korlátoznod (2. és 3. lecke).
allowed-tools:
- read_file
- grep
- ask_user_question
A SKILL.md törzse
Az előlap után a fájl törzse szabad formátumú Markdown. Ez egyszerre szolgál dokumentációként és promptként: a Vibe ezt olvassa, hogy megértse, hogyan működik a készség, és milyen kontextusban alkalmazza. Itt írod le, mit csinál a készség, a működés lépéseit, a várt kimeneti formátumot és használati példákat. Egy homályos törzs kiszámíthatatlan készséget eredményez; egy precíz törzs olyan készséget, amely hétről hétre ugyanazt az eredményt produkálja.
Hozd létre az első készségedet
Építsünk fel egy tesztgeneráló készséget. Kezdjük a könyvtár létrehozásával:
mkdir -p ~/.vibe/skills/test-generator
Helyezd el benne a következő SKILL.md fájlt. Figyeld meg, hogyan válaszolja meg a törzs azokat a kérdéseket, amelyeket a Vibe-nek egyébként találgatnia kellene: melyik keretrendszert válassza, hogyan nevezze el a blokkokat, hová írja a kimeneti fájlt.
---
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.
Amint a fájl létrejött, a készség azonnal elérhető: nincs szükség telepítő parancsra vagy újraindításra. Indítsd el a Vibe-ot, és hívd meg egy valódi fájlon.
vibe
# > /test-generator src/utils/math.ts
A Vibe betölti a készséget, beolvassa a SKILL.md fájlt, hogy megértse a várt viselkedést, majd végrehajtja a feladatot az engedélyezett eszközökkel. Szánj rá időt, hogy elolvasd az eredményt: a kimenet és az elképzelt eredmény összehasonlításával finomíthatod a fájl törzsét.
Legjobb gyakorlatok
Tartsd be az egy készség – egy funkció elvet. Ha egyetlen fájlba kevered a kódellenőrzést és a tesztgenerálást, olyan promptot kapsz, amely bizonytalan, és megakadályozza, hogy az egyiket letiltsd anélkül, hogy a másikat is elveszítenéd. Hasonlóképpen, az engedélyezett eszközöket csak azokra korlátozd, amelyekre a készségnek ténylegesen szüksége van.
A többi a szöveg minőségétől függ. A SKILL.md törzse a te promptod: légy precíz, és foglalj bele konkrét példákat arról, mit produkál a készség – egy kimeneti példa többet ér, mint három sor leírás. Végül, mielőtt megosztanád a csapattal, teszteld a készségedet több eseten is, beleértve egy trükköst is.
Főbb megállapítások
- A készség egy könyvtár, amely egy YAML előlappal rendelkező
SKILL.mdfájlt tartalmaz - Az előlap definiálja a nevet, leírást, engedélyezett eszközöket és a meghívhatóságot
- A Markdown törzs egyszerre szolgál dokumentációként és promptként a Vibe számára
- A
user-invocable: truebeállítás perjel parancson keresztül teszi elérhetővé a készséget - Hozz létre specializált készségeket a minimálisan szükséges eszközökkel