Claude Skills Tutorial: Bygg din första SKILL.md på 10 minuter (2026)

Claude Skills Tutorial: Bygg din första SKILL.md på 10 minuter (2026)

Skills är den viktigaste Claude Code-funktionen du förmodligen inte använder ännu. En Claude-skill är en mapp med en SKILL.md-fil som Claude laddar automatiskt när din prompt matchar dess beskrivning — ingen kopiering av prompts, ingen uppsvälld CLAUDE.md, inget som kräver att du minns vilken mall du ska hämta. Vi har skeppat 4 skills i det här repots .claude/skills/agent/-mapp, och med Skills 2.0 plus Anthropic Marketplace som landade i början av 2026 har formatet äntligen hittat sin form. Här är mönstret som fungerar när du väl klarat av fallgroparna.

Viktiga insikter

• En Claude-skill är en mapp med en SKILL.md-fil med YAML-frontmatter som Claude laddar automatiskt när det är relevant.
• Skills finns i ~/.claude/skills/ (personliga) eller .claude/skills/ (projekt) — Claude skannar båda vid start.
• Använd Skills för återanvändbara arbetsflöden; använd MCP för levande extern data; använd subagenter för flerstegsplanering; använd hooks för deterministiska händelser.
• Den snabbaste vägen till din första skill är att be Claude anropa sin egen skill-creator-skill — den skriver SKILL.md åt dig.

Vad är Claude Skills?

En Claude-skill är en mapp med en SKILL.md-fil med YAML-frontmatter (name, description, valfria allowed-tools) som Claude Code automatiskt laddar in i kontexten när din prompt matchar beskrivningen. Skills paketerar återanvändbara arbetsflöden — som /commit eller /explain-code — utan att blåsa upp din systemprompt.

Enligt Anthropics officiella dokumentation har varje skill-mapp tre saker: en obligatorisk SKILL.md, valfria medföljande skript (allt från ett Python-hjälpskript till en JSON-konfiguration), och valfria referensdokument som laddas tillsammans med skroppet. Det är allt. Inget byggsteg, ingen installation, inget manifest.

Det smarta är progressiv avslöjning. Vid start skannar Claude bara description-fältet för varje skill. Kroppen — instruktioner, exempel, verktygsanropsmönster — ligger kvar på disk tills din prompt faktiskt matchar. Du kan alltså ha 50 skills installerade och betala noll token-kostnad tills en av dem triggas.

Tänk på skills som kokboksrecept som Claude bläddrar till när den ser ingredienserna i din prompt. En skill är en mapp Claude läser på begäran — inte en prompt du måste komma ihåg att klistra in. Det är hela grejen.

En minimal SKILL.md ser ut så här:

---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---

Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.

Tio rader. Riktig skill. Redo att köra.

Snabbstart: Bygg din första skill på 10 minuter

För att bygga din första Claude-skill på 10 minuter: (1) skapa ~/.claude/skills/explain-code/, (2) lägg till en SKILL.md-fil med name, description och arbetsflödeskroppen, (3) starta om Claude Code så att det skannar den nya katalogen, (4) trigga den med en prompt som matchar beskrivningen.

Här är hela flödet.

Steg 1: Skapa katalogen

mkdir -p ~/.claude/skills/explain-code

Personliga skills (bara för dig) hamnar under ~/.claude/skills/. Projektskills (delade via git med ditt team) hamnar under .claude/skills/ i repots rot. Välj personliga för dagliga arbetsflöden; välj projekt när du vill att alla bidragsgivare i repot ska ärva dem.

Steg 2: Skriv SKILL.md

Lägg den här filen på ~/.claude/skills/explain-code/SKILL.md:

---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---

You are explaining code to a developer who is new to this codebase.

1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.

Det är hela skillen. Frontmattern är kontraktet; kroppen är spelplanen.

Steg 3: Starta om Claude Code

Live-discovery är en Skills 2.0-funktion — äldre Claude Code-versioner behöver en omstart för att plocka upp den nya katalogen. Om du inte är säker på vilken version du kör kostar en omstart ingenting.

Steg 4: Trigga den

Öppna ett projekt och skriv:

