En SKILL.md-fil er hjertet i hver Claude Skill — en Markdown-fil som starter med en kort YAML-header (et navn og en beskrivelse) og etterfølges av instruksjonene Claude skal følge. Beskrivelsen forteller Claude når ferdigheten skal brukes; selve innholdet forteller hvordan.
Hvis du har sett begrepet og lurt på hva som egentlig er inni en slik fil, her er anatomien til en SKILL.md, hvorfor hver del er viktig, og hvordan du skriver en som fungerer.
Hva SKILL.md er
En Claude Skill er en mappe, og SKILL.md er den nødvendige filen i roten av denne. Det er vanlig Markdown, så den åpnes i hvilken som helst teksteditor. Claude leser den for å lære en evne — trinnene, reglene og beste praksis for en type oppgave. Valgfrie tillegg (maler, skript, referansefiler) kan ligge ved siden av i samme mappe, men SKILL.md er den ene filen hver ferdighet må ha.
De to delene av en SKILL.md
1. Frontmatter (metadata)
Øverst ligger en liten YAML-blokk mellom ----markører. Den inneholder essensiell metadata — minst et navn og en beskrivelse:
---
name: weekly-report
description: Formaterer rånotater til vår standard ukentlige rapport. Bruk når brukeren ber om en ukentlig oppdatering, statusrapport eller å "skrive opp uken."
---Denne blokken er spesiell: når en økt starter, laster Claude kun inn navn og beskrivelse for hver installert ferdighet — ikke hele filen. Det holder kontekstvinduet lett og er grunnen til at beskrivelsen gjør så mye av jobben.
2. Innholdet (instruksjoner)
Under frontmatter, i vanlig Markdown, skriver du hva Claude faktisk skal gjøre — helst som klare, nummererte trinn med eventuelle regler eller eksempler:
## Steps
1. Gruppér notatene under Wins, In Progress og Blockers.
2. Hold hver kulepunkt til én setning, i fortid.
3. Avslutt med en én-linjers "Neste uke"-oppsummering.
4. Finn aldri på målinger som ikke finnes i notatene.Hvorfor beskrivelsen er den viktigste linjen
Utløsning avhenger helt av beskrivelsen. Når du jobber, sammenligner Claude forespørselen din med hver ferdighets beskrivelse og laster inn hele filen bare når det matcher. En vag beskrivelse ("hjelper med rapporter") utløses sjelden. En spesifikk ("bruk når brukeren ber om en ukentlig oppdatering eller statusrapport") utløses pålitelig. Hvis du husker én regel, la det være denne: skriv beskrivelsen for når ferdigheten skal brukes, ikke bare hva den er.
Hvordan Claude bruker filen
- Ved oppstart: Claude leser navnet + beskrivelsen til hver ferdighet.
-
Under oppgaven: hvis forespørselen din matcher en beskrivelse, laster Claude den fullstendige
SKILL.md(og eventuelle tilknyttede ressurser) for den ferdigheten. - Deretter: Claude følger instruksjonene i innholdet for å fullføre arbeidet.
Denne "last kun når nødvendig"-tilnærmingen kalles progressiv avsløring, og det er det som lar deg ha mange ferdigheter installert uten å gjøre modellens kontekst tung.
Å skrive en god SKILL.md
- Få beskrivelsen riktig. Si tydelig når ferdigheten skal utløses.
- Hold første versjon kort. Fem til ti linjer med klare trinn er bedre enn et omfattende dokument.
- Vær konkret. Nummererte trinn, eksplisitte regler, et kort eksempel.
- Test på ekte oppgaver. Utvid bare der Claude feiler.
Må du skrive en selv?
Nei. Å skrive din egen er flott for arbeidsflyter som er unike for deg, men hvis du bare vil ha resultatet, kommer ferdige ferdigheter med sin SKILL.md allerede laget og testet. Bla gjennom KissMySkills-biblioteket med over 300 ferdigheter, prompt-pakker og agenter, eller Claude Code-ferdighetskolleksjonen. Vil du se en i aksjon først? Prøv en gratis generator eller last ned en gratis ferdighet.
Ofte stilte spørsmål
Er SKILL.md bare Markdown?
Ja — det er en standard Markdown-fil med en YAML frontmatter-blokk øverst. Den åpnes i hvilken som helst teksteditor, ingen spesiell programvare kreves.
Hva kreves i en SKILL.md?
Minst en frontmatter-blokk med navn og beskrivelse. Innholdet med instruksjoner gjør ferdigheten nyttig, men metadataen gjør den søkbar og utløsbart.
Hvor skal SKILL.md-filen ligge?
I roten av ferdighetsmappen. I Claude Code ligger ferdigheter i ~/.claude/skills/<name>/ for personlig bruk eller .claude/skills/<name>/ inne i et prosjekt, med SKILL.md i mappens rot.
Kan jeg bruke innholdet i en SKILL.md i ChatGPT eller Gemini?
Ja. Instruksjonene er bærbare — lim inn innholdet i ChatGPT eller Gemini sine egendefinerte instruksjoner for samme oppførsel. Automatisk utløsing via frontmatter er en Claude-funksjon.
Start med et fungerende eksempel
Den raskeste måten å forstå SKILL.md på er å lese en god en. Last ned en gratis ferdighet, åpne filen, og se frontmatter-pluss-trinn-strukturen i praksis — les deretter hvordan du installerer den på tre minutter.