Opret en færdighed med SKILL.md
På denne side
Lektion opdateret 2. november 2026 baseret på siden Skills i Vibe-dokumentationen: en færdighed er et sæt instruktioner (den tilføjer ikke værktøjer),
allowed-toolslæses, men håndhæves ikke, og to felter er blevet tilføjet (disable-model-invocation,compatibility). Kilde: Skills.
Færdigheder: Genanvendelige komponenter
Agenter definerer hvem, der udfører en opgave. Færdigheder definerer hvad: de er genanvendelige instruktionssæt, der tilføjer procedurer og skråstregskommandoer til Mistral Vibe. Distinktionen bliver konkret, når du anvender den på dit team: en agent afspejler en personlig arbejdsholdning, mens en færdighed kapsler en procedure ind, som alle skal udføre på samme måde.
En færdighed er en mappe, der indeholder en fil kaldet SKILL.md med et YAML-frontmatter. Denne struktur følger den åbne Agent Skills-specifikation, hvilket gør færdigheder portable og delelige: den samme mappe fungerer på din kollegas maskine uden tilpasning.
Anatomien af en SKILL.md
Her er den komplette struktur for en færdighed, illustreret ved et eksempel på automatiseret kodegennemgang:
---
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
Felterne i YAML-frontmatter
Feltet name er færdighedens unikke identifikator. Det bruges til at aktivere, deaktivere og referere til færdigheden i konfigurationer. Dette navn bliver også til skråstregskommandoen, så det er værd at holde det kort.
name: code-review
description på op til 1.024 tegn er den sætning, der vises, når Vibe lister tilgængelige færdigheder. Skriv det fra perspektivet hos nogen, der søger: det skal gøre dem i stand til at vælge mellem to lignende færdigheder uden at åbne filerne.
description: Performs automated code reviews with quality analysis
Feltet license angiver færdighedens licens, hvilket bliver vigtigt, så snart du deler den ud over din egen workstation.
license: MIT
Den booleske værdi user-invocable, som som standard er sand (true), eksponerer færdigheden som en skråstregskommando. Sæt den til false for at skjule den fra /-menuen: agenten kan stadig indlæse den automatisk, når opgaven passer til den.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Feltet disable-model-invocation forhindrer, når det sættes til true, agenten i at indlæse færdigheden på egen hånd: den kører kun, hvis du selv skriver /færdigheds-navn. Reserver dette til procedurer, som ingen model bør udløse uden dit eksplicitte samtykke, såsom en deployment.
disable-model-invocation: true
To informative felter fuldender listen: compatibility, som noterer forudsætninger („Kræver git”), og allowed-tools, som lister de værktøjer, færdigheden har til hensigt at bruge. Vær forsigtig med sidstnævnte: dokumentationen specificerer, at Vibe læser det, men ikke håndhæver det. En færdighed kan kalde ethvert værktøj, som den aktive agent autoriserer. For at begrænse, hvad en færdighed kan gøre, skal du begrænse værktøjerne og tilladelserne for agenten (lektion 2 og 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Brødteksten i SKILL.md
Efter frontmatter er brødteksten i filen frit formateret Markdown. Den fungerer både som dokumentation og prompt: Vibe læser den for at forstå, hvordan færdigheden virker, og i hvilken kontekst den skal anvendes. Her beskriver du, hvad færdigheden gør, trinene i dens funktion, det forventede outputformat og brugseksempler. En vag brødtekst giver en uforudsigelig færdighed; en præcis brødtekst giver en færdighed, der producerer det samme resultat uge efter uge.
Opret din første færdighed
Lad os bygge en færdighed til testgenerering. Start med at oprette dens mappe:
mkdir -p ~/.vibe/skills/test-generator
Placer følgende SKILL.md indeni. Bemærk, hvordan brødteksten besvarer spørgsmål, som Vibe ellers skulle gætte på: hvilket framework der skal vælges, hvordan blokke skal navngives, hvor outputfilen skal skrives.
---
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.
Når filen er oprettet, er færdigheden straks tilgængelig: ingen installationskommando, ingen genstart. Start Vibe og kald den på en rigtig fil.
vibe
# > /test-generator src/utils/math.ts
Vibe indlæser færdigheden, læser dens SKILL.md for at forstå den forventede adfærd og udfører opgaven med de autoriserede værktøjer. Tag dig tid til at læse resultatet: ved at sammenligne outputtet med det, du forestillede dig, vil du kunne forfine filens brødtekst.
Bedste praksis
Hold dig til én færdighed per funktion. At blande kodegennemgang og testgenerering i en enkelt fil producerer en prompt, der halser, og forhindrer dig i at deaktivere den ene uden at miste den anden. Begræns ligeledes de autoriserede værktøjer til dem, færdigheden faktisk har brug for.
Resten afhænger af skrivningens kvalitet. Brødteksten i SKILL.md er din prompt: vær præcis, og inkluder konkrete eksempler på, hvad færdigheden producerer – et outputeksempel er mere værd end tre linjers beskrivelse. Test endelig din færdighed på flere tilfælde, herunder et vanskeligt ét, før du deler den med teamet.
Vigtige pointer
- En færdighed er en mappe med en
SKILL.md-fil, der indeholder et YAML-frontmatter - Frontmatter definerer navn, beskrivelse, tilladte værktøjer og kaldemulighed
- Markdown-brødteksten fungerer både som dokumentation og som en prompt til Vibe
user-invocable: truegør færdigheden tilgængelig via en skråstregskommando- Opret specialiserede færdigheder med det mindst nødvendige antal værktøjer