Claude Skills förklarat: De tre nivåerna av progressiv avslöjning

En Claude Skill är fysiskt sett en mapp. Inte en hostad tjänst, inte en binärfil, inte ett textblock som du klistrar in högst upp i en konversation – en katalog som innehåller en SKILL.md-fil och vad som helst annat som uppgiften behöver. Nästan allt intressant med Skills följer av det beslutet, eftersom en mapp är något som en agent selektivt kan öppna. En prompt kan inte öppnas selektivt. Den finns antingen i konversationen eller inte.

Anthropics dokumentation beskriver upplägget som organiserat på samma sätt som en introduktionsguide du skulle skapa för en ny teammedlem, och analogin sträcker sig längre än den först verkar. Ingen läser en introduktionsguide från pärm till pärm innan arbetet börjar. De läser sidan som matchar frågan framför dem och litar på att resten fortfarande finns där när de behöver den. En färdighet bygger på samma vad: att det mesta av en procedur kan ligga kvar på disken större delen av tiden.

Filsystem först, förmåga sedan

Claude körs i en virtuell maskin med filsystemåtkomst. Det är förutsättningen för att en färdighet ska vara en katalog i stället för en konfigurationspost, eftersom det låter agenten lista en mapp, läsa en fil och följa en referens till en annan fil med samma åtgärder som en människa skulle använda. Inom detta paketerar en färdighet instruktioner, metadata och valfria resurser såsom skript och mallar.

Resultatet är en förmåga som är större än någon enskild fil i mappen. Instruktionerna anger hur uppgiften ska utföras. Ett medföljande skript kan utföra en del av den utan att beskrivas i löptext. Ett referensdokument kan innehålla material som slås upp i stället för att kommas ihåg. Det som gör dessa tre saker till ett system i stället för en hög är ordningen i vilken de blir synliga, vilket är den del som Anthropic kallar progressive disclosure – att ladda information i etapper när den behövs i stället för att förbruka kontext på förhand.

Nivå 1: de två fälten som alltid laddas

Varje färdighet börjar med YAML-frontmatter som innehåller ett namn och en beskrivning. Claude läser in den metadatan vid start och inkluderar den i systemprompten. Det är den enda delen av färdigheten som finns närvarande innan någon ber om något, och tills en färdighet utlöses upptar endast dess namn och beskrivning kontexten.

Beskrivningen utför tre uppgifter samtidigt, och genom att separera dem förstår man varför så många skills tyst ignoreras. Den är en etikett som talar om vad saken heter. Den är en indexpost, den text som en förfrågan matchas mot när Claude avgör om skillen är relevant. Och den är ett avgränsningspåstående, vilket är anledningen till att Anthropics vägledning säger att den måste ange både vad skillen gör och när den ska användas. En beskrivning som bara klarar den första ger matchningsfunktionen inget att matcha.

Ta två versioner av samma färdighet. Den ena beskrivs som att fylla i och validera PDF-formulär, att användas när en förfrågan innebär att fylla i eller kontrollera ett PDF-formulär. Den andra beskrivs som att hjälpa till med dokument. Den första namnger en åtgärd och en situation; den andra namnger ingendera. En färdighet vars beskrivning inte namnger något av detta kommer att ligga oläst på disken medan agenten utför uppgiften på det långa sättet – inte för att färdigheten misslyckades, utan för att den aldrig hittades.

Nivå 2: brödtexten, läs när beskrivningen matchar

När en begäran matchar beskrivningen öppnas den andra nivån: själva innehållet i SKILL.md. Det är proceduren – arbetsflöden, bästa praxis, vägledning – och den är skriven för en agent som redan har beslutat att den här färdigheten är rätt verktyg för uppgiften. Det är där ett team skriver ned de steg som det annars skulle upprepa i varje konversation, och det är där hänvisningarna till djupare material finns.

Ordningen spelar roll här lika mycket som på nivå 1. Själva innehållet laddas inte vid start, och det laddas inte för säkerhets skull. Det kommer först efter att ett beslut har fattats, vilket innebär att beslutet måste kunna fattas enbart utifrån nivå 1. En färdighet med en vag beskrivning har ingen möjlighet att räddas på nivå 2, eftersom nivå 2 aldrig läses.