walk me through what auth/middleware.ts does

Claude matchar din prompt mot description-fältet, hittar explain-code och laddar tyst in SKILL.md-kroppen i kontexten. Du ser "Using skill: explain-code" i verktygsloggen. Klart.

Protips: Kan du inte orka skriva filen själv? Öppna Claude Code och säg Use the skill-creator skill to scaffold an explain-code skill for me. Anthropics medföljande skill-creator är en meta-skill som intervjuar dig, väljer vettiga allowed-tools och skriver SKILL.md till rätt mapp. Det snabbaste sättet att komma igång, punkt.

Det var 10-minuterslöftet — fem minuters skrivande, en omstart, en testprompt.

Inuti SKILL.md: Frontmatter-referensen

SKILL.md-frontmatter är YAML insvept i ----avgränsare. Två fält är obligatoriska: name (≤64 tecken, används som slash-kommandots namn) och description (utlösartexten Claude matchar mot din prompt). Valfria fält styr verktygsåtkomst, modellanrop, filglobbar och körningskontext.

Här är den fullständiga referensen, hämtad från Anthropics skills-dokumentation:

Raden context: fork förtjänar en notering. Det är ett Skills 2.0-primitiv som kör skillen inuti ett isolerat kontextfönster — användbart för långvariga research-skills eller allt som producerar många mellanliggande tokens som du inte vill förorena din huvudtråd med. Om det är ett nytt begrepp för dig täcker vår guide om context engineering avvägningarna.

En maximalistisk SKILL.md-frontmatter med alla fält ifyllda:

---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---

Protips: Det enskilt största misstaget i description: att skriva det för människor. Skriv det för Claude — konkreta utlösarfraser, inte marknadsföringskopia. Dåligt: "En kraftfull Git-automatiseringsskill." Bra: "Use when the user wants to commit changes, write a commit message, or open a PR."

Två riktiga skills, från start till slut

Två skill-mönster täcker 80 % av verkliga användningsfall: (1) en användarstyrd /commit-skill med disable-model-invocation: true och allowed-tools: Bash(git *) för deterministiska åtgärder; (2) en auto-triggad /explain-code-skill med standard-frontmatter som Claude triggar när prompts matchar beskrivningen.

De flesta tutorials visar kodavsnitt. Här är två kompletta filer du kan kopiera in i ~/.claude/skills/ idag.

Skillen /commit (användarstyrd)

---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
  - "Bash(git status:*)"
  - "Bash(git diff:*)"
  - "Bash(git add:*)"
  - "Bash(git commit:*)"
---

1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
   changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
   blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.

Testprompt: /commit

Vad som händer: Claude inspekterar git-tillståndet, skissar ett meddelande, ber dig bekräfta och kör sedan git commit. disable-model-invocation: true innebär att den aldrig auto-triggas på en vag "spara mina ändringar"-prompt — den körs bara när du skriver /commit. allowed-tools-vitlistan låser den till git-underkommandon; den kan fysiskt inte köra rm -rf eller pusha till remote. Det här är en vi skeppar live i vår egen pipeline.

För deterministiska åtgärder efter commit (kör lint, regenerera typer, pinga en Slack-webhook) — använd Claude Code hooks istället — skills är probabilistiska, hooks körs varje gång.

Skillen /explain-code (modellanropad)

---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---

1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
   the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.

Testprompt: walk me through what auth/middleware.ts does

Vad som händer: notera att användaren inte skrivit /explain-code. Claude matchar "walk me through" mot description-fältet, hittar skillen och anropar den automatiskt. Det är magin — description sköter routingen. Fältet model: claude-opus-4-7 pinnar den här skillen till Opus oavsett vilken modell du har satt som standard, så djupa kodgenomgångar får alltid den smartare modellen. (Mer om att köra Claude Code med olika modeller.)

Varför två mönster? Skill nr 1 är användarstyrd och låst till specifika verktyg — förutsägbar, säker, perfekt för git eller deployments. Skill nr 2 är auto-triggad och öppen — det magiska med skills, men lita på description-fältet. Användarstyrd skill ger förutsägbarhet; modellanropad skill ger magi. Välj per skill, inte per repo.

