Skapa en färdighet med SKILL.md
På denna sida
Lektionen uppdaterad 2 november 2026 baserat på sidan Skills i Vibe-dokumentationen: en färdighet är en uppsättning instruktioner (den lägger inte till verktyg),
allowed-toolsläses men tillämpas inte, och två fält har lagts till (disable-model-invocation,compatibility). Källa: Skills.
Färdigheter: Återanvändbara komponenter
Agenter definierar vem som utför en uppgift. Färdigheter definierar vad: de är återanvändbara instruktionsuppsättningar som lägger till procedurer och snedstreckskommandon i Mistral Vibe. Distinktionen blir konkret när du tillämpar den på ditt team – en agent speglar en personlig arbetsstil, medan en färdighet kapslar in en procedur som alla måste utföra på samma sätt.
En färdighet är en katalog som innehåller en fil vid namn SKILL.md med ett YAML-frontmatter. Denna struktur följer den öppna specifikationen för Agent Skills, vilket gör färdigheter portabla och delbara: samma mapp fungerar på din kollegas dator utan anpassning.
Anatomin hos en SKILL.md
Här är den kompletta strukturen för en färdighet, illustrerad med ett exempel på automatiserad kodgranskning:
---
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
Fälten i YAML-frontmatter
Fältet name är färdighetens unika identifierare. Det används för att aktivera, inaktivera och referera till färdigheten i konfigurationer. Detta namn blir också snedstreckskommandot, så det lönar sig att hålla det kort.
name: code-review
description, på upp till 1 024 tecken, är frasen som visas när Vibe listar tillgängliga färdigheter. Skriv den ur perspektivet av någon som söker: den ska låta användaren välja mellan två liknande färdigheter utan att behöva öppna filerna.
description: Performs automated code reviews with quality analysis
Fältet license anger färdighetens licens, vilket blir viktigt så snart du delar den utanför din egen arbetsstation.
license: MIT
Den booleska variabeln user-invocable, som är sann (true) som standard, exponerar färdigheten som ett snedstreckskommando. Sätt den till false för att dölja den från /-menyn: agenten kan fortfarande ladda den automatiskt när uppgiften passar.
user-invocable: true # Accessible via /code-review
user-invocable: false # Hidden from / menu, agent can still load it
Fältet disable-model-invocation, när det är satt till true, förhindrar agenten från att ladda färdigheten på egen hand: den körs endast om du skriver /färdighetsnamn. Reservera detta för procedurer som ingen modell bör utlösa utan ditt uttryckliga samtycke, till exempel en distribution.
disable-model-invocation: true
Två informationsfält kompletterar listan: compatibility, som noterar förutsättningar (« Kräver git »), och allowed-tools, som listar de verktyg färdigheten avser att använda. Var försiktig med det senare: dokumentationen specificerar att Vibe läser det men inte tillämpar det. En färdighet kan anropa vilket verktyg som helst som den aktiva agenten auktoriserar. För att begränsa vad en färdighet kan göra, begränsa verktygen och behörigheterna för agenten (lektion 2 och 3).
allowed-tools:
- read_file
- grep
- ask_user_question
Brödtexten i SKILL.md
Efter frontmatter är filens brödtext fri formatering i Markdown. Den fungerar som både dokumentation och prompt: Vibe läser den för att förstå hur färdigheten fungerar och i vilket sammanhang den ska tillämpas. Här beskriver du vad färdigheten gör, stegen i dess funktion, det förväntade utdataformatet och användningsexempel. En vag brödtext ger en oförutsägbar färdighet; en precis brödtext ger en färdighet som producerar samma resultat vecka efter vecka.
Skapa din första färdighet
Låt oss bygga en färdighet för testgenerering. Börja med att skapa dess katalog:
mkdir -p ~/.vibe/skills/test-generator
Placera följande SKILL.md där inne. Lägg märke till hur brödtexten svarar på frågor som Vibe annars skulle behöva gissa sig till: vilket ramverk som ska väljas, hur block ska namnges, var utdatafilen ska skrivas.
---
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 är skapad är färdigheten omedelbart tillgänglig: inget installationskommando, ingen omstart. Starta Vibe och anropa den på en riktig fil.
vibe
# > /test-generator src/utils/math.ts
Vibe laddar färdigheten, läser dess SKILL.md för att förstå det förväntade beteendet och utför uppgiften med de auktoriserade verktygen. Ta dig tid att läsa resultatet: genom att jämföra utdata med vad du föreställde dig kommer du att förfina filens brödtext.
Bästa praxis
Håll dig till en färdighet per funktion. Att blanda kodgranskning och testgenerering i en enda fil producerar en prompt som vacklar, och hindrar dig från att inaktivera den ena utan att förlora den andra. Begränsa på samma sätt auktoriserade verktyg till de som färdigheten faktiskt behöver.
Resten beror på skrivandets kvalitet. Brödtexten i SKILL.md är din prompt: var precis och inkludera konkreta exempel på vad färdigheten producerar – ett exempel på utdata är värt mer än tre raders beskrivning. Testa slutligen din färdighet på flera fall, inklusive ett knepigt, innan du delar den med teamet.
Viktiga punkter
- En färdighet är en katalog med en fil
SKILL.mdsom innehåller ett YAML-frontmatter - Frontmatter definierar namn, beskrivning, tillåtna verktyg och anropbarhet
- Markdown-brödtexten fungerar som både dokumentation och en prompt för Vibe
user-invocable: truegör färdigheten tillgänglig via ett snedstreckskommando- Skapa specialiserade färdigheter med minimalt nödvändiga verktyg