Claude Skills: den komplette guide til at bygge din første skill

En skill er en mappe med instruktionsfiler som Claude kan hente frem og bruge, præcis når det er relevant. I stedet for at paste de samme instruktioner ind i hvert chat, lærer du Claude det én gang. Herefter aktiverer den sig selv automatisk — eller du kalder den direkte med /skill-navn.

Det centrale er progressive disclosure: Claude loader kun det nødvendige, når det er nødvendigt. Skill-beskrivelsen sidder altid i Claudes kontekst, men selve instruktionerne loader kun, når Claude vurderer at de er relevante for opgaven. Det betyder at du kan pakke meget kontekst ind i en skill, uden at det koster tokens i hvert eneste chat.

Skills vs. prompts vs. CLAUDE.md

Skills løser ikke én type opgave — de dækker et bredt spektrum fra dokumentgenerering til kompleks automatisering. Erfaringer fra tidlige brugere og interne teams peger på tre kategorier som skills løser særligt godt.

Kategori 1: Dokument- og indholdsgenerering

Du vil have Claude til konsekvent at producere output der følger din stilguide, dine skabeloner eller dine brandstandarder — hvad enten det er rapporter, præsentationer, tilbud eller kode. Skills løser dette ved at pakke skabeloner og standarder ind i en genanvendelig instruktionspakke.

• Eksempler på use cases: ugentlige statusrapporter, kundemail-skabeloner, teknisk dokumentation, kodereviews
• Nøgleteknik: indlejrede stilguider og brandstandarder, skabelonstrukturer for konsekvent output, valideringstjeklister
• Kræver: ingen MCP-integration — Claude bruger sine egne indbyggede evner

Kategori 2: Workflow-automatisering

Du vil have Claude til at udføre en flertrinsprocedure med konsekvent metodologi — typisk på tværs af flere systemer. Skills strukturerer rækkefølgen og validerer undervejs.

• Eksempler på use cases: sprint-planlægning, onboarding af nye kunder, udrulning til produktion
• Nøgleteknik: trin-for-trin workflow med valideringspunkter, skabeloner til standardstrukturer, iterative forbedringsløkker
• Kræver: typisk MCP-integration til systemer som Linear, Notion eller Slack

Kategori 3: MCP-forbedring

Du har allerede en MCP-server der giver Claude adgang til et eksternt system. Skills tilføjer det lag af ekspertviden og best practices som rå tool-adgang ikke giver. MCP leverer køkkenet — skills leverer opskrifterne.

• Eksempler på use cases: projektworkflows i Asana, code review via GitHub MCP, betalingsflows med Stripe
• Nøgleteknik: koordinering af MCP-kald i rækkefølge, domæneekspertise indlejret i logikken, fejlhåndtering for kendte MCP-problemer
• Kræver: eksisterende og fungerende MCP-server for det relevante system

En skill er en mappe med et bestemt navn og en obligatorisk fil: SKILL.md. Resten er valgfrit. Mappens navn er det du skriver for at kalde skillen direkte — fx /sprint-planning — og SKILL.md indeholder to dele: YAML frontmatter øverst og selve instruktionerne nedenunder.

Filstrukturen

• SKILL.md (obligatorisk): hovedinstruktioner og metadata — hold den under 500 linjer
• scripts/ (valgfri): eksekverbar kode — Python, Bash osv. som Claude kan køre
• references/ (valgfri): detaljeret dokumentation der loades efter behov, ikke ved hvert kald
• assets/ (valgfri): skabeloner, ikoner og andre filer der bruges i output

YAML frontmatter: de vigtigste felter

Frontmatter er konfigurationen øverst i SKILL.md, afgrænset af --- på begge sider. Alle felter er valgfrie, men description er stærkt anbefalet — det er det felt Claude bruger til at beslutte om skillen er relevant for den aktuelle opgave.