Nivå 3: filer som öppnas därför att något pekade på dem

Den tredje nivån är resten av mappen: ytterligare filer som refereras från SKILL.md. Anthropics exempel är en FORMS.md med avancerad vägledning om formulärifyllning, som hålls utanför huvudinstruktionerna så att dessa förblir korta och detaljerna bara finns tillgängliga när en uppgift behöver dem. Skript och mallar hör också hemma på den här nivån.

Den strukturella effekten är att en färdighet kan rymma en stor mängd material utan att bära allt på en gång. En mapp kan innehålla en huvudsaklig instruktionsfil, en detaljerad referens, en uppsättning mallar och ett skript, och en given uppgift kan komma åt en av dem. Det som ingenting pekar på ligger kvar på disken, och disken är inte den knappa resursen hos en agent. Kontexten är det.

Det är också här som formatet lyfter det tak som prompter stöter på. En prompt måste vara tillräckligt kort för att vara värd att klistra in. Materialet som medföljer en skill begränsas av vad en katalog kan rymma, eftersom den enda del som når modellen är den del som uppgiften faktiskt berörde.

Varför ordningen är designen, inte en detalj

Tre konsekvenser följer, och tillsammans är de anledningen till att detta är värt att förstå snarare än att bara känna till.

• Kontext är en budget, och alltid inläst innehåll är en fast kostnad. Allt i en systemprompt betalas vid varje begäran, inklusive begäranden som inte har något att göra med den färdigheten. Progressivt avslöjande gör en fast kostnad till en villkorad: en beskrivning alltid, instruktioner när relevant, referenser när de refereras.

• Beskrivningen är ett gränssnitt. Det är den enda delen av en färdighet som garanterat blir sedd, så det är där en författare måste tänka på triggning och inte bara på innehåll.

• En färdighet har tre underhållshastigheter.Metadata ändras när färdigheten bör aktiveras annorlunda, brödtexten ändras när arbetsflödet ändras och referenserna ändras när det underliggande materialet gör det. Att hålla dem åtskilda förhindrar att en referensuppdatering blir en omskrivning av instruktionerna.

Kostnaden är spegelbilden av nyttan. Varje nivågräns är en plats där modellen måste fatta ett beslut korrekt. En beskrivning som är för snäv innebär att färdigheten aldrig utlöses och att mappen är dödvikt. En som är för bred innebär att den utlöses för arbete som den inte byggdes för, och dess instruktioner blir en belastning på orelaterade uppgifter. Progressivt avslöjande gör beskrivningen bärande på ett sätt som en lång prompt, som alltid är närvarande, aldrig är.

Vad Anthropic redan tillhandahåller, och varifrån dina egna färdigheter kommer

Anthropic tillhandahåller färdigbyggda Skills för PowerPoint, Excel, Word och PDF – presentationer, kalkylblad, dokument och formaterad PDF-utdata. De är tillgängliga på claude.ai, Claude API, Claude Platform on AWS och Microsoft Foundry, med förbehållet att de på Foundry kräver en Hosted on Anthropic-distribution.

Det är det snabbaste sättet att se mekanismen i stället för att läsa om den. Laddningsordningen är identisk med den för allt du skriver själv; skillnaden mellan en förbyggd skill och en anpassad är vem som har skapat mappen, inte hur den når modellen.

Custom Skills kan skapas i Claude Code, laddas upp via Claude API eller läggas till i inställningarna för claude.ai. Anthropics angivna fördelar med dem är de man förväntar sig av allt återanvändbart: att specialisera Claude för domänuppgifter, att skapa vägledning en gång i stället för att upprepa den och att kombinera flera skills för arbete i flera steg. Den sista av dessa följer mest direkt av arkitekturen, eftersom om varje skill är en mapp som öppnas vid behov kostar en uppsättning skills väldigt lite tills arbetet faktiskt behöver dem.

En färdighet är inte en prompt och inte en anslutning.

Tre saker blandas samman i samtal, och laddningsordningen gör det lätt att hålla isär distinktionerna.

