Claude-färdigheter och plugins: En teknisk djupdykning i innehåll vs. behållare

Termerna ”Claude-färdighet” och ”Claude-plugin” används ofta synonymt, vilket skapar förvirring för utvecklare som försöker utöka Claude Code. Verkligheten är att de inte är samma sak. Att förstå skillnaden är inte bara akademiskt; det är grundläggande för att effektivt bygga, installera och felsöka anpassade beteenden.

På SkillProof arbetar vi med denna mekanik varje dag. Vi läser inte bara dokumentationen; vi installerar och kör färdigheter på verkliga uppgifter, från både råa mappar och plugin-paket. Av de 1877 färdigheter vi har testat hittills, godkändes endast 1159 (62%) i vår utvärdering. Ytterligare 624 krävde konfiguration, en kompletterande färdighet eller en integration innan de levererade, och 94 presterade sämre än baslinjen utan färdighet – antingen kunde de inte köras alls, eller så kördes de och lämnade dig i ett sämre läge än att inte installera något. Denna erfarenhet ger oss ett tydligt, faktabaserat perspektiv på skillnaden mellan en Claude-färdighet och ett plugin, och vilken du bör använda.

Det enklaste sättet att tänka på det är så här: en färdighet är innehållet – uppsättningen instruktioner som lär Claude ett nytt beteende. Ett plugin är en behållare – ett distributionspaket som kan bunta en eller flera färdigheter, tillsammans med andra typer av tillägg.

Denna artikel separerar de två koncepten och använder exakt de filsökvägar och kommandon vi använder i vår dagliga testning. Vi kommer att gå igenom vad en färdighet är, vad ett plugin är, hur de installeras och när man bör bygga den ena kontra den andra.

Vad är en Claude Code-färdighet? Den atomära enheten för beteende

En Claude-färdighet är den mest grundläggande byggstenen. Det är, bokstavligen, en mapp som innehåller en fil med namnet SKILL.md. Det är allt. Mappnamnet blir färdighetens identifierare.

SKILL.md-filen har en enkel, tvådelad struktur:

1. YAML Frontmatter: Ett block överst i filen, inneslutet av ---, som definierar färdighetens metadata. Fältet som spelar roll är description. name är valfritt och standardvärdet är mappnamnet, och det finns ett dussintal andra valfria fält (allowed-tools, when_to_use, model, paths och liknande) som de flesta färdigheter aldrig rör.
2. Markdown-instruktioner: Under frontmatter-blocket skriver du vanlig markdown som förklarar uppgiften för Claude. Detta är din prompt, din uppsättning instruktioner för hur beteendet ska utföras.

Avgörande är att SKILL.md-formatet inte inkluderar komplex syntax för att definiera verktygsfunktioner, API-scheman eller parametertyper. Det finns inget obligatoriskt block för few-shot-exempel. Hela systemet bygger på naturligt språk.

Det viktigaste fältet i frontmatter-blocket är description. Detta är inte bara för mänskliga läsare; det är den primära utlösaren för färdigheten. När du ger Claude en uppgift, skannar den description-fälten för alla installerade färdigheter för att hitta en matchning. Om din uppgiftsbeskrivning överensstämmer med en färdighets description, laddar Claude den färdighetens markdown-instruktioner i sitt kontext för att vägleda sitt svar. Om du utelämnar det faller Claude tillbaka på första stycket i brödtexten, som sällan är skrivet för att fungera som en utlösare.

Detta är en vanlig felpunkt som vi dokumenterar i våra tester. Vi har sett många färdigheter med briljanta instruktioner i markdown-brödtexten som Claude aldrig använder eftersom description i frontmatter-blocket var för vagt, för specifikt eller saknades helt. En färdighet med en beskrivning som "Aids in development" kommer nästan aldrig att utlösas. För en djupare titt på vad som utgör en bra färdighet, se vår guide om vad Claude-färdigheter är.

Hur man installerar en rå färdighet

Om en färdighet bara är en mapp, är installationen så enkel som att kopiera den mappen till rätt plats. Claude Code letar efter färdigheter på två platser:

1. Globalt: ~/.claude/skills/
2. Projektspecifikt: <your-project-directory>/.claude/skills/

Färdigheter i den globala katalogen är tillgängliga i alla projekt du öppnar med Claude Code. Färdigheter i en projektspecifik katalog laddas endast när du arbetar inom det projektet. Detta är användbart för uppgifter som är specifika för en enskild kodbas.

För att installera en färdighet du har laddat ner från ett Git-arkiv är processen en direkt filoperation. Till exempel, efter att ha klonat ett arkiv som innehåller en färdighet, skulle du köra:

# Example: Installing a skill into the global directory
cp -r path/to/cloned-repo/the-skill-folder ~/.claude/skills/