Den mest effektive tilgang er at starte med én enkelt opgave du kender godt, gentage den i Claude til resultatet er præcis som du vil have det — og derefter fange den tilgang i en skill. Du behøver ikke designe for alle edge cases fra starten. Skills er levende dokumenter.

1. 01

   Identificér use casen

   Find en opgave du løser gentagne gange. Spørg dig selv: hvad forklarer du Claude hver gang? Hvad copy-paster du fra et tidligere chat? Det er din skill. Skriv use casen ned i én sætning, fx: "Generer et ugentligt statusopdatering i vores interne format."

2. 02

   Opret mappestrukturen

   Opret en mappe med dit skill-navn i kebab-case. I Claude Code oprettes personlige skills her: bash mkdir -p ~/.claude/skills/dit-skill-navn For et projektspecifikt skill: .claude/skills/dit-skill-navn/

3. 03

   Skriv SKILL.md

   Opret filen og skriv to dele: YAML frontmatter med name og description, efterfulgt af dine instruktioner. Hold SKILL.md under 500 linjer — flyt detaljeret referencemateriale til en separat references/-mappe. Minimalt eksempel: yaml --- name: status-opdatering description: Genererer ugentlig statusopdatering i vores format. Brug når du siger 'lav status', 'ugentlig rapport' eller 'skriv statusmail'. --- ## Instruktioner Generer en ugentlig statusopdatering der inkluderer afsluttede opgaver, igangværende opgaver og blokeringer...

4. 04

   Test triggering

   Åbn Claude Code i et projekt og test at skillen aktiveres. Prøv to tilgange: Automatisk: Sig noget der matcher din description, fx "kan du lave en ugentlig status?" Manuel: Kald den direkte med /status-opdatering Hvis skillen ikke trigger automatisk, er din description sandsynligvis for generisk. Tilføj de præcise fraser brugerne ville sige.

5. 05

   Gentag og forfin

   Kør den samme opgave 3-5 gange og notér hvad der er inkonsekvent. Ret direkte i SKILL.md — Claude Code opdager ændringer med det samme uden at du skal genstarte sessionen.

Eksempler på gode og dårlige descriptions

En skill du kun har testet én gang er ikke en skill du kan stole på. Tests er ikke ekstra arbejde — det er det der afgør om du har sparet tid eller skabt en ny kilde til fejl. Der er tre testtyper der tilsammen giver et godt billede.

1. Trigger-tests

Formålet er at sikre at din skill loader ved de rigtige anmodninger — og ikke loader ved irrelevante. Kør mindst 10-20 testforespørgsler: halvdelen bør trigge skillen, halvdelen bør ikke. Skriv dem ned som dit personlige test-suite.

• Bør trigge: åbenlyse anmodninger og omformulerede versioner af dem
• Bør ikke trigge: urelaterede emner, generelle spørgsmål, andre skills' territorium

2. Funktionelle tests

Kør den samme anmodning 3-5 gange og sammenlign output. Er resultatet strukturelt konsekvent? Er kvaliteten stabil? Fungerer fejlhåndtering? Er output korrekt selv ved edge cases?

3. Performancesammenligning

Det der beviser en skills værdi er sammenligning med og uden den. Tæl antal beskeder, fejlede forsøg og forbrugte tokens på en typisk opgave — med og uden skill aktiv. Det tal er din ROI-dokumentation over for teamet.

Skills er et relativt nyt system og der er ting som ikke altid virker første gang. Her er de hyppigste problemer og hvad du gør ved dem.

Skill loader ikke automatisk

• Description er for generisk — tilføj konkrete trigger-fraser og nøgleord som brugerne naturligt ville sige
• SKILL.md er ikke korrekt navngivet — tjek at det er præcis SKILL.md med store bogstaver som vist
• YAML frontmatter mangler `---` afgrænsere — begge --- skal være til stede, både øverst og nederst

Skill loader for tit og ved irrelevante anmodninger

• Gør description mere specifik og afgræns scope tydeligt i teksten
• Tilføj negative triggers i description, fx: "Brug IKKE til generel dataanalyse — brug data-viz skill i stedet."
• Sæt disable-model-invocation: true i frontmatter og kald den kun manuelt med /navn

Claude følger ikke instruktionerne

• Instructions er for lange eller vage — hold dem korte, konkrete og handlingsorienterede
• Kritiske instruktioner er begravet i teksten — sæt dem øverst med en tydelig overskrift som ## KRITISK
• SKILL.md er for stor — hold den under 500 linjer og flyt detaljeret referencemateriale til references/-filer

MCP-kald fejler

• Verificér at MCP-serveren er forbundet i Claude: Indstillinger > Udvidelser > tjek at serveren viser "Connected"
• Bekræft at API-nøglen er gyldig og ikke er udløbet — forny OAuth-tokens hvis nødvendigt
• Test MCP direkte uden skill: bed Claude kalde MCP-tool manuelt. Fejler det der, er problemet i MCP-konfigurationen, ikke i skillen
• Tjek at tool-navne i skill-instruktionerne matcher præcis dem i MCP-dokumentationen — de er case-sensitive

Hvor du placerer din skill afgør hvem der har adgang til den. Der er fire niveauer, og de overstyrer hinanden i rækkefølge — enterprise overstyrer personlig, personlig overstyrer projekt.

Del via GitHub

Projektspecifikke skills committer du blot til version control som en del af .claude/skills/-mappen — så har alle der cloner projektet adgang til dem. For skills du vil dele bredere, er det anbefalede setup et offentligt GitHub-repository med en klar README, installationsinstruktioner og screenshots af hvad skillen gør.

Har du allerede en MCP-server til dit produkt, kan du tilføje en sektion i din eksisterende dokumentation der linker til skillene og forklarer værdien af at bruge begge dele. Skills giver din MCP-integration en konkurrencefordel: brugere der sammenligner integrationer vælger den der har mindst friktion og mest vejledning.

Når din første skill virker konsekvent, er der tre mønstre der åbner for markant mere avancerede workflows. De kræver ikke at du er udvikler — men de kræver at du forstår hvad du sætter i gang.

Dynamisk kontekstinjektion

Med syntaksen kommando i SKILL.md kan du køre shell-kommandoer der udføres inden Claude ser indholdet. Resultatet indsættes direkte i prompten, så Claude modtager reelle data — ikke en beskrivelse af hvad den skal finde.

Eksempel: !git diff HEAD kører diff'en og indsætter de faktiske ændringer direkte i prompten, så Claude kan reviewe din præcise kode — ikke hvad den gætter på ud fra filnavne.

Subagent-eksekvering

Med context: fork i frontmatter kører din skill i en isoleret subagent-kontekst uden adgang til din samtalehistorik. Det er særligt nyttigt til research-opgaver, eksplorative analyser eller længerevarende processer der ikke skal fylde din primære chat. Subagenten returnerer et resumé til din hoveddialog.

Multi-MCP koordinering

Én skill kan koordinere kald på tværs af flere MCP-servere i rækkefølge. Et eksempel: hent designassets fra Figma MCP → gem dem i Google Drive MCP → opret udviklingsopgaver i Linear MCP → send notifikation i Slack MCP. Skills holder styr på rækkefølgen, valideringspunkterne og fejlhåndteringen — Claude eksekverer hvert trin.

Prompt-eksempler til at komme i gang

Hjælp mig med at bygge en skill til [dit use case] — generer en SKILL.md med korrekt frontmatter og instruktioner

Review denne skill og fortæl mig hvad der mangler, hvad der er for vagt og om der er risiko for over-triggering

Hvornår ville du bruge [skill-navn] skill'en? Citér beskrivelsen og forklar hvad der mangler

Lav et test-suite med 10 anmodninger der BØR trigge denne skill og 10 der IKKE bør