Agent Skills til Claude: sådan bygger du en skill der rent faktisk bliver brugt

En skill er en mappe med instruktioner der lærer Claude at håndtere en bestemt type opgave. Den eneste påkrævede fil hedder SKILL.md og er ren markdown med et lille stykke YAML i toppen. Resten er valgfrit. Forskellen på en prompt og en skill er levetiden: en prompt gælder én samtale, en skill gælder alle samtaler fremover.

• SKILL.md (påkrævet): selve instruktionerne i markdown med YAML frontmatter øverst
• scripts/ (valgfrit): eksekverbar kode i fx Python eller Bash som Claude kan køre
• references/ (valgfrit): uddybende dokumentation der kun indlæses når den er relevant
• assets/ (valgfrit): skabeloner, fonte, ikoner og andet der bruges i outputtet

Progressive disclosure: derfor koster 50 skills stort set ingenting

Skills indlæses i tre niveauer. Ved opstart ser Claude kun navn og beskrivelse på hver enkelt skill. Først når en opgave matcher beskrivelsen, læser Claude selve instruktionerne. Og først når instruktionerne henviser til en underliggende fil, bliver den fil hentet ind. Det er derfor du kan have mange skills installeret uden at betale for dem i context window.

Scripts er et særtilfælde. Når Claude kører et script, ryger selve koden aldrig ind i konteksten - kun scriptets output. Det gør et færdigskrevet valideringsscript markant billigere end at bede Claude om at generere den samme kode hver gang, og resultatet bliver samtidig det samme hver gang.

Skills kan bruges til næsten alt, men tre kategorier går igen hos dem der får mest ud af dem. Find den kategori din opgave hører til, inden du skriver en linje.

1. Dokumenter og faste output

Alt hvor outputtet skal se ens ud hver gang: rapporter, præsentationer, tilbud, frontend-komponenter, produktbeskrivelser. Skillen indeholder din stilguide, din skabelonstruktur og en tjekliste der køres inden noget kaldes færdigt. Den her type kræver ingen eksterne værktøjer.

• Indlejr stilguide og brandregler direkte i skillen
• Definér skabelonstrukturen for outputtet, ikke bare tonen
• Læg en kvalitetstjekliste ind som sidste trin, inden Claude afleverer

2. Workflows med mange trin

Processer hvor rækkefølgen er vigtig, og hvor et enkelt overspringet trin ødelægger resultatet. Onboarding af en ny kunde, månedsafslutning, research efter en fast metode. Her er skillens værdi at den fjerner hukommelsesarbejdet fra mennesket.

• Byg validering ind mellem trinene, så fejl fanges tidligt
• Giv Claude en tjekliste den kan kopiere ind og krydse af undervejs
• Beskriv hvad der skal ske når et trin fejler, ikke kun når det lykkes

3. Ovenpå en MCP-integration

Hvis du allerede har en MCP-server koblet på, har du givet Claude adgang til værktøjerne. Men adgang er ikke det samme som at vide hvad de skal bruges til. En skill oveni fortæller Claude hvilke kald der skal ske i hvilken rækkefølge, og hvad der er god praksis i din organisation.

Den hurtigste vej går ikke gennem et tomt dokument. Den går gennem en opgave du allerede har løst sammen med Claude, hvor du undervejs har forklaret en masse kontekst. Den kontekst er råstoffet til din skill.

1. 01

   Løs opgaven én gang uden skill

   Arbejd dig gennem en rigtig opgave med almindelig prompting. Læg mærke til hvad du forklarer undervejs: tabelnavne, regler, undtagelser, formatkrav. Det er præcis det indhold der skal ind i skillen.

2. 02

   Definér to til tre konkrete use cases

   Skriv ned hvad brugeren siger for at udløse skillen, hvilke trin der skal udføres, og hvad resultatet skal være. Er du i tvivl om use casen, er skillen ikke moden til at blive skrevet endnu.

3. 03

   Bed Claude om at skrive skillen

   Claude kender formatet i forvejen og genererer korrekt struktureret SKILL.md med frontmatter. Du behøver ikke en særlig skabelon: bed om en skill der indfanger det mønster, du lige har brugt, og nævn hvilke regler der skal med.

4. 04

   Skær ned

   Første udkast er altid for langt. Fjern alt Claude allerede ved. Forklaringer af hvad en PDF er, eller hvordan et bibliotek fungerer, er spildte tokens. Hold brødteksten i SKILL.md under 500 linjer, og flyt detaljer ud i separate filer.