Fler riktiga skill-exempel hittar du i det officiella anthropics/skills-repot och den community-underhållna awesome-claude-skills-listan.

Skills vs MCP vs Subagenter vs Hooks: När du använder vad

Använd Skills för återanvändbara arbetsflöden som Claude ska auto-trigga eller som du anropar som slash-kommandon. Använd MCP-servrar när du behöver levande extern data (databaser, API:er, filsystem utanför arbetskatalogen). Använd subagenter för flerstegsplaner som Claude ska delegera till en ny kontext. Använd hooks för deterministiska händelser (pre-commit, post-tool-use) som alltid måste köras — aldrig probabilistiskt.

Kort sagt: skills är arbetsflöden, Model Context Protocol är data, subagenter är planer, hooks är händelser. Var och en lever på ett annat lager i Claude Code, och fel lager är fel verktyg. Enligt Anthropics eget Skills explained-inlägg är det här tänkesättet de vill att du ska internalisera.

De komponerar. En skill kan anropa ett MCP-verktyg via allowed-tools. En hook kan köras efter att en skill slutförts. En subagent kan använda skills den fått åtkomst till. Det renaste mentala modellen: välj rätt lager först, låt dem sedan staplas. Skills är det context engineering-primitiv du når efter när du vill ha ett arbetsflöde Claude kan välja; du automatiserar med hooks när du vill ha något Claude inte kan hoppa över.

Det värsta sättet att missbruka varje: Skills för levande data (använd MCP); MCP för enstaka promptmallar (använd Skills); subagenter för deterministiska filredigeringar (använd hooks); hooks för förgrenad logik (använd Skills). Skills är arbetsflöden, MCP är data, subagenter är planer, hooks är händelser. Välj efter lager, inte efter buzzword.

Var skills bor: Personliga, Projekt, Plugin, Enterprise

Claude-skills installeras i fyra scope: personliga (~/.claude/skills/, bara du), projekt (.claude/skills/ i repots rot, ditt team via git), plugin (distribuerade via Anthropic Marketplace eller valfri plugin-URL) och enterprise (pushed av IT via MDM/adminpolicy). Claude skannar alla fyra vid start.

De inbyggda doc-skills är lätta att glömma — Claude Code levererar redan med pdf-, docx-, pptx- och xlsx-skills ur lådan, plus ett litet bibliotek av /debug, /simplify och liknande inbyggda. (Systerverktyget Claude Design levereras med sina egna inbyggda arbetsflödesskills för designgenerering; samma modell, annan domän.)

När skeppar du via plugin istället för projekt? Plugins vinner när samma arbetsflöde gynnar flera repos — en /release-skill du använder över fem klientkodbaser hör hemma i ett plugin, inte kopierat in i varje repos .claude/skills/. Projektskills vinner för kodbaspecifika konventioner (ditt teams PR-mall, din anpassade testlöpare). Anthropic Marketplace, plus /plugin install från valfri URL, gör plugins till rätt svar för återanvändning över repos. Enligt plugin-dokumentationen hanteras discovery och uppdateringar automatiskt.

Avancerade mönster: $ARGUMENTS, Dynamisk shell-injektion, context: fork

Tre avancerade skill-mönster spelar störst roll: $ARGUMENTS låter användare skicka parametrar till användarstyrade skills (/translate $ARGUMENTS); dynamisk shell-injektion (med allowed-tools: Bash(...)) låter en skill köra skript och röra utdata in i kontexten; och context: fork (Skills 2.0) kör skillen i ett isolerat kontextfönster. Anthropics Complete Guide whitepaper är den kanoniska referensen för context: fork per maj 2026.

$ARGUMENTS för parameteriserade skills

---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---

Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.

Testprompt: /translate spanish. Claude substituerar spanish för $ARGUMENTS vid körning. Det renaste sättet att göra en skill mångsidig utan att skriva varianter.

Dynamisk shell-injektion via allowed-tools

---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---

Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.

Skillen shellar ut, rörar diffen in i kontexten och granskar den. Lås allowed-tools till specifika kommandon (Bash(git diff HEAD~1:*)), aldrig bart Bash — naken Bash-behörighet är säkerhetsfelversionen av det här mönstret.

