Anpassade kommandon kontra Skills

En färdighet finns i .claude/skills/ och är den aktuella, mer omfattande ersättaren för kommandon. Utöver promptens innehåll stöder en färdighet frontmatter som styr hur den körs. Tre fält är viktiga inför provet:

• context: fork — kör färdigheten i en isolerad kontext så att dess utförliga utdata inte stör huvuddialogen.
• allowed-tools — begränsar vilka verktyg färdigheten får anropa (minsta möjliga behörighet).
• argument-hint — dokumenterar vilka argument färdigheten förväntar sig.

Det är exakt dessa kontroller som ett äldre kommando saknar.

Här är en färdighet som genomför en kodgranskning. Frontmatter avgränsas med ---; innehållet nedanför är instruktionen som Claude följer när färdigheten anropas.

Lägg märke till att context: fork isolerar granskningens upptäcktsutdata, att allowed-tools begränsar den till verktyg för läsning och sökning (inget Write och inget Bash), samt att argument-hint talar om för användaren vad som ska anges.

Färdigheter producerar ofta mycket mellanliggande brus: filutskrifter, sökträffar och utforskningssteg. Om allt detta hamnar i huvuddialogen tränger det undan kontextfönstret och utlöser effekten ”lost-in-the-middle”, där modellen ägnar mindre uppmärksamhet åt innehåll som ligger begravt mellan början och slutet.

context: fork kör färdigheten i en isolerad kontext, ungefär som en underagent för utforskning under upptäcktsfasen. Det utförliga arbetet sker någon annanstans och bara det sammanfattade resultatet återvänder. På så sätt hålls huvuds sessionen kompakt och din uppmärksamhet riktas mot det viktiga.

Fältet allowed-tools begränsar en färdighet till endast de verktyg den faktiskt behöver. En granskningsfärdighet bör läsa och söka, men aldrig skriva eller köra skalkommandon; genom att begränsa den på det sättet elimineras en hel klass av oavsiktliga ändringar.

Detta följer samma princip om minsta möjliga behörighet som används för agentdesign på andra ställen i certifieringen: anpassa verktygen efter rollen och kom ihåg att 4–5 verktyg är den optimala nivån, medan 18 eller fler försämrar tillförlitligheten i valet. En fokuserad färdighet med tydligt avgränsad omfattning är både säkrare och tillförlitligare.

Oberoende av kommandon kontra färdigheter har varje kommando eller färdighet en omfattning som bestäms av var filen finns:

• Projektomfattning: .claude/commands/ eller .claude/skills/ inne i repot. Checkas in i VCS, så hela teamet får det automatiskt.
• Användaromfattning: samma mappar under ~/.claude/. Personliga för din dator och delas INTE via VCS.

Detta är exakt samma åtskillnad mellan projekt och användare som i CLAUDE.md-hierarkin och mellan .mcp.json och ~/.claude.json. Regeln är konsekvent i hela Claude Code-konfigurationen.

Använd projektomfattning när ett arbetsflöde ska vara standard för alla som arbetar med repot. En gemensam /review-pr-färdighet innebär att alla utvecklare granskar diffar på samma sätt; en gemensam /migrate-färdighet kodifierar era migreringsregler på ett enda ställe.

Eftersom den checkas in i VCS får en ny teammedlem som klonar repot tillgång till den direkt, utan någon konfiguration. Om du någon gång tänker ”teamet borde göra detta på samma sätt”, är projektomfattning svaret.

Använd användaromfattning (~/.claude/) för personliga bekvämligheter som inte ingår i teamets överenskommelse: egna hjälpfunktioner för tillfälligt arbete, ett personligt kommando för anteckningar eller genvägar som är knutna till din lokala konfiguration.

Nackdelen är densamma som för CLAUDE.md på användarnivå: den följer med dig mellan alla projekt men delas INTE via VCS, så teammedlemmarna ser den aldrig. Om ett arbetsflöde måste kunna återskapas för hela teamet är användaromfattning fel val, just eftersom den är osynlig för alla andra.

Mekanism och omfattning är oberoende av varandra, så du får en fullständig matris att utforma efter:

• Projektfärdighet — delad, aktuell och med kontroller för fork och allowed-tools. Standardvalet för teamets arbetsflöden.
• Användarfärdighet — personlig och aktuell, med fortsatt stöd för den omfattande frontmattern.
• Projektkommando — delat men äldre; fungerar bra om det redan finns, men migrera när du behöver isolering eller begränsning av verktyg.
• Användarkommando — personligt och äldre.

För allt nytt som riktar sig till teamet är standardvalet en projektomfattande färdighet.

Migreringen är vanligtvis mekanisk: flytta filen från .claude/commands/ till .claude/skills/ och lägg sedan till frontmatter för att få de kontroller som saknades. En ren prompt blir då ett styrt arbetsflöde.

Vinsten är konkret: context: fork hindrar utförlig granskningsutdata från att störa sessionen, och allowed-tools garanterar att färdigheten inte kan skriva eller köra skalkommandon. Samma syfte, men nu isolerat och avgränsat.

Viktiga slutsatser:

• Två mekanismer: .claude/commands/ är äldre, medan .claude/skills/ är aktuell. Föredra färdigheter för nytt arbete.
• Färdigheter lägger till sådant som kommandon saknar i frontmatter: context: fork (isolerar utförlig utdata), allowed-tools (begränsar verktyg enligt principen om minsta möjliga behörighet) och argument-hint (dokumenterar argument).
• Två omfattningar: projekt (.claude/, delas via VCS) kontra användare (~/.claude/, personlig och delas INTE) — samma axel som för CLAUDE.md och MCP-konfiguration.
• Arbetsflöde för teamet som måste kunna återskapas → projektomfattande färdighet. Personlig bekvämlighet → användaromfattning.
• Migrera ett kommando till en färdighet genom att flytta filen och lägga till frontmatter; ersätt aldrig en deterministisk begränsning med allowed-tools genom en textanteckning i CLAUDE.md.