Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Opret en færdighed med SKILL.md

Lektion 6 af 14 Opdateret 2. november 2026 Avanceret
På denne side
  1. Færdigheder: Genanvendelige komponenter
  2. Anatomien af en SKILL.md
  3. Felterne i YAML-frontmatter
  4. Brødteksten i SKILL.md
  5. Opret din første færdighed
  6. Bedste praksis
  7. Vigtige pointer

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-tools læ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: true gør færdigheden tilgængelig via en skråstregskommando
  • Opret specialiserede færdigheder med det mindst nødvendige antal værktøjer