Claude Code övervakar dessa färdighetskataloger, så en färdighet du lägger till, redigerar eller tar bort plockas upp under den pågående sessionen utan omstart. Undantaget är en färdighetskatalog som inte fanns när sessionen startade; skapar du en sådan måste du starta om så att Claude Code börjar övervaka den.

Det finns inget speciellt kommandoradsgränssnitt för att installera en rå färdighet, och ingen --skill-flagga som pekar Claude mot en SKILL.md-fil för en enstaka körning. Att kopiera mappen är installationen.

Detta direkta, filbaserade tillvägagångssätt är hur vi installerar majoriteten av färdigheterna i vår katalog. Det är enkelt, transparent och lätt att felsöka. Du kan hitta mer detaljerade installations-exempel i vår guide för att installera Claude-färdigheter.

Vad är ett Claude-plugin? Ett distributionspaket

Om en färdighet är innehållet, är ett plugin fraktlådan. Ett plugin är en fristående katalog med komponenter, som vanligtvis bär ett .claude-plugin/plugin.json-manifest som innehåller dess identitetsmetadata (namn, beskrivning, version, författare) och kan peka på var dess komponenter finns.

Detta är den centrala skillnaden mellan en Claude-färdighet och ett plugin: ett plugin är utformat för att vara ett paket. Även om det kan innehålla en enskild färdighet, ligger dess verkliga styrka i dess förmåga att paketera flera, relaterade tillägg tillsammans. Ett plugin kan leverera:

• Färdigheter: En eller flera SKILL.md-mappar.
• Agenter: Specialiserade underagenter som huvud-Claude-agenten kan delegera arbete till.
• Slash-kommandon: Anpassade /-kommandon du kan köra direkt i Claude Codes chattgränssnitt.
• Hooks: Skript som körs automatiskt vid vissa punkter i sessionens livscykel.
• MCP-servrar: Anslutningar till en Model Context Protocol-server, så att ett plugin kan koppla upp en extern integration som en del av sin installation istället för att du måste konfigurera den manuellt. För mer om detta, se vår genomgång av färdigheter vs MCP.
• LSP-servrar: Språkserveranslutningar som ger Claude typfel och kodnavigering.

Ett plugin är inte bara ett omslag för en enskild färdighet. Det är en komplett verktygslåda. Till exempel kan ett plugin för ett specifikt testramverk bunta en färdighet för att skriva nya tester, ett slash-kommando för att köra dem, och en hook för att köra tester före varje commit. Färdigheten är bara en pusselbit.

Hur plugins och marknadsplatser fungerar

Eftersom plugins är mer komplexa paket är deras installationsprocess annorlunda. Du kopierar inte plugin-mappar manuellt. Du går via marknadsplatser: en marknadsplats är ett Git-arkiv som innehåller en .claude-plugin/marketplace.json-fil som listar de plugins den erbjuder.

Anthropic driver en officiell marknadsplats, claude-plugins-official, som Claude Code lägger till åt dig automatiskt vid uppstart, plus en community-marknadsplats på anthropics/claude-plugins-community som du lägger till själv och vars plugins har klarat automatiserad validering och säkerhetsgranskning. Men systemet är inte stängt: vem som helst kan publicera en marknadsplats genom att lägga en marketplace.json i ett repo, och inget hindrar dig från att lägga till den. Inkludering i den officiella katalogen sker efter Anthropics gottfinnande; allt utanför den har den kvalitet som underhållaren har valt att ge den.

För att installera ett plugin lägger du till dess marknadsplats och installerar sedan pluginet med dess namn:

1. Lägg till marknadsplatsen:

   /plugin marketplace add anthropics/claude-code
   

2. Installera pluginet:

   /plugin install commit-commands@claude-code-plugins
   

Kör sedan /reload-plugins för att aktivera det i den aktuella sessionen.

Plugin-hantering är dock inte begränsad till det interaktiva gränssnittet. Det finns en claude plugin kommandogrupp i skalet (med alias claude plugins) som täcker install, uninstall, enable, disable, update, list, details, init och validate – det dokumenterade sättet att installera utan det interaktiva steget, och det du använder när du skriptar en team-installation:

claude plugin install commit-commands@claude-code-plugins --scope project

Det finns också --plugin-dir- och --plugin-url-flaggor för att ladda ett plugin endast för en session, vilket är hur du provar något innan du binder dig till det.

Skillnaden mellan en marknadsplats och en kuraterad katalog är viktig här, och det är inte samma axel som färdighet kontra plugin. En marknadsplats är en distributionskanal: den talar om för dig att ett plugin existerar och installerar det. Granskning, där det överhuvudtaget sker, är automatiserad. Inget av detta talar om för dig om saken fungerar för din uppgift.

Claude Code-färdigheter vs plugins: En jämförelse sida vid sida

För att göra skillnaden helt tydlig, här är en direkt jämförelse av de viktigaste attributen:

Egenskap	Rå färdighet	Plugin
Definition	En mapp med en SKILL.md-fil som definierar ett enskilt beteende.	En fristående katalog med komponenter som fungerar som ett paket.
Kärnfil	SKILL.md	.claude-plugin/plugin.json
Omfattning	En enskild uppsättning instruktioner för en uppgift.	Ett paket med färdigheter, agenter, kommandon, hooks, MCP- och LSP-servrar.
Installation	Manuell kopiering: cp -r ... ~/.claude/skills/	/plugin install <name>@<market>, eller claude plugin install
Distribution	Direkt mappdelning, Git-arkiv.	Via en marknadsplats (ett Git-repo med ett manifest).
Användningsfall	Personligt bruk, verktyg för ett enda syfte, snabb prototypframtagning.	Teamdistribution, komplexa verktygslådor, beteenden i flera delar.

Hur SkillProof testar båda

Vår testmetodik är agnostisk till installationsmetoden. Oavsett om en färdighet kommer som en rå mapp eller inuti ett plugin-paket, är vår process densamma. Vi installerar den och utvärderar sedan prestandan hos de underliggande SKILL.md-instruktionerna mot en standardiserad uppsättning uppgifter.

Distributionsmetoden ändrar inte färdighetens beteende. En dåligt skriven SKILL.md-fil kommer att prestera lika dåligt oavsett om du kopierar den manuellt eller installerar den med /plugin install.

Faktum är att ett återkommande fel vi stöter på är ett paket som installeras perfekt men innehåller en färdighet som aldrig aktiveras. Installationen slutförs utan fel, färdigheten visas i listan, och sedan använder Claude den aldrig, eftersom description i dess SKILL.md är för tunn för att matcha något en användare faktiskt skulle skriva. Inget i installationen rapporterar detta. Du upptäcker det först när du ger Claude den uppgift som färdigheten var avsedd för och ser den svara som om färdigheten inte fanns – vilket är exakt det test vi kör.

Detta är en del av anledningen till att 624 av de 1877 färdigheter vi har testat har omdömet "Fungerar med konfiguration" snarare än att godkännas: de levererar, men inte direkt, och paketeringen tenderar att dölja orsaken.

Ska jag bygga en färdighet eller ett plugin?

Detta leder oss till den praktiska frågan: när du har ett nytt beteende för Claude, ska du bygga en färdighet eller ett plugin?

Svaret är enkelt: börja alltid med att bygga en färdighet.

1. Skapa din your-skill-name/SKILL.md-fil. Fokusera på att skriva tydliga, effektiva instruktioner och en precis, utlösarvänlig description. Testa den lokalt genom att kopiera den till ~/.claude/skills/.

2. Iterera på SKILL.md tills den fungerar tillförlitligt. Detta är 99 % av arbetet. Innehållet i denna fil är det som levererar värdet.

Först efter att du har en beprövad, fungerande färdighet bör du överväga att paketera den som ett plugin. Beslutet att skapa ett plugin bör drivas av distributionsbehov, inte av färdighetens komplexitet.

Paketera som ett plugin om:

• Du levererar mer än en komponent. Till exempel, en färdighet för att generera API-dokumentation och ett slash-kommando /generate-docs för att utlösa den för hela projektet.
• Du behöver distribuera en uppsättning färdigheter till ett team med ett enda, enkelt installationskommando.
• Du bygger ett mer avancerat tillägg som förlitar sig på hooks, underagenter eller andra funktioner som endast är tillgängliga för plugins.

Om du har en enskild färdighet för ditt eget personliga bruk är det onödigt merarbete att skapa ett plugin. En rå färdighetsmapp i ~/.claude/skills/ är enklare och mer direkt.

Slutsats: Fokusera på färdigheten, inte omslaget

Den centrala slutsatsen är att prestandan kommer från kvaliteten på SKILL.md-filen, inte dess paketering. Ett plugin är en distributionsmekanism, inte en kvalitetsgaranti. Som vår data visar, misslyckas även snyggt paketerade färdigheter: 94 av de vi har testat presterade sämre än vad Claude gör utan någon färdighet installerad alls.

Skillnaden mellan Claude-färdigheter och plugins är inte en fråga om bra kontra dåligt, utan om omfattning och syfte. Den ena är instruktionen; den andra är lådan den levereras i.

Relaterad läsning: för en djupdykning i paketeringssidan – manifest, marknadsplatsstruktur och vad du bör kontrollera innan du lägger till någons repo – se vår guide till Claude Code-plugins. För innehållssidan, vad Claude-färdigheter är täcker hur formatet fungerar innan du skriver din första.

Att hitta de 1159 färdigheter som faktiskt klarar våra tester är anledningen till att vi byggde SkillProof. Om du vill hoppa över att prova dig fram är vår katalog med testade kodningsfärdigheter en bra startpunkt. Om du hellre vill installera en uppsättning som redan har testats tillsammans, säljer vi rollbaserade paket om tio – Developer Toolkit, Writer Pack, Security & Code Review och fem andra – för $10 styck på /bundles.