Claude skill trigger ikke? Fiks det med 6 tjek

Du installerede en skill, du bad Claude om at gøre det, skillen er til, og Claude fortsatte, som om skillen ikke findes. Ingen fejl, ingen advarsel, intet at greppe. Bare stilhed.

Vi ser det konstant. SkillProof installerer og tester hver skill i vores katalog på en ren maskine, og manglende triggering er den mest almindelige defekt, vi finder. Den er også den mest fiksbare: næsten hver "skill virker ikke"-rapport i vores testlogs sporer tilbage til én af seks årsager, og fem af dem tager under et minut at udelukke.

Kør tjeklisten først. Resten af artiklen udfolder hvert tjek med symptomet, årsagen og løsningen.

30-sekunders-tjeklisten

1. Rigtig mappe? Filen skal ligge i ~/.claude/skills/<skill-name>/SKILL.md, én mappe pr. skill, filnavn præcis SKILL.md.
2. Genstartet? Claude scanner skills ved sessionsstart. Ændringer midt i en session er usynlige, indtil du genstarter.
3. Navnekollision? To skills med samme name skygger for hinanden. Kun én overlever.
4. Beskrivelse for vag? Nævner beskrivelsen ikke det, brugerne bogstaveligt beder om, matcher Claude den aldrig. Det er årsag nummer ét.
5. Frontmatter gyldig? Ét ødelagt YAML-tegn gør hele skillen usynlig, lydløst.
6. Konflikterende skill? En anden installeret skill med en overlappende beskrivelse kan vinde matchet.

Består alle seks, og skillen aktiveres, men outputtet ikke ændrer sig, er det en anden slags fejl. Spring til når den trigger men intet gør.

Tjek 1: skillen ligger i den forkerte mappe

Symptom. Skillen dukker aldrig op, når du spørger Claude "what skills do you have installed?". Det er, som om du aldrig kopierede den.

Årsag. Claude kigger kun bestemte steder: ~/.claude/skills/ for personlige skills og .claude/skills/ inde i et projekt for projekt-skills. Inden for dem er layoutet strengt: én mappe pr. skill med en fil, der hedder præcis SKILL.md. De fejl, vi oftest ser, når vi installerer community-skills til test: at kopiere hele det clonede repo (så stien bliver skills/some-repo/skills/pdf-helper/SKILL.md, ét niveau for dybt), at smide SKILL.md direkte i ~/.claude/skills/ uden egen mappe, og skill.md med små bogstaver, som nogle filsystemer tilgiver og andre ikke.

Løsning. Verificér fra terminalen:

