Description-feltet i SKILL.md: sådan bliver din Skill brugt

Du kan skrive den bedste skill i verden. Fylde body-sektionen med skarpe instruktioner, gode eksempler og detaljerede gotchas. Intet af det betyder noget hvis Claude aldrig aktiverer den.

Og det er præcis hvad der sker for de fleste. De skriver en skill, tester den manuelt med /skill-navn, og den virker fint. Men når de bare beder Claude om at løse opgaven i naturligt sprog, uden at nævne skill-navnet, sker der ingenting. Claude bruger sin standardopførsel og ignorerer skillen fuldstændigt.

Problemet er næsten altid det samme: description-feltet.

Claude læser en menu: din description er retten

Når Claude Code starter, bygger den en oversigt over alle tilgængelige skills. For hver skill læser den name-feltet og description-feltet. Ikke body. Ikke instruktionerne. Kun overskriften og beskrivelsen.

Når du derefter skriver en besked, scanner Claude denne oversigt og stiller sig selv ét spørgsmål: “Er der en skill der matcher det her?”

Hvis din description er vag, finder Claude ingen match. Hvis din description er præcis og indeholder de rigtige triggere, aktiverer Claude skillen automatisk.

Det er præcis som en restaurant-menu. Hvis en ret hedder “Noget godt” uden yderligere beskrivelse, bestiller ingen den. Hvis den hedder “Grillet entrecôte med bearnaise, serveret med pommes frites og grøn salat”, og du har lyst til bøf, bestiller du den med det samme.

Description-ordvalg har 20x indflydelse på aktivering

Scott Spence, udvikler og tidlig Claude Code-bruger, kørte over 200 tests med forskellige description-formuleringer for den samme skill. Resultaterne var tydelige. Ivan Seleznov lavede en lignende analyse med 650 forsøg og bekræftede mønsteret. Her er hvad dataen viser:

De fire niveauer af description-kvalitet

Fra 20% til 90%. Samme skill. Samme body. Samme instruktioner. Den eneste forskel er 1-2 sætninger i description-feltet.

Samme skill, 20x forskel i praktisk nytte. En skill der aktiverer 20% af tiden er ubrugelig. En skill der aktiverer 90% af tiden er et værktøj du rent faktisk stoler på.

Formlen: Hvad + Hvornår + Trigger-ord

Baseret på dataen fra Spence, Seleznov og Anthropics egne anbefalinger er der en formel der konsekvent giver høj aktivering:

[Hvad den gør] + [Hvornår den skal bruges] + [Specifikke trigger-keywords]

De tre dele:

1. Hvad den gør. En klar, direkte beskrivelse af skillens funktion. Brug aktive verber: “Genererer”, “Analyserer”, “Omskriver”, ikke “Hjælper med” eller “Kan bruges til.”
2. Hvornår den skal bruges. En eksplicit instruktion til Claude om hvornår denne skill er relevant. Start med “Use when…” eller “Activate when…”
3. Trigger-keywords. De specifikke ord og fraser en bruger sandsynligvis vil skrive når de har brug for denne skill.

Før og efter: 5 eksempler

1. Kodereview

❌ "Helps with code review"

✅ "Reviews code for security vulnerabilities, performance issues,
and convention violations. Use when user mentions 'review', 'PR',
'pull request', 'check code', or asks to evaluate code quality."

2. SEO-indhold

❌ "Writes SEO content"

✅ "Writes SEO-optimized Danish blog posts targeting specific keywords.
Follows the site's style guide and internal linking conventions. Use
when user asks to 'write', 'create', or 'draft' content for the
website, or mentions 'SEO', 'keyword', or 'blog post'."

3. Fakturagenerering

❌ "Creates invoices"

✅ "Generates PDF invoices from project data using the company template.
Calculates VAT, applies payment terms, and formats for Danish
accounting standards. Use when user mentions 'faktura', 'invoice',
'regning', 'billing', or asks to generate financial documents."

4. Ugentlig rapport

❌ "Makes weekly reports"

✅ "Compiles a weekly progress report from git commits, completed tasks,
and team updates. Formats for Slack posting with summary, metrics,
and blockers. Use when user mentions 'weekly report', 'ugerapport',
'status update', 'standup', or 'opsummering'."

5. Database-migrering

❌ "Handles database migrations"

✅ "Creates and validates database migration files following the project's
migration conventions. Checks for breaking changes and generates
rollback scripts. Use when user mentions 'migration', 'migrering',
'schema change', 'add column', 'alter table', or asks to modify
database structure."

Læg mærke til mønsteret: den gode version er specifik om hvad skillen gør, eksplicit om hvornår den skal bruges, og lister de ord en bruger typisk ville skrive.

