Claude-skill trigger ikke? Fiks det med 6 sjekker

Du installerte en skill, du ba Claude gjøre det skillen er til, og Claude fortsatte som om skillen ikke finnes. Ingen feilmelding, ingen advarsel, ingenting å greppe. Bare stillhet.

Vi ser dette konstant. SkillProof installerer og tester hver skill i katalogen vår på en ren maskin, og manglende trigging er den desidert vanligste defekten vi finner. Den er også den mest fiksbare: nesten hver «skill virker ikke»-rapport i testloggene våre sporer tilbake til én av seks årsaker, og fem av dem tar under ett minutt å utelukke.

Kjør sjekklisten først. Resten av artikkelen utdyper hver sjekk med symptom, årsak og fiks.

30-sekunderssjekklisten

1. Riktig mappe? Filen må ligge på ~/.claude/skills/<skill-name>/SKILL.md, én mappe per skill, filnavnet nøyaktig SKILL.md.
2. Restartet? Claude skanner skills ved øktstart. Endringer gjort midt i økten er usynlige til du restarter.
3. Navnekollisjon? To skills med samme name skygger for hverandre. Bare én overlever.
4. For vag beskrivelse? Nevner ikke beskrivelsen det brukere bokstavelig talt ber om, matcher Claude den aldri. Dette er årsak nummer én.
5. Gyldig frontmatter? Ett ødelagt YAML-tegn gjør hele skillen usynlig, i stillhet.
6. Konkurrerende skill? En annen installert skill med overlappende beskrivelse kan vinne matchen.

Passerer alle seks og skillen aktiveres, men outputen ikke endres, er det en annen feil. Hopp til når den trigger men ingenting skjer.

Sjekk 1: skillen ligger i feil mappe

Symptom. Skillen dukker aldri opp når du spør Claude «hvilke skills har du installert?». Som om du aldri kopierte den.

Årsak. Claude ser bare på bestemte steder: ~/.claude/skills/ for personlige skills og .claude/skills/ inne i et prosjekt for prosjektskills. Innenfor dem er layouten streng: én mappe per skill, med en fil som heter nøyaktig SKILL.md. Feilene vi ser oftest når vi installerer community-skills for testing: å kopiere hele det klonede repoet (så stien blir skills/some-repo/skills/pdf-helper/SKILL.md, ett nivå for dypt), å slippe SKILL.md rett i ~/.claude/skills/ uten egen mappe, og skill.md med små bokstaver, som noen filsystemer tilgir og andre ikke.

Fiks. Verifiser fra terminalen:

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

Hver skill du forventer, skal skrive ut nøyaktig én linje. Mangler en skill, eller har stien ekstra nesting, flytt mappen så SKILL.md ligger ett nivå under skills/. Installasjonsguiden vår går gjennom riktig layout for hver plattform.

Sjekk 2: du restartet ikke

Symptom. Mappestrukturen er riktig, du fikset den for to minutter siden, og Claude ser fortsatt ikke skillen i samme samtale.

Årsak. Skill-oppdagelse skjer én gang, ved oppstart. Claude leser frontmatteren til hver SKILL.md den finner, og holder på den indeksen ut økten. En skill du legger til, døper om eller redigerer midt i økten, finnes ikke sett fra den kjørende øktens side.

Fiks. I Claude Code, avslutt og start en ny økt. I desktop-appen, avslutt helt med Cmd+Q på macOS (å lukke vinduet teller ikke) og åpne på nytt. Denne er så billig å utelukke at vi gjør det før all dypere feilsøking, slik du ville skrudd ruteren av og på før du ringer internettleverandøren.

Sjekk 3: en navnekollisjon skygger for skillen din

Symptom. Du installerte skillen, mappen er riktig, du restartet, og skill-listen viser enten ingenting nytt eller en annen skill som svarer på samme navn.