context: fork (Skills 2.0)

---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---

Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.

Förgrening ger skillen sitt eget kontextfönster, så de 50 000 tokens av mellanliggande forskningsnoteringar inte blöder in i din huvudsession. Användbart för lång research, stor omstruktueringsplanering eller allt som producerar många throw-away-tokens. Bara Skills 2.0 — äldre Claude Code-versioner ignorerar fältet.

Felsökning: Varför din skill inte triggar

Skills misslyckas vanligtvis med att trigga av en av fyra anledningar: (1) description är för generisk för att Claude ska matcha den mot din prompt, (2) katalogen är på fel sökväg (.claude/skills/ inte claude/skills/), (3) Claude Code startades inte om efter att skillen lades till (bara pre-Skills-2.0), eller (4) skill-namnet krockar med en inbyggd eller högre-prioritets-skill. Enligt de mest googlad felmödena i Claude Code GitHub issues tracker täcker dessa fyra ~95 % av "varför fungerar det inte"-rapporter.

Felläge 1: "Min skill visas inte alls"

Den vanligaste orsaken är fel sökväg — .claude/skills/ (med punkt) vs claude/skills/ (utan punkt) är ett stavfel vi alla gjort kl. 1 på natten. Kör ls -la ~/.claude/skills/ för att bekräfta att katalogen finns med punkt. Om den finns där och Claude fortfarande inte ser den, starta om Claude Code en gång. Pre-Skills-2.0-versioner skannar bara vid start.

Felläge 2: "Claude auto-anropar inte min skill"

description-fältet är för vagt eller skrivet för människor, inte Claude. Skriv om det med konkreta utlösarfraser som speglar hur användare faktiskt formulerar förfrågningar. Efter att ha byggt 4 skills för det här repot var fallgropen att lämna kvar beskrivningar som "En hjälpsam skill för SEO." Värdelöst. Skriv om till: "Use when the user wants to add JSON-LD schema, meta tags, or SEO frontmatter to a Markdown post." Triggningsprecisionen gick från ~30 % till ~95 %. Triggningsprecision lever och dör i description-fältet. Skriv det för Claude, inte för ditt CV.

Felläge 3: "Beskrivningen trunkerades i slash-kommandopaletten"

Antingen är din description över 1 024 tecken eller din name över 64 tecken. Båda har hårda gränser. Lösning: dela skillen i två smalare skills, eller flytta det långa detaljerna in i SKILL.md-kroppen. Frontmattern är för routing, inte dokumentation.

Felläge 4: "Live change detection fungerar inte"

Pre-Skills-2.0 Claude Code kräver en fullständig omstart efter varje SKILL.md-redigering. Om du itererar på en skill och dina ändringar inte tar, kör du förmodligen ett äldre bygge. Antingen uppgraderar du till en Claude Code-version som levereras med Skills 2.0 (live-discovery) eller vänjer dig vid att starta om efter varje sparning. Irriterande, men billigt.

Skills bortom Claude: Den öppna Agent Skills-standarden

Ja — skills är en öppen standard. Agent Skills-standarden på agentskills.io definierar SKILL.md-formatet oberoende av leverantör. OpenAI:s Codex CLI och ChatGPT Desktop antog standarden i december 2025; samma SKILL.md du skriver för Claude Code körs i Codex med mindre frontmatter-tweaks.

Här är stödmatrisen för verktyg per maj 2026: Claude Code har fullt stöd för Agent Skills (referensimplementationen). OpenAI:s Codex CLI har fullt stöd. ChatGPT Desktop har partiellt stöd — name, description och kroppen fungerar, men allowed-tools-paritet finns inte ännu. Gemini CLI annonserade stöd i början av 2026 men hade inte levererat det när det här skrevs. Cursor är det udda exemplet — det använder sitt eget Cursor rules-format och läser inte SKILL.md nativt, även om community-shims finns.