En prompt är på konversationsnivå. Den finns från första turen, den färgar allt i den konversationen, och den försvinner med konversationen. En skill är vid behov: den finns innan konversationen börjar, det mesta av den kommer aldrig in i konversationen alls, och den del som kommer in gör det eftersom en beskrivning matchade. Det är skillnaden mellan att tala om för en agent hur den ska bete sig och att ge den något som den kan plocka upp.

En connector handlar om räckvidd. Connectors är appåtkomst, vilket innebär att de avgör vad en agent kan komma åt; en skill avgör hur agenten ska göra något när den väl kan komma åt det. Ett team kan ha utmärkta connectors och ändå producera inkonsekventa dokument, eftersom åtkomst inte är procedur. Det kan också ha utmärkta skills och ändå inte se data, eftersom procedur inte är åtkomst.

Anthropics dokumentation behandlar Skills och Model Context Protocol som olika lager, och mekanismen med tre nivåer visar varför separationen är ren. Laddningsordningen handlar om när informationen anländer, inte var den kommer ifrån.

Var donationen passar in, i ett stycke

Den 22 oktober 2026 skänkte Anthropic Agent Skills-standarden till Agentic AI Foundation under Linux Foundation – namnet, logotypen, GitHub-organisationen och domänen agentskills.io – med ingenjörer från Anthropic, Google, OpenAI och andra företag som underhåller den som privatpersoner. Inget av detta förändrar mekanismen ovan. Mappformatet, YAML-frontmatter, inläsningsordningen och de färdigbyggda dokumentfärdigheterna är exakt som de var dagen innan. Det som har förändrats är vem som äger namnet, vilket har stor betydelse för en standards långsiktiga stabilitet och inte alls för hur du skriver en färdighet i eftermiddag.

Läser en färdighet innan du installerar den

Om de tre nivåerna utgör arkitekturen, utgör de också en kort granskningschecklista. Läs beskrivningen först, eftersom den avgör om något annat någonsin händer: den bör ange vad färdigheten gör och när den bör användas, med ord som en förfrågan rimligen skulle använda. Läs SKILL.md sedan, eftersom det är det förfarande som agenten kommer att följa, och det bör läsas som instruktioner till en kompetent kollega snarare än en sammanfattning av vad du hoppas ska hända. Läs det som den refererar till tredje. Läs sedan skripten.

Det sista är inte paranoia. Formatet gör det möjligt för en färdighet att bära instruktioner tillsammans med valfria resurser, och resurser kan innehålla körbar kod. En färdighet som du installerar är därför inte bara text som formar en konversation; det är en mapp som en kapabel agent kommer att öppna filer från och agera utifrån. Nivå-för-nivå-modellen visar exakt var du ska titta, vilket är mer än vad de flesta installerade saker erbjuder.

En gräns förtjänar att nämnas för läsare som kommer från våra egna sidor. OrcaRouter dirigerar modellanrop, och vi har ingen av Anthropics appar eller dess ytor för skills hos oss – en skill körs där agentens filsystem finns, och det är inte vårt lager. Det vi gör ligger under modellvalet: fler än 200 modeller bakom en enda OpenAI-kompatibel nyckel, leverantörens listpris förs vidare utan påslag och automatisk redundansväxling mellan leverantörer när en inte är tillgänglig. En skill avgör hur en uppgift ska utföras. En router avgör vilken modell som utför den, och inget av lagren borde behöva veta särskilt mycket om det andra.

Progressiv avslöjning är ärlig om den begränsning den löser. Kontexten är ändlig, procedurer är långa, och större delen av en given procedur är irrelevant för uppgiften framför dig. Ett namn, en brödtext och en uppsättning filer är inte en komplicerad konstruktion; det är den minsta möjliga som låter en agent bära en stor mängd kunskap samtidigt som den bara håller den del den behöver.

Det är därför den mest betydelsefulla raden i en välbyggd färdighet också är den kortaste. Allt annat i mappen är ett bibliotek. Beskrivningen är kortkatalogen, och när katalogen är fel kan biblioteket lika gärna vara obefintligt.