Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Een vaardigheid maken met SKILL.md

Les 6 van 14 Bijgewerkt op 2 november 2026 Gevorderd
Op deze pagina
  1. Vaardigheden: Herbruikbare componenten
  2. Anatomie van een SKILL.md
  3. De velden in de YAML-frontmatter
  4. De inhoud van SKILL.md
  5. Maak uw eerste vaardigheid
  6. Best practices
  7. Belangrijkste punten

Les bijgewerkt op 2 november 2026 op basis van de pagina Skills in de Vibe-documentatie: een vaardigheid is een set instructies (het voegt geen tools toe), allowed-tools wordt gelezen maar niet afgedwongen, en twee velden zijn toegevoegd (disable-model-invocation, compatibility). Bron: Skills.

Vaardigheden: Herbruikbare componenten

Agents definiëren wie een taak uitvoert. Vaardigheden definiëren wat: het zijn herbruikbare instructiesets die procedures en slash-commando’s toevoegen aan Mistral Vibe. Het onderscheid wordt concreet wanneer u het toepast op uw team: een agent weerspiegelt een persoonlijke werkhouding, terwijl een vaardigheid een procedure kapselt die iedereen op dezelfde manier moet uitvoeren.

Een vaardigheid is een map die een SKILL.md-bestand bevat met een YAML-frontmatter. Deze structuur volgt de open Agent Skills-specificatie, waardoor vaardigheden draagbaar en deelbaar zijn: dezelfde map werkt op de computer van uw collega zonder aanpassingen.

Anatomie van een SKILL.md

Hier is de volledige structuur van een vaardigheid, geïllustreerd aan de hand van een voorbeeld voor geautomatiseerde code-review:

---
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

De velden in de YAML-frontmatter

Het veld name is de unieke identifier voor de vaardigheid. Het wordt gebruikt om de vaardigheid in configuraties in te schakelen, uit te schakelen en naar te verwijzen. Deze naam wordt ook het slash-commando, dus het is de moeite waard om deze kort te houden.

name: code-review

De description, maximaal 1.024 tekens, is de zin die verschijnt wanneer Vibe beschikbare vaardigheden opsomt. Schrijf deze vanuit het perspectief van iemand die zoekt: het moet hen in staat stellen om tussen twee vergelijkbare vaardigheden te kiezen zonder de bestanden te openen.

description: Performs automated code reviews with quality analysis

Het veld license geeft de licentie van de vaardigheid aan, wat belangrijk wordt zodra u deze deelt buiten uw eigen werkstation.

license: MIT

De boolean user-invocable, standaard waar (true), stelt de vaardigheid bloot als een slash-commando. Stel dit in op false om deze te verbergen in het /-menu: de agent kan deze nog steeds automatisch laden wanneer de taak erom vraagt.

user-invocable: true   # Toegankelijk via /code-review
user-invocable: false  # Verborgen in /-menu, agent kan deze nog steeds laden

Het veld disable-model-invocation voorkomt, wanneer ingesteld op true, dat de agent de vaardigheid zelfstandig laadt: deze wordt alleen uitgevoerd als u /vaardigheids-naam typt. Reserveer dit voor procedures die geen enkel model mag activeren zonder uw expliciete toestemming, zoals een deployment.

disable-model-invocation: true

Twee informatieve velden maken de lijst compleet: compatibility, dat prerequisities noteert (“Requires git”), en allowed-tools, dat de tools opsomt die de vaardigheid bedoeld is te gebruiken. Pas op met dit laatste: de documentatie specificeert dat Vibe dit leest maar niet afdwingt. Een vaardigheid kan elke tool aanroepen die de actieve agent autoriseert. Om te beperken wat een vaardigheid kan doen, beperkt u de tools en rechten van de agent (Lessen 2 en 3).

allowed-tools:
  - read_file
  - grep
  - ask_user_question

De inhoud van SKILL.md

Na de frontmatter is de inhoud van het bestand vrije Markdown. Het dient zowel als documentatie als prompt: Vibe leest dit om te begrijpen hoe de vaardigheid werkt en in welke context deze moet worden toegepast. Hier beschrijft u wat de vaardigheid doet, de stappen van de werking, het verwachte uitvoerformaat en gebruiksvoorbeelden. Een vaag lichaam levert een onvoorspelbare vaardigheid op; een precies lichaam levert een vaardigheid die week na week hetzelfde resultaat produceert.

Maak uw eerste vaardigheid

Laten we een vaardigheid voor het genereren van tests bouwen. Begin met het maken van de map:

mkdir -p ~/.vibe/skills/test-generator

Plaats het volgende SKILL.md-bestand erin. Merk op hoe de inhoud vragen beantwoordt die Vibe anders zou moeten raden: welk framework te kiezen, hoe blokken te benoemen, waar het uitvoerbestand te schrijven.

---
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.

Zodra het bestand is gemaakt, is de vaardigheid direct beschikbaar: geen installatiecommando, geen herstart. Start Vibe en roep deze aan op een echt bestand.

vibe
# > /test-generator src/utils/math.ts

Vibe laadt de vaardigheid, leest de SKILL.md om het verwachte gedrag te begrijpen, en voert de taak uit met de geautoriseerde tools. Neem de tijd om het resultaat te lezen: door de uitvoer te vergelijken met wat u zich had voorgesteld, verfijnt u de inhoud van het bestand.

Best practices

Houd het bij één vaardigheid per functie. Het mengen van code-review en testgeneratie in één enkel bestand produceert een prompt die twijfelt, en verhindert dat u het ene uitschakelt zonder het andere te verliezen. Beperk eveneens de geautoriseerde tools tot die welke de vaardigheid daadwerkelijk nodig heeft.

De rest hangt af van de kwaliteit van het schrijven. De inhoud van de SKILL.md is uw prompt: wees precies en neem concrete voorbeelden op van wat de vaardigheid produceert—een voorbeeld van de uitvoer is meer waard dan drie regels beschrijving. Test uw vaardigheid ten slotte op meerdere gevallen, inclusief een lastig geval, voordat u deze deelt met het team.

Belangrijkste punten

  • Een vaardigheid is een map met een SKILL.md-bestand dat een YAML-frontmatter bevat
  • De frontmatter definieert de naam, beschrijving, toegestane tools en aanroepbaarheid
  • De Markdown-inhoud dient zowel als documentatie als als prompt voor Vibe
  • user-invocable: true maakt de vaardigheid toegankelijk via een slash-commando
  • Maak gespecialiseerde vaardigheden met het minimaal noodzakelijke aantal tools