Vad du ska skriva idag för att dina skills ska överleva året: håll name och description rena och leverantörsneutrala. Isolera leverantörsspecifik frontmatter bakom ett namnrymd (claude: eller codex:) om du går cross-tool. Den portabla ytan — name, description, kropp, $ARGUMENTS — fungerar överallt; avancerade fält som context: fork är Claude-specifika tills andra leverantörer levererar motsvarigheter. Anthropic driver också djupare marketplace-integration enligt det läckta Claude Code-färdplanen, så portabilitet kommer bara bli enklare.

De tre platserna att leta efter exempel-skills: anthropics/skills (officiell), awesome-claude-skills (community), och agentskills.io (standardens spec-sida). Skills är inte längre en Claude-funktion. De är en öppen standard som Claude levererade först.

FAQ

Vad är skillnaden mellan en Claude-skill och en MCP-server?

En Claude-skill är en SKILL.md-fil med arbetsflödesinstruktioner som Claude laddar när din prompt matchar beskrivningen. En MCP-server är en separat process som Claude anropar för att hämta levande data (databaser, API:er, filsystem utanför arbetskatalogen). Använd Skills för arbetsflöden; använd MCP för data. De komponerar — skills kan anropa MCP-verktyg.

Är Claude Skills gratis?

Ja — Skills är en inbyggd Claude Code-funktion, ingen extra kostnad. Du betalar bara för de modell-tokens som förbrukas när en skill körs. Skills du installerar från Anthropic Marketplace kan vara betalda (ovanligt idag), men det officiella anthropics/skills-repot och community awesome-listorna är alla gratis att kopiera och använda.

Var installeras Claude Skills?

Personliga skills hamnar i ~/.claude/skills/{skill-name}/, projektskills i .claude/skills/{skill-name}/ i repots rot. Plugin-skills installeras via /plugin install <url> och bor i din plugin-katalog. Enterprise-skills pushed av din organisations IT via hanterade inställningar. Claude Code skannar alla fyra scope vid start.

Hur skapar jag en Claude-skill från grunden?

Skapa en mapp under ~/.claude/skills/, lägg till en SKILL.md-fil med YAML-frontmatter (name, description) följt av arbetsflödesinstruktionerna, och starta om Claude Code. Det snabbaste sättet: öppna Claude Code och be den anropa den inbyggda skill-creator-skillen — den ger dig ett SKILL.md-skelett på under en minut.

Varför triggar inte min Claude-skill?

De fyra vanligaste orsakerna: (1) description är för vag för att Claude ska matcha den mot din prompt — skriv om med konkreta utlösarfraser; (2) skillen är på fel sökväg (.claude/skills/ inte claude/skills/); (3) Claude Code behöver en omstart på pre-Skills-2.0-versioner; (4) skill-namnet krockar med en inbyggd skill. Verifiera med ls -la ~/.claude/skills/.

Kan ChatGPT eller Cursor använda Claude Skills?

ChatGPT Desktop och Codex CLI stödjer samma Agent Skills-standard som Claude — samma SKILL.md körs i båda med mindre frontmatter-ändringar. Cursor använder sitt eget Cursor rules-format och läser inte SKILL.md nativt. Gemini CLI annonserade stöd i början av 2026 men hade inte levererat per maj 2026.

Vad är skill-creator-skillen?

skill-creator är en meta-skill inbyggd i anthropics/skills-repot som hjälper Claude att skriva nya SKILL.md-filer åt dig. Berätta vad du vill att skillen ska göra; skill-creator intervjuar dig om beskrivningen, väljer vettiga allowed-tools och skriver SKILL.md till rätt mapp. Snabbast möjliga skelett.

Vad gör disable-model-invocation?

Att sätta disable-model-invocation: true i din skills frontmatter förhindrar Claude från att auto-trigga skillen baserat på prompt-matchning. Skillen blir enbart användarstyrd — den visas i slash-kommandopaletten som /skill-name och körs bara när den anropas explicit. Använd det för destruktiva eller deterministiska åtgärder som /commit eller /deploy.

Bygg några skills, skeppa dem i ett projekt, se vad som funkar. Om ditt team stöter på klustret av "skill triggar inte"-problem över flera repos och du vill ha ett extra par ögon på din .claude/skills/-setup, hör av dig — kul att gå igenom det.