Årsak. Skill-navn må være unike. Deler en personlig skill og en prosjektskill samme name, eller shipper to installerte pakker begge en skill som heter seo-audit, skygger den ene for den andre uten advarsel. Vi traff dette i vårt eget katalogarbeid: to marketingpakker installert side om side ga en stille duplikat, og den vi ville ha, lastet aldri.

Fiks. Søk etter duplikater:

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

All output betyr kollisjon. Døp om mappen og name-feltet på kopien du kontrollerer, restart, og sjekk listen igjen.

Sjekk 4: beskrivelsen sier aldri når den skal fyre

Symptom. Skillen står i listen over installerte. Be om den ved navn, og den virker fint. Be om oppgaven med egne ord, og ingenting skjer.

Årsak. Dette er den store, og den fortjener sin egen seksjon, så her er kortversjonen: Claude avgjør om en skill skal lastes ved å lese kun description-feltet og sammenligne det med forespørselen din. Sier beskrivelsen hva skillen er i stedet for når den skal brukes, skjer matchen aldri. Skillen er ikke ødelagt. Den er uannonsert.

Fiks. Skriv om beskrivelsen rundt frasene brukere faktisk skriver. Dypdykket nedenfor viser tre reelle feilmønstre og omskrivingene deres.

Sjekk 5: frontmatteren er ugyldig

Symptom. Mappe riktig, restart gjort, ingen navnekollisjon, og skillen dukker fortsatt ikke opp i listen i det hele tatt. Dette ligner sjekk 1, men stien er fin.

Årsak. YAML-blokken øverst i SKILL.md feilet i parsingen, og en skill med uparserbar frontmatter blir rett og slett hoppet over. De vanlige synderne fra testnotatene våre: en manglende avsluttende ---, et usitert kolon inne i beskrivelsen («Use for: reports» knekker parseren), krøllete anførselstegn limt inn fra et blogginnlegg eller et Google-dokument, tab-tegn brukt til innrykk, og et name som bryter formatreglene (kun små bokstaver, sifre og bindestreker, maks 64 tegn; beskrivelser har tak på 1024).

Fiks. Åpne filen og gransk blokken, eller dropp granskingen: lim den inn i skill-validatoren vår, så flagger den parsefeil, formatbrudd og smart-quote-forurensning umiddelbart. Parser frontmatteren og skillen fortsatt gjemmer seg, gå tilbake til sjekk 1, for da er det nesten alltid stien.

Sjekk 6: en annen skill vinner matchen

Symptom. Du ber om oppgaven, og en skill aktiveres, bare ikke din. Eller atferden endres på en måte som matcher en annen skills instruksjoner.

Årsak. Når flere beskrivelser plausibelt dekker en forespørsel, velger Claude den som fremstår som best match, og en bredere, mer selvsikker beskrivelse pleier å slå en smalere. Installer en generell «writing assistant»-skill ved siden av din «release notes formatter», og generalisten kan sluke hver eneste skriveforespørsel, inkludert release notes.

Fiks. Spiss begge beskrivelsene så territoriene deres ikke overlapper, og legg til eksplisitte ekskluderinger. En linje som «Do NOT use for release notes or changelogs» i generalistens beskrivelse er grov og virker. Kontrollerer du ikke den brysomme skillen, deaktiver den mens du tester din egen, og avgjør så om du faktisk trenger begge.

Hvorfor beskrivelser feiler: dypdykket

Vi tester hver skill vi lister, og triggerproblemer er årsak nummer én til at skills scorer lavt i anmeldelsene våre. Ikke ødelagte skript, ikke dårlige instruksjoner. Beskrivelser som aldri blir matchet.

Mekanikken forklarer hvorfor. Ved oppstart laster Claude kun hver skills name og description, omtrent hundre tokens. Kroppen, uansett hvor briljant, blir liggende på disk til beskrivelsen vinner en match mot forespørselen din. Beskrivelsen er en salgspitch levert til en modell, og de fleste forfattere skriver den som en museumsetikett i stedet.

Her er de tre mønstrene vi trekker mest for, med omskrivinger som fikset dem i retestene våre.