De to grænser du skal kende

Der er to hårde begrænsninger for descriptions i Claude Code:

1. Maks 1024 tegn per description

Din description kan ikke overstige 1024 tegn. Det lyder som meget, men når du først begynder at tilføje trigger-keywords, fylder det hurtigt.

Prioritér sådan:

1. Hvad skillen gør (vigtigst, uden dette intet match)
2. De 5-8 mest sandsynlige trigger-keywords
3. Hvornår den skal bruges (kontekst)

Skær i trigger-keywords før du skærer i funktionsbeskrivelsen. Det er bedre at have en klar beskrivelse af hvad skillen gør med færre triggere end en vag beskrivelse med mange triggere.

2. Maks 15.000 tegn for ALLE descriptions tilsammen

Det her er den begrænsning de fleste overser. Claude Code har en samlet grænse på 15.000 tegn for alle skill-descriptions i et projekt. Overskrid den, og Claude begynder at afkorte eller ignorere descriptions.

Hvad det betyder i praksis:

• Med 200-tegns descriptions kan du have ~75 skills
• Med 500-tegns descriptions kan du have ~30 skills
• Med 1024-tegns descriptions kan du have ~14 skills

For de fleste enkeltpersoner og små teams er det fint. Men hvis du bygger en stor samling af skills, som vi gør med 60+ skills hos Primux, skal du være bevidst om budgettet.

Tip: Hold descriptions på 150-300 tegn. Det er nok til formlen (hvad + hvornår + triggere) uden at spilde budgettet.

Skill Creator’s trigger-optimering

Hvis du ikke vil gætte på de rigtige trigger-keywords, kan du lade Skill Creator gøre arbejdet. Ray Amjad, der har bygget en af de mest brugte skill-creator-skills, har en automatisk optimeringsproces:

1. Generer 20 test-queries. Skill Creator genererer 20 realistiske prompter en bruger kunne skrive: 15 til træning og 5 til test.
2. Test aktivering. For hver query tjekker den om skillen ville blive aktiveret med den nuværende description.
3. Iterér. Baseret på resultaterne justerer den description-feltet: tilføjer manglende triggere, fjerner støj, omformulerer.
4. Gentag op til 5 gange. Processen kører op til 5 iterationer eller indtil aktiveringsraten rammer målet.

Resultatet er en description der er optimeret mod realistisk brug, ikke mod hvad du tror folk vil skrive.

Du kan bruge den direkte:

Brug skill-creator til at optimere description-feltet
for min [skill-navn] skill

Men selv uden Skill Creator kan du bruge princippet manuelt. Skriv 10 variationer af hvordan du ville bede om denne opgave. Er de trigger-keywords du bruger til daglig repræsenteret i din description? Hvis ikke, tilføj dem.

Skriv din første description nu

Her er øvelsen. Den tager 5 minutter.

Trin 1. Vælg den opgave du udfører oftest i din arbejdsuge. Det kan være at skrive et kundetilbud, reviewe kode, generere en rapport, opdatere et regneark, hvad som helst du gør mindst én gang om ugen.

Trin 2. Skriv 5 måder du ville bede om den opgave i naturligt sprog. Ikke formelt. Bare som du faktisk ville skrive det i en chat:

• “Lav en ugerapport”
• “Hvad har vi lavet denne uge?”
• “Skriv status til teamet”
• “Opsummér ugens arbejde”
• “Send weekly update”

Trin 3. Brug formlen:

[Hvad den gør] + [Hvornår den skal bruges] + [Trigger-keywords fra trin 2]

Trin 4. Tjek: Er din description under 300 tegn? Bruger den aktive verber? Indeholder den de ord du faktisk skriver til daglig?

Gem den description. Du får brug for den i næste kapitel, hvor vi bygger din første skill fra bunden.

Nøglepunkter

1. Description-feltet er til modellen, ikke til dig. Det er en trigger-instruktion, ikke en summary.
2. Ordvalg giver 20x forskel i aktiveringsrate: fra 20% til 90%.
3. Formlen er: Hvad + Hvornår + Trigger-keywords. Brug aktive verber og specifikke ord.
4. Hold dig under 300 tegn per description for at få plads til mange skills inden for 15.000-tegns-grænsen.
5. Test mod realistisk brug. Skriv 10 variationer af hvordan du ville bede om opgaven, og sørg for dine trigger-keywords dækker dem.

Nu har du formlen. I næste kapitel bygger vi din første skill fra bunden, trin for trin, med et komplet eksempel du kan kopiere og tilpasse.

Serien og begreberne

Dette kapitel er en del af guiden til Claude Code Skills. Se alle kapitler der, hvis du vil følge forløbet fra start.