Så skriver du en skill som faktiskt används
En skill är en mapp med en fil som heter SKILL.md. Det svåra är inte formatet utan att skriva en beskrivning som gör att agenten hittar den vid rätt tillfälle, och instruktioner som är konkreta nog att följa.
6 minuter. Uppdaterad 8 september 2026.
Formatet
En skill är en mapp. I mappen finns en fil som heter SKILL.md. Filen börjar med ett frontmatter-block med två obligatoriska fält:
---
name: motesanteckningar
description: Sammanfattar mötestranskript till beslut, åtgärder och öppna frågor. Använd när användaren delar ett transkript eller ber om mötesanteckningar, protokoll eller action points.
---Resten av filen är instruktionerna, i vanlig markdown. Mappen kan innehålla fler filer: mallar, exempel, skript, referensdokument. SKILL.md hänvisar till dem vid behov, och agenten läser dem först då.
Namnet ska vara gemener, siffror och bindestreck. Beskrivningen är det viktigaste fältet i hela filen.
Beskrivningen avgör om skillen används
Agenten ser bara namn och beskrivning från alla skills när den startar. Först när den bedömer att en skill matchar uppgiften läser den hela filen. En beskrivning som bara säger vad skillen gör räcker därför inte. Den måste också säga när den ska användas, med de ord en användare troligen skulle använda.
Sämre: "Hjälper till med mötesanteckningar."
Bättre: "Sammanfattar mötestranskript till beslut, åtgärder med ansvarig och deadline, samt öppna frågor. Använd när användaren delar ett transkript, en inspelning eller ber om mötesanteckningar, protokoll, action points eller frågar vad som bestämdes."
Skriv beskrivningen i tredje person. Testa den: be agenten om något med andra ord än du använde i beskrivningen och se om skillen laddas.
Instruktionerna
Skriv till en kompetent kollega som aldrig gjort just den här uppgiften. Det betyder:
Arbetsgång i steg, när ordningen spelar roll. Vad som ska göras först, vad som ska kontrolleras innan man går vidare.
Konkreta regler i stället för värdeord. "Max fyra meningar per stycke" i stället för "skriv koncist". "Ange källa och datum för varje siffra" i stället för "var noggrann".
Vad som inte ska göras. Det agenten annars gärna gör: hitta på, fylla i luckor, förbättra sådant den inte blivit ombedd att röra.
Leveransformat. Rubriker, tabell, längd. Ju tydligare desto mindre efterarbete.
Ett exempel, om formatet är ovanligt. Före och efter för omskrivningar. En ifylld tabell för rapporter.
Vad som ska hända när något är oklart. Fråga, eller anta och markera?
Vad som inte ska stå i en skill
Sådant som gäller alla uppgifter i projektet hör hemma i CLAUDE.md eller AGENTS.md. Sådant som gäller en enskild körning hör hemma i uppgiften. En skill ska vara återanvändbar mellan projekt och sessioner.
Hemligheter, nycklar och personuppgifter hör aldrig hemma i en skill.
Storlek
Håll SKILL.md under ett par hundra rader. Om den växer: flytta referensmaterial till egna filer i mappen och hänvisa till dem. "Fullständig ordlista i ordlista.md" kostar en rad i kontexten tills den behövs.
Var den ska ligga
I Claude Code: .claude/skills/<namn>/SKILL.md i projektet, eller ~/.claude/skills/<namn>/SKILL.md för dig personligen i alla projekt. I Claude-apparna laddas skills upp under inställningar. Codex, Cursor och andra verktyg som följer standarden har egna mappar, ofta .agents/skills/ eller motsvarande. Kontrollera dokumentationen för din version.
Testa den
Kör tre riktiga uppgifter med skillen. Läs resultatet som den mest kritiska mottagaren skulle göra. Varje gång du rättar agenten: fundera på om rättelsen borde in i skillen. Efter några veckor har du en skill som är bättre än något du hade kunnat skriva från början.