Mønster 1: den beskjedne etiketten.

description: Helps with documents.

Ingenting her kobler til noe en bruker ville skrevet. Sammenlign med Anthropics DOCX-skill, som besto triggertestene våre på første kjøring. Beskrivelsen dens navngir filformatet, handlingene og formuleringene som skal aktivere den. Omskrivingen som følger samme logikk:

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: internnavnet.

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

Dette beskriver implementasjonen. Ingen bruker ber Claude «run the acme-formatter pipeline»; de ber om å «rydde opp i denne rapporten før jeg sender den til en klient». Omskrivingen oversetter skillen til brukerens vokabular:

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 teppet.

description: Use for any writing task.

Motsatt feil. Denne matcher alt, som betyr at den kolliderer med hver eneste skrivetilstøtende skill og fyrer når den ikke skal, og brukere deaktiverer den innen en uke. Omskrivingen smalner påstanden og gjerder inn kantene:

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 bruker ved anmeldelse: les kun beskrivelsen og spør: «hvis en bruker skrev forespørselen sin naturlig, ville disse ordene matchet den?» Skriv i tredjeperson, si hva skillen gjør og når den gjelder, og inkluder de faktiske substantivene folk bruker. Skriver du en skill fra bunnen, dekker forfatterguiden vår dette grundigere, og Anthropics Skill Creator skaffolderer beskrivelser som består denne testen som standard.

Slik tester du trigging ordentlig

De fleste tester en skill ved å navngi den: «bruk faktura-skillen på dette.» Det beviser ingenting, for å navngi en skill omgår beskrivelsesmatchen fullstendig. Det er som å teste en røykvarsler ved å trykke på testknappen og konkludere med at huset ditt er brannsikkert.

Test slik en bruker ville spurt, i en fersk økt hver gang. For en fakturauttrekk-skill, tre formuleringer som bør fyre:

• «Hent totalene ut av disse faktura-PDF-ene.»
• «Jeg har 30 fakturaer fra leverandører, få beløpene og datoene inn i en tabell.»
• «Trekk ut linjepostene fra denne regningen.»

Og to som ikke bør:

• «Oppsummer denne PDF-en for meg.» (Generisk PDF-arbeid; en annen skills territorium.)
• «Skriv en faktura-e-post til denne kunden.» (Skriving, ikke uttrekk.)

Gjør en bør-fyre-formulering ingenting, spør Claude direkte: «Hvilken av de installerte skillene dine ville du brukt på denne forespørselen, og hvorfor?» Svaret viser deg matchresonnementet, og det peker vanligvis rett på det svake punktet i beskrivelsen. Aktiverer bør-ikke-fyre-formuleringene skillen likevel, har du et grådig teppe og trenger ekskluderinger. Dette er nøyaktig protokollen vi kjører i katalogtestingen, og det er samme disiplin som Systematic Debugging-skillen lærer bort: reproduser først, én variabel om gangen, tro på bevisene.

Når den trigger men ingenting skjer

Anta at skillen faktisk aktiveres. Du kan bekrefte det ved å spørre Claude midt i samtalen om en skill lastet for forespørselen, og den forteller deg det. Men outputen ser lik ut som før du installerte noe.

Det er ikke et triggerproblem, og ingenting over vil fikse det. Det er et kroppsproblem: instruksjonene inne i skillen er for vage til å endre atferd, eller skillen refererer til medfølgende filer som ikke finnes på stiene den forventer, eller den kaller et skript hvis avhengigheter aldri ble deklarert. Beskrivelsen fikk skillen inn døra, og innholdet falt over ende innenfor.

I testingen vår er dette den andre store bøtten med feil, omtrent speilbildet av triggerdefekter, og det er hovedgrunnen til at omtrent halvparten av community-skills stryker på testene våre. Den raske skillelinjen: endret atferden seg ikke i det hele tatt, mistenk triggingen; endret atferden seg, men dårlig eller delvis, mistenk kroppen. Feilsøk deretter, for fiksene overlapper ikke.

Plattformfeller

Skill-formatet er identisk overalt, men oppdagelsen er det ikke, og en skill som virker ett sted, kan se død ut et annet.

Claude Code leser mapper på disk: ~/.claude/skills/ for personlige, .claude/skills/ per prosjekt. Begge lastes; navnekollisjoner mellom de to nivåene løses til én vinner (sjekk 3). Restart økten etter enhver endring.

Claude Desktop leser ikke skills-mappene dine. Skills lastes opp som zip via Settings, under Capabilities, og zip-en må inneholde skillens mappe på toppnivå, ikke den nakne SKILL.md og ikke en innpakningskatalog. En skill som trigger fint i Claude Code, er rett og slett fraværende på Desktop til du laster den opp der separat.

claude.ai tar samme opplastingsvei som Desktop, med to ekstra måter å tape på: skills trenger kodekjøringsfunksjonen aktivert på abonnementet ditt, og workspace-administratorer kan deaktivere skills for hele organisasjonen, og da vil ingenting du laster opp noensinne fyre, og ingen feilmelding sier det. Spør administratoren din før du bruker en kveld på å skrive om beskrivelser.

Én kryssplattformfelle til: en skill-kropp skrevet for Claude Code som kaller git eller leser lokale prosjektfiler, vil trigge korrekt på claude.ai og deretter feile inne i sandkassen. Det er et kroppsproblem i plattformkostyme.

Når du bør slutte å feilsøke

Er det din egen skill, fortsett, for hver fiks over er permanent, og validatoren pluss femformuleringstesten får deg i mål. Er det en tredjeparts skill og du har brent mer enn tjue minutter på noen andres beskrivelsesfelt, er det helt greit å bytte den mot en som allerede har vært gjennom denne sjekklisten: hver skill på bestelistene våre besto triggertesting på ren maskin før vi listet den.

FAQ

Hvordan bekrefter jeg at en skill i det hele tatt er installert?

Spør Claude «hvilke skills har du installert?» i en fersk økt. Er ikke skillen din i svaret, er problemet oppdagelse (sjekk 1, 3 og 5: mappe, kollisjon, frontmatter), ikke trigging. Er den listet, men aldri aktiveres, er problemet beskrivelsen (sjekk 4 og 6).

Kan jeg bare tvinge skillen til å trigge ved å navngi den?

Ja. «Bruk docx-skillen til å skrive dette notatet» laster skillen direkte, og det er en grei midlertidig løsning mens du feilsøker. Det er ikke en fiks: en skill du må tilkalle ved navn hver gang, er en skill med ødelagt beskrivelse, og du kommer til å glemme å tilkalle den akkurat når det gjelder.

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

Ulike oppdagelsesveier. Claude Code leser mapper på disk; Desktop og claude.ai ser bare skills lastet opp via Settings som zip med skill-mappen på toppnivå. På claude.ai, bekreft også at kodekjøring er aktivert og at workspace-administratoren ikke har deaktivert skills helt.

Ødelegger det triggingen å installere for mange skills?

Ikke direkte. Femti skills koster noen tusen tokens metadata, som er billig. Den reelle risikoen er overlapp: jo flere beskrivelser du installerer, desto mer sannsynlig gjør to av dem krav på samme territorium, og da vinner feil skill av og til (sjekk 6). Installer etter behov, og luk vekk skills som aldri fyrer.

Skillen min trigget i går og ikke i dag. Er det normalt?

Av og til, ja. Matchingen er modelldrevet, ikke en regex, så en beskrivelse på vippen fyrer på én formulering og bommer på en nesten identisk. Er en skill ustabil snarere enn død, behandle det som en svak beskrivelse: legg de nøyaktige frasene som bommet, inn i beskrivelsesfeltet, restart, og test på nytt. Pålitelige skills trigger på hver rimelig formulering, og derfor tester vi med fem, ikke én.