Det er fristende at kaste sig direkte ud i at skrive SKILL.md – men de bedste Skills starter med en grundig planlægningsfase. I denne del gennemgår vi, hvordan du identificerer de rigtige brugscases, definerer succeskriterier og skriver beskrivelser, der sikrer præcis triggering.
3 brugscasekategorier
De fleste nyttige Skills falder inden for én af tre overordnede kategorier:
1. Dokument- og asset-skabelse
Skills der producerer et konkret output: et blogindlæg, en præsentation, en rapport, et Word-dokument, et billede eller en kodebase. Kendetegn:
- Klar definition af outputformatet
- Typisk lineær arbejdsgang
- Let at evaluere: outputtet enten lever op til standarden eller gør det ikke
Eksempler: draft-blog-post, generate-slide-deck, create-docx-report
2. Workflow-automatisering
Skills der koordinerer en flertrinsproces, ofte med beslutningslogik undervejs. Kendetegn:
- Sekventielle eller betingede trin
- Kan involvere læsning fra og skrivning til filer, databaser eller APIs
- Gevinsten er primært tidsbesparelse og konsistens
Eksempler: code-review-pipeline, weekly-standup-summary, onboard-new-project
3. MCP-forbedring
Skills der tilføjer intelligent orkestrering ovenpå ét eller flere MCP-tools. Kendetegn:
- Afhænger af mindst ét eksternt system
- Skill’et tilføjer forretningslogik, formatering eller beslutningstagen oven på rå API-kald
- Kræver omhyggelig fejlhåndtering
Eksempler: slack-sprint-update, jira-ticket-from-bug, drive-folder-summary
Succeskriterier for dit Skill
Inden du skriver en eneste linje YAML, bør du kunne besvare disse tre spørgsmål:
- Er Skill’et tilstrækkeligt specifikt? Kan du beskrive det med ét klart verbum og ét klart objekt? (“Generér en SEO-rapport” er specifikt. “Hjælp med marketing” er det ikke.)
- Er det testbart? Kan du definere, hvad et godt output ser ud som, og hvad et dårligt output ser ud som? Kan du skrive en konkret test?
- Leverer det reel brugerværdi? Sparer det mere end 5 minutter? Reducerer det fejl? Sikrer det konsistens på tværs af teamet?
Hvis svaret på ét af spørgsmålene er “nej” eller “måske”, så refined definitionen, inden du fortsætter.
Tekniske krav: hvilke tools er nødvendige?
Kortlæg de tools, dit Skill har brug for, inden du skriver instruktionerne. Gennemgå disse spørgsmål:
- Skal Skill’et læse eller skrive filer? →
Read,Edit,Write - Skal det køre shell-kommandoer? →
Bash - Skal det hente data fra internettet? →
WebFetch,WebSearch - Skal det integrere med et eksternt system? → Identificér de specifikke MCP-tools
- Skal det kalde andre Skills? → Ingen ekstra tools, men dokumentér afhængighederne
Vær restriktiv: inkluder kun de tools, der rent faktisk er nødvendige. Et Skill med færre tilladelser er mere sikkert og nemmere at distribuere i teams.
Skriv effektive skill-beskrivelser
Description-feltet er det vigtigste for korrekt triggering. Her er en formel, der virker:
[Aktionsverb] [objekt] [kontekst/betingelse].
Brug når [triggersituationer].
Brug ikke til [undtagelser, hvis nødvendigt].
Eksempel:
description: |
Genererer en komplet SEO-analyse af en webside eller et emne,
inklusive søgeordsforslag, konkurrentsammenligning og handlingsplan.
Brug når brugeren beder om en SEO-analyse, søgeordsresearch,
eller vil forbedre et indlægs søgesynlighed.
Brug ikke til generel content-sparring uden SEO-fokus.
Undgå under-triggering og over-triggering
Under-triggering (for vagt)
Symptom: Claude vælger Skill’et sjældent, selv når det er oplagt relevant.
Årsager og løsninger:
- Description er for abstrakt → brug konkrete eksempler på triggersætninger
- Navn matcher ikke brugerens naturlige sprogbrug → overvej synonymer
- For mange konkurrerende Skills med lignende scope → differentier dem tydeligere
Over-triggering (for bredt)
Symptom: Claude forsøger at bruge Skill’et i situationer, hvor det ikke er relevant.
Årsager og løsninger:
- Description bruger meget brede termer (“hjælp”, “skriv”, “analyser”) → vær mere specifik
- Skill’et overlapper med et andet Skill → definer de præcise grænser for begge
- Manglende “brug ikke”-klausuler → tilføj eksplicitte undtagelser
Planlægningsskabelon
Brug denne skabelon, inden du skriver din SKILL.md:
Skill-navn:
Kategori: [Dokument/Asset | Workflow | MCP-forbedring]
Formål (ét sætning):
Trigger-sætninger (3 eksempler):
Output-format:
Nødvendige tools:
Afhænger af andre Skills: [ja/nej – hvilke?]
Succeskriterium:
Når du kan udfylde alle felter uden tøven, er du klar til at skrive selve SKILL.md.
Næste del i serien: Del 4: Test og iteration