ls ~/.claude/skills/*/SKILL.md

Hver skill, du forventer, skal printe præcis én linje. Mangler en skill, eller har dens sti ekstra indlejring, så flyt mappen, så SKILL.md ligger ét niveau under skills/. Vores installationsguide gennemgår det korrekte layout for hver platform.

Tjek 2: du genstartede ikke

Symptom. Mappestrukturen er korrekt, du fiksede den for to minutter siden, og Claude kan stadig ikke se skillen i samme samtale.

Årsag. Skill-opdagelse sker én gang, ved opstart. Claude læser frontmatteren i hver SKILL.md, den kan finde, og holder det indeks for hele sessionen. En skill, du tilføjer, omdøber eller redigerer midt i en session, findes ikke, så vidt den kørende session er orienteret.

Løsning. I Claude Code: afslut og start en ny session. I desktop-appen: luk helt med Cmd+Q på macOS (at lukke vinduet tæller ikke) og åbn igen. Det her er så billigt at udelukke, at vi gør det før al dybere debugging, ligesom man slukker og tænder routeren, før man ringer til sin internetudbyder.

Tjek 3: en navnekollision skygger for din skill

Symptom. Du installerede skillen, mappen er rigtig, du genstartede, og skill-listen viser enten intet nyt eller en anden skill, der svarer på samme navn.

Årsag. Skill-navne skal være unikke. Deler en personlig skill og en projekt-skill et name, eller shipper to installerede pakker begge en skill kaldet seo-audit, skygger den ene for den anden uden advarsel. Vi ramte det i vores eget katalogarbejde: to marketing-pakker installeret side om side producerede en lydløs dublet, og den, vi ville have, blev aldrig indlæst.

Løsning. Søg efter dubletter:

grep -h "^name:" ~/.claude/skills/*/SKILL.md .claude/skills/*/SKILL.md 2>/dev/null | sort | uniq -d

Ethvert output betyder en kollision. Omdøb mappen og name-feltet på den kopi, du selv kontrollerer, genstart, og tjek listen igen.

Tjek 4: beskrivelsen siger aldrig, hvornår den skal fyre

Symptom. Skillen står på listen over installerede. Bed om den ved navn, og den virker fint. Bed om opgaven med dine egne ord, og der sker ingenting.

Årsag. Det her er den store, og den fortjener sit eget afsnit, så her er den korte version: Claude beslutter, om en skill skal indlæses, ved kun at læse dens description-felt og sammenligne det med din forespørgsel. Siger beskrivelsen, hvad skillen er, i stedet for hvornår den skal bruges, sker matchet aldrig. Skillen er ikke i stykker. Den er bare ureklameret.

Løsning. Omskriv beskrivelsen omkring de fraser, brugerne faktisk taster. Dybdegennemgangen nedenfor viser tre virkelige fejlmønstre og deres omskrivninger.

Tjek 5: frontmatteren er ugyldig

Symptom. Mappe korrekt, genstart udført, ingen navnekollision, og skillen dukker stadig slet ikke op på listen. Det ligner tjek 1, men stien er fin.

Årsag. YAML-blokken øverst i SKILL.md kunne ikke parses, og en skill med uparsérbar frontmatter springes simpelthen over. De sædvanlige syndere fra vores testnoter: et manglende afsluttende ---, et kolon uden anførselstegn inde i beskrivelsen ("Use for: reports" knækker parseren), krøllede anførselstegn indsat fra et blogindlæg eller et Google Doc, tabulatortegn brugt til indrykning, og et name, der bryder formatreglerne (kun små bogstaver, cifre og bindestreger, maks. 64 tegn; beskrivelser maks. 1024).

Løsning. Åbn filen og nærlæs blokken, eller spring nærlæsningen over: indsæt den i vores skill-validator, og den flager parse-fejl, formatbrud og smart quote-forurening med det samme. Parser frontmatteren, og skillen stadig gemmer sig, så gå tilbage til tjek 1, for på det tidspunkt er det næsten altid stien.

Tjek 6: en anden skill vinder matchet

Symptom. Du beder om opgaven, og en skill aktiveres faktisk, bare ikke din. Eller adfærden ændrer sig på en måde, der matcher en anden skills instruktioner.

Årsag. Når flere beskrivelser plausibelt dækker en forespørgsel, vælger Claude den, der læser som bedste match, og en bredere, mere selvsikker beskrivelse har tendens til at slå en smallere. Installer en generel "writing assistant"-skill ved siden af din "release notes formatter", og generalisten kan sluge hver eneste skriveforespørgsel, inklusive release notes.

Løsning. Skærp begge beskrivelser, så deres territorier ikke overlapper, og tilføj eksplicitte undtagelser. En linje som "Do NOT use for release notes or changelogs" i generalistens beskrivelse er grov og virker. Kontrollerer du ikke den skyldige skill, så deaktivér den, mens du tester din egen, og beslut så, om du faktisk har brug for begge.

Hvorfor beskrivelser fejler: dybdegennemgangen

Vi tester hver skill, vi lister, og trigger-problemer er den hyppigste grund til, at skills scorer lavt i vores anmeldelser. Ikke ødelagte scripts, ikke dårlige instruktioner. Beskrivelser, der aldrig bliver matchet.

Mekanikken forklarer hvorfor. Ved opstart indlæser Claude kun hver skills name og description, cirka hundrede tokens. Kroppen, uanset hvor brillant, bliver på disken, indtil beskrivelsen vinder et match mod din forespørgsel. Beskrivelsen er en salgstale leveret til en model, og de fleste forfattere skriver den som et museumsskilt i stedet.

Her er de tre mønstre, vi oftest trækker ned for, med omskrivninger, der fiksede dem i vores gentests.

Mønster 1: den beskedne etiket.

description: Helps with documents.

Intet her forbinder til noget, en bruger ville taste. Sammenlign med Anthropics DOCX-skill, som bestod vores trigger-tests i første kørsel. Dens beskrivelse nævner filformatet, handlingerne og de formuleringer, der bør aktivere den. Omskrivningen, der følger samme logik:

description: Create, edit, and format Word documents (.docx).
  Use when the user mentions a Word doc, .docx file, memo,
  letter, or asks for a deliverable "as a document."

Mønster 2: det interne navn.

description: Runs the acme-formatter pipeline with corporate config.

Det her beskriver implementeringen. Ingen bruger beder Claude om at "run the acme-formatter pipeline"; de beder om at "rydde op i den her rapport, før jeg sender den til en kunde". Omskrivningen oversætter skillen til brugerens ordforråd:

description: Reformat rough drafts into client-ready reports using
  Acme's corporate style. Use when the user wants to clean up,
  polish, or "make presentable" a document for external sharing.

Mønster 3: det grådige tæppe.

description: Use for any writing task.

Den modsatte fejl. Den matcher alt, hvilket betyder, at den kolliderer med enhver anden skrive-tilstødende skill og fyrer, når den ikke burde, og brugerne deaktiverer den inden for en uge. Omskrivningen indsnævrer påstanden og hegner kanterne ind:

description: Write and edit marketing copy: landing pages, ads,
  and email campaigns. Do NOT use for technical docs, code
  comments, or internal memos.

Testen, vi anvender ved review: læs kun beskrivelsen og spørg, "hvis en bruger tastede sin forespørgsel naturligt, ville disse ord så matche den?" Skriv i tredje person, angiv hvad skillen gør, og hvornår den gælder, og medtag de faktiske navneord, folk bruger. Skriver du en skill fra bunden, dækker vores forfatterguide det mere i dybden, og Anthropics Skill Creator stilladserer beskrivelser, der består denne test som standard.

Sådan tester du triggering ordentligt

De fleste tester en skill ved at nævne den: "brug invoice-skillen på det her." Det beviser ingenting, for at nævne en skill omgår beskrivelses-matchet fuldstændigt. Det er som at teste en røgalarm ved at trykke på testknappen og konkludere, at dit hus er brandsikkert.

Test, som en bruger ville spørge, i en frisk session hver gang. For en faktura-udtræks-skill, tre formuleringer der bør fyre:

• "Træk totalerne ud af de her faktura-PDF'er."
• "Jeg har 30 fakturaer fra leverandører, få beløb og datoer ind i en tabel."
• "Udtræk linjeposterne fra den her regning."

Og to der ikke bør:

• "Opsummer den her PDF for mig." (Generisk PDF-arbejde; en anden skills territorium.)
• "Skriv en faktura-mail til den her kunde." (Skrivning, ikke udtræk.)

Gør en bør-fyre-formulering ingenting, så spørg Claude direkte: "Which of your installed skills would you use for this request, and why?" Svaret viser dig match-ræsonnementet, og det peger som regel direkte på det svage punkt i beskrivelsen. Aktiverer bør-ikke-fyre-formuleringerne alligevel skillen, har du et grådigt tæppe og brug for undtagelser. Det er præcis den protokol, vi kører i katalogtest, og det er samme disciplin, som Systematic Debugging-skillen lærer fra sig: reproducér først, én variabel ad gangen, tro på beviserne.

Når den trigger men intet gør

Antag, at skillen faktisk aktiveres. Du kan bekræfte det ved midt i samtalen at spørge Claude, om en skill blev indlæst for forespørgslen, og den fortæller dig det. Men outputtet ser ud, præcis som det gjorde, før du installerede noget.

Det er ikke et trigger-problem, og intet ovenfor fikser det. Det er et krops-problem: instruktionerne inde i skillen er for vage til at ændre adfærd, eller skillen refererer til medfølgende filer, der ikke findes på de stier, den forventer, eller den kalder et script, hvis dependencies aldrig blev deklareret. Beskrivelsen fik skillen ind ad døren, og indholdet væltede indenfor.

I vores test er det den anden store bunke af fejl, nogenlunde spejlbilledet af trigger-defekter, og det er hovedgrunden til, at omkring halvdelen af community-skills dumper vores tests. Den hurtige skelnen: ændrede adfærden sig slet ikke, så mistænk triggering; ændrede den sig, men dårligt eller delvist, så mistænk kroppen. Debug derefter, for løsningerne overlapper ikke.

Platform-faldgruber

Skill-formatet er identisk alle steder, men opdagelsen er ikke, og en skill, der virker ét sted, kan se død ud et andet.

Claude Code læser mapper på disken: ~/.claude/skills/ for personlige, .claude/skills/ pr. projekt. Begge indlæses; navnekollisioner mellem de to scopes afgøres med én vinder (tjek 3). Genstart sessionen efter enhver ændring.

Claude Desktop læser ikke dine skills-mapper. Skills uploades som zip gennem Settings under Capabilities, og zippen skal indeholde skillens mappe på øverste niveau, ikke den bare SKILL.md og ikke en wrapper-mappe. En skill, der trigger fint i Claude Code, vil simpelthen være fraværende på Desktop, indtil du uploader den dér separat.

claude.ai tager samme upload-vej som Desktop, med to ekstra måder at tabe på: skills kræver, at code execution-funktionen er slået til på din plan, og workspace-admins kan deaktivere skills for hele organisationen — i så fald fyrer intet, du uploader, nogensinde, og ingen fejlmelding siger det. Spørg din admin, før du bruger en aften på at omskrive beskrivelser.

En cross-platform-fælde mere: en skill-krop skrevet til Claude Code, som kalder git eller læser lokale projektfiler, vil trigge korrekt på claude.ai og derefter fejle inde i sandkassen. Det er et krops-problem i platformskostume.

Hvornår du skal stoppe med at debugge

Er det din egen skill, så fortsæt, for hvert fix ovenfor er permanent, og validatoren plus fem-formulerings-testen får dig i mål. Er det en tredjeparts-skill, og har du brændt mere end tyve minutter af på en andens description-felt, er det fair at bytte den til en, der allerede har været gennem denne tjekliste: hver skill på vores best-of-lister bestod trigger-test på en ren maskine, før vi listede den.

FAQ

Hvordan bekræfter jeg, at en skill overhovedet er installeret?

Spørg Claude "what skills do you have installed?" i en frisk session. Er din skill ikke i svaret, er problemet opdagelse (tjek 1, 3 og 5: mappe, kollision, frontmatter), ikke triggering. Er den listet men aktiveres aldrig, er problemet beskrivelsen (tjek 4 og 6).

Kan jeg bare tvinge skillen til at trigge ved at nævne den?

Ja. "Brug docx-skillen til at skrive det her notat" indlæser skillen direkte, og det er en fin workaround, mens du debugger. Det er dog ikke et fix: en skill, du skal hidkalde ved navn hver gang, er en skill med en ødelagt beskrivelse, og du glemmer at hidkalde den præcis, når det gælder.

Hvorfor virker min skill i Claude Code men ikke på Desktop eller claude.ai?

Forskellige opdagelsesveje. Claude Code læser mapper på disken; Desktop og claude.ai ser kun skills uploadet gennem Settings som en zip med skill-mappen på øverste niveau. På claude.ai skal du også bekræfte, at code execution er slået til, og at din workspace-admin ikke har deaktiveret skills helt.

Ødelægger det triggering at installere for mange skills?

Ikke direkte. Halvtreds skills koster nogle få tusind tokens metadata, hvilket er billigt. Den reelle risiko er overlap: jo flere beskrivelser du installerer, desto mere sandsynligt er det, at to af dem gør krav på samme territorium, og så vinder den forkerte nogle gange (tjek 6). Installer efter behov, og lug skills ud, der aldrig fyrer.

Min skill triggede i går og ikke i dag. Er det normalt?

Af og til, ja. Matching er modeldrevet, ikke en regex, så en beskrivelse på vippen fyrer på én formulering og misser en næsten identisk. Er en skill flakkende snarere end død, så behandl den som en svag beskrivelse: tilføj de præcise fraser, der missede, til description-feltet, genstart og test igen. Pålidelige skills trigger på enhver rimelig formulering, og det er derfor, vi tester med fem, ikke én.