5. 05

   Test på en frisk samtale

   Åbn en ny samtale hvor skillen er tilgængelig, og giv en realistisk opgave. Udløses skillen af sig selv? Følger Claude instruktionerne? Skriv ned hvor det går galt, i stedet for at rette med det samme.

6. 06

   Ret på baggrund af det du så

   Ret ét problem ad gangen og test igen. Blev en regel ignoreret, handler det oftest om placering: kritiske instruktioner skal stå øverst, ikke begravet under tre afsnit kontekst.

Lav en skill der indfanger den arbejdsgang vi lige har brugt. Tag tabelnavnene, navngivningsreglerne og reglen om altid at filtrere testkonti fra med.

Gennemgå denne skill og fortæl mig hvor beskrivelsen er for vag, og hvor instruktionerne er for lange.

Hvornår ville du bruge denne skill? Citer den beskrivelse du bygger svaret på.

Organisér indholdet, så tabelskemaerne ligger i en separat referencefil. Vi tilføjer flere tabeller senere.

Der er ét felt der betyder mere end alle andre: description i YAML frontmatter. Det er den eneste del af skillen Claude ser, før den beslutter om skillen er relevant. Er beskrivelsen vag, bliver skillen aldrig indlæst - uanset hvor god resten er.

• Skriv altid i tredje person. Beskrivelsen indsættes i systemprompten, og skiftende synsvinkel forvirrer valget af skill
• Sig både hvad den gør og hvornår den skal bruges. Kun det ene af de to er ikke nok
• Tag de ord med som brugeren faktisk skriver. Filtyper, produktnavne, konkrete formuleringer
• Maks. 1.024 tegn, og ingen XML-tags (< og >) nogen steder i frontmatter

Sådan ser beskrivelser ud der virker

description: Udtrækker tekst og tabeller fra PDF-filer, udfylder formularer og samler dokumenter. Brug når brugeren arbejder med PDF-filer eller nævner formularer eller dokumentudtræk.

description: Styrer projekt-workflows i Linear inklusive sprintplanlægning, oprettelse af opgaver og statusopfølgning. Brug når brugeren nævner sprint, Linear-opgaver eller projektplanlægning.

description: Avanceret dataanalyse af CSV-filer til statistisk modellering, regression og clustering. Brug IKKE til simpel dataudforskning.

Og sådan ser de ud der aldrig bliver valgt

• Hjælper med projekter - for generisk, matcher alt og dermed intet
• Opretter avancerede dokumentationssystemer - ingen udløsere, ingen anelse om hvornår
• Implementerer projektentitetsmodellen med hierarkiske relationer - beskriver koden i stedet for opgaven

Skriv beskrivelsen, som om den skal vælges ud af 100 andre. For det skal den.

De skills der holder i drift, er ikke særligt opfindsomme i deres struktur. De genbruger et af fem mønstre. Vælg det der passer til opgaven, i stedet for at opfinde et nyt.

Problem-først eller værktøj-først

De fleste skills læner sig i én af to retninger. Problem-først starter hos brugeren: jeg skal have sat et projektrum op, og skillen orkestrerer de rigtige kald i den rigtige rækkefølge. Værktøj-først starter hos systemet: vi har Notion koblet på, og skillen lærer Claude den optimale arbejdsgang. Vælger du retning først, giver mønstervalget nærmest sig selv.

Test af skills falder i tre områder. Du behøver ikke alle tre fra dag ét, men du skal vide hvilket område du springer over.

1. Udløses den på de rigtige forespørgsler?

• Kør 10 til 20 testforespørgsler der burde udløse skillen, og tæl hvor mange gange den indlæses af sig selv
• Test både de oplagte formuleringer og de omskrevne: brugere skriver sjældent som du forestiller dig
• Test lige så grundigt at den ikke udløses på urelaterede emner

2. Løser den opgaven korrekt?

• Kør den samme forespørgsel 3 til 5 gange og sammenlign resultaterne for struktur og kvalitet
• Tjek at fejlhåndteringen faktisk træder i kraft, ikke bare at den er beskrevet
• Lad en person der ikke har bygget skillen, løse opgaven med den

3. Er den bedre end ingen skill?

Det er den måling de fleste springer over, og den eneste der overbeviser en ledelse. Kør den samme opgave med og uden skillen, og notér forskellen.

Test desuden med de modeller du reelt kommer til at bruge. En instruktion der er rigelig til Opus, kan være for tynd til Haiku, og en instruktion der er skrevet til Haiku, kan være unødigt lang til Opus.

Næsten alle problemer med skills falder i fire kasser. Find symptomet, og du har løsningen.

Skillen udløses aldrig

Problemet ligger stort set altid i beskrivelsen. Er den for generisk? Indeholder den de ord brugeren faktisk skriver? Nævner den de relevante filtyper?

Skillen udløses hele tiden

• Tilføj negative udløsere: skriv eksplicit hvad skillen ikke skal bruges til
• Bliv mere specifik: Behandler dokumenter bliver til Behandler PDF-kontrakter til juridisk gennemgang
• Afgræns området: skriv hvilken type opgaver der hører til en anden skill

Skillen indlæses, men instruktionerne følges ikke

• Instruktionerne er for lange. Kort dem ned, brug punktopstillinger og flyt detaljer til separate filer
• De kritiske instruktioner er begravet. Læg dem øverst under en tydelig overskrift
• Sproget er upræcist. Erstat en formulering som validér det ordentligt med en konkret liste over hvad der skal tjekkes
• Opgaven er for skrøbelig til sprog. Læg valideringen i et script, så resultatet bliver deterministisk

Skillen kan ikke uploades

• Filen skal hedde præcis SKILL.md med store bogstaver i navnet og lille .md-endelse
• YAML frontmatter skal være omsluttet af tre bindestreger både før og efter
• Mappenavnet skal være i kebab-case uden mellemrum og store bogstaver
• Ved upload til Claude.ai skal mappenavnet stemme overens med skillens navn

Skills er ikke en færdig platform. Der er huller, og de fleste af dem rammer først når du prøver at rulle noget ud til flere mennesker.

• Skills synkroniserer ikke på tværs af overflader. En skill uploadet til Claude.ai er ikke tilgængelig via API, og omvendt. Claude Code læser fra filsystemet og er adskilt fra begge
• Ingen netværksadgang via API. Skills kørt gennem API'et kører i en isoleret container uden internetadgang og uden mulighed for at installere pakker undervejs
• Kun forudinstallerede pakker via API. Har din skill brug for et bibliotek der ikke er med, virker den ikke i den kontekst
• Delingsmodellen varierer. Via API er skills tilgængelige for hele workspacet. På Claude.ai er de som udgangspunkt personlige for den enkelte bruger
• Klar ansvarsfordeling mangler. Der findes ingen indbygget versionshistorik eller godkendelsesflow på Claude.ai, som du kender det fra almindelig softwareudrulning

Der er også en praktisk grænse for hvor mange skills der giver mening ad gangen. Har du 40 skills slået til, hvoraf de 30 er irrelevante for dagens arbejde, bliver valget mellem dem sværere, ikke lettere. Slå til det du bruger, og saml beslægtede funktioner i færre, bredere skills.

Den samme SKILL.md-fil kan bruges alle tre steder, men den skal placeres forskelligt, og adgangen fungerer forskelligt. Vælg overflade ud fra hvem der skal bruge skillen.

Skal skillen bruges via API'et, kræver det code execution tool og de tilhørende beta-headers. Du kan sende op til otte skills med i en enkelt forespørgsel, og hele uploaden skal fylde under 30 MB. Anthropic leverer selv fire færdige skills til dokumentopgaver: pptx, xlsx, docx og pdf.

Claude Code har flere knapper end de andre overflader

Grundformatet er det samme, men i Claude Code kan du styre skillens adfærd langt mere præcist med ekstra felter i frontmatter.

• disable-model-invocation: true gør at kun du kan starte skillen. Brug det til alt med konsekvenser: deploy, commit, udsendelse af beskeder
• user-invocable: false gør det omvendte: kun Claude kan bruge den. Brug det til baggrundsviden der ikke giver mening som en kommando
• allowed-tools og disallowed-tools styrer hvilke værktøjer der er i spil, mens skillen er aktiv
• context: fork kører skillen i sin egen underagent, så den ikke fylder i hovedsamtalen
• paths begrænser hvornår skillen aktiveres, ud fra hvilke filer der arbejdes med

Formatet er udgivet som en åben standard, og en lang række andre agentværktøjer læser efterhånden den samme SKILL.md-fil. Det gør skills til en af de mere holdbare investeringer på området: arbejdet med at beskrive dine processer er ikke bundet til ét produkt.