Blogg

Hermes Agent-färdigheter: Installera och skapa en egen färdighet

Markdown

Kataloger och GitHub, formatet SKILL.md, /learn, kontroll, uppdatering och borttagning av Hermes Agent-färdigheter med kompletta kommandoexempel.

Läs hela artikeln

En färdighet är en sparad instruktion för en agent: du beskriver en gång hur en uppgift ska utföras, och därefter tillämpar Hermes den när du anropar /skill-name, utan att du behöver förklara samma sak igen. En färdig färdighet kan installeras med ett enda kommando, och du kan skapa en egen på två sätt: skriva SKILL.md manuellt eller använda /learn.

Om du inte har installerat Hermes än börjar du med guiden vad den här agenten är och hur du installerar den, och går sedan vidare till färdigheter.

Praktiska instruktioner för hur du använder Ailoot finns i dokumentationen.

Vad är en färdighet i Hermes Agent?

Det viktigaste

En färdighet är en fil med instruktioner för en agent: vad den ska göra, vilka kommandon den ska använda, vad den ska vara uppmärksam på och var misstag ofta uppstår. Den lagras i mappen ~/.hermes/skills/ som en SKILL.md-fil, tillsammans med eventuellt tillhörande material. Efter installation blir färdigheten automatiskt kommandot /name i alla chattar med agenten.

Du skriver en prompt i ett meddelande till agenten. En färdighet lagras i en separat fil, och Hermes kan använda instruktionen i framtida uppgifter. Agenten har tillgång till en lista med namn och beskrivningar och läser in hela färdighetstexten när den är relevant för uppgiften. Det sparar utrymme i kontexten: alla instruktioner läses inte in på en gång.

En färdighet ger inte i sig agenten nya verktyg eller åtkomst; den beskriver hur agenten ska använda de verktyg den redan har. En ny integrering med en extern tjänst hanteras av MCP, vilket är ett separat ämne. Om en uppgift kräver exakt programlogik, särskild behörighet eller bearbetning av en händelseström behövs agentverktyg; enbart en färdighet räcker inte.

Välj en färdig färdighet för en standarduppgift om instruktionerna passar och källan har kontrollerats. Skriv en egen när du behöver bevara din specifika arbetsordning, dina begränsningar och utdataformat. Använd /learn när du redan har material eller har genomfört en process och inte vill skriva filen manuellt.

Färdigheter är dokument med information som en agent behöver och som den läser in bara när det behövs.

— Hermes Agent-dokumentation (översatt från engelska), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills

Formatet är öppet och kompatibelt med Agent Skills-specifikationen, så färdigheter från andra kataloger fungerar vanligtvis i Hermes utan formatändringar, även om en viss färdighet kan kräva egna verktyg eller nycklar. Du kan också dela din egen färdighet om du vill.

Vilka färdigheter är redan installerade och var lagras de?

Det viktigaste

Som standard lagras färdigheter i mappen ~/.hermes/skills/, organiserade i undermappar efter kategori (om du använder en profil som avviker från standarden eller variabeln HERMES_HOME är sökvägen en annan; hermes config path visar den). Efter installation innehåller Hermes redan dussintals inbyggda färdigheter, från att söka på arXiv till att arbeta med GitHub och dokument. Kommandot hermes skills list visar listan, och du kan fråga agenten i chatten vilka färdigheter den har.

Mappen är organiserad så här:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

SKILL.md är den enda obligatoriska filen. Allt annat läggs till efter behov: references/ för längre material, scripts/ för hjälpprogram och templates/ och assets/ för mallar och filer.

Den inbyggda katalogen innehåller färdigheter för vardagliga uppgifter: hitta GIF-bilder, arbeta med PDF-filer, kalkylblad, YouTube, GitHub och anteckningar. Den fullständiga listan med beskrivningar finns på sidan katalog över inbyggda färdigheter. Med varje hermes update uppdaterar Hermes också inbyggda färdigheter samtidigt som dina ändringar i dem bevaras.

Hur installerar du en färdig färdighet från katalogen?

Det viktigaste

Öppna katalogen med hermes skills browse, hitta det du behöver med hermes skills search, visa en färdighets informationskort med hermes skills inspect och installera den med hermes skills install. Varje färdighet genomgår en säkerhetskontroll före installation, och officiella färdigheter utlöser ingen varning om tredjepartskällor.

  1. Sök i katalogen

    hermes skills search pdf
    

    Sökningen görs bland alla anslutna källor. Kör hermes skills browse om du vill se hela katalogen utan filter.

  2. Visa färdighetens informationskort

    hermes skills inspect skills-sh/anthropics/skills/pdf
    

    Informationskortet visar beskrivning, källa och tillitsnivå. Installera inte någon annans färdighet utan att läsa informationskortet.

  3. Installera den

    hermes skills install skills-sh/anthropics/skills/pdf
    

    Hermes hämtar SKILL.md och tillhörande filer, kör en säkerhetskontroll och lägger allt i ~/.hermes/skills/. Färdigheten är genast tillgänglig som kommandot /pdf. Om färdigheten behöver ytterligare verktyg eller nycklar anges de i dess SKILL.md, och Hermes meddelar dig under installationen.

Säkerhetskontrollen letar efter försök att skicka data utanför systemet, instruktioner som injicerats för agenten samt kommandon som kan radera eller skada filer. Källor har olika tillitsnivåer:

NivåFärdighetens källaVad som händer vid installation
InbyggdIngår i HermesFinns redan; ingen installation behövs
OfficiellMappen för valfria färdigheter i Hermes-arkivetInstalleras utan varning om tredjepartskälla: hermes skills install official/security/1password
BetroddArkiven openai/skills, anthropics/skills, huggingface/skills och NVIDIA/skillsMindre strikt kontroll
AnnanKataloger, andra personers GitHub-arkiv, direktlänkarVarning och fullständig kontroll

Om kontrollen utfärdar en varning kan du fortsätta installationen med flaggan --force, men läs först vilken risk den hittade. Ett utlåtande om att något är ”farligt” kan inte kringgås. Kontrollen i sig garanterar inte säkerhet: innan du kör någon annans färdighet för första gången ska du läsa instruktionerna och tillhörande kommandon.

Hur installerar du en färdighet från GitHub eller en länk?

Det viktigaste

Installera en färdighet från GitHub med hermes skills install owner/repository/path eller använd en direktlänk till en SKILL.md-fil; Hermes hämtar filerna som hör till den. Du kan ansluta din egen färdighetskälla med hermes skills tap add, varefter den fungerar som vilken annan katalog som helst.

Tre sätt att installera:

# 1. A specific skill from a GitHub repository (the path inside the repository comes after its name)
hermes skills install anthropics/skills/skills/pdf

# 2. A direct link to a SKILL.md on any site (share this skill in a chat)
hermes skills install '<OFFICIAL_URL>'

# 3. Connect an entire repository as a source (replace with your owner and repository)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

För en direktlänk hämtar Hermes SKILL.md och bara de filer från tjänstens undermappar som nämns i den; den hämtar inte orelaterade filer från webbplatsen. Länken sparas som en källa, och hermes skills update uppdaterar senare färdigheten från samma adress.

Utöver GitHub är externa färdighetskataloger tillgängliga. Du hittar färdigheter från dem med samma kommando hermes skills search, genom att ange källan.

Uppmärksamhet

GitHub begränsar oautentiserade förfrågningar till 60 per timme. Om du får fel om hastighetsbegränsning vid installation eller sökning lägger du till GITHUB_TOKEN i filen ~/.hermes/.env; gränsen höjs då till 5000 förfrågningar per timme.

Hur använder du en färdighet efter installationen?

Det viktigaste

En installerad färdighet blir automatiskt ett kommando: skriv /skill-name och uppgiften på samma rad. Ingen separat aktivering behövs. Det fungerar i terminalen, webbgränssnittet och meddelandeappar via gatewayen. Du kan anropa upp till fem färdigheter i ett och samma meddelande, eller göra en återkommande kombination till ett enda kommando.

Skriv hermes ...-kommandon i terminalen och anrop av /skill-name i en chatt med agenten (i samma terminal, webbgränssnittet eller en meddelandeapp):

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

Om du skriver /skill-name utan någon uppgift läser Hermes in instruktionerna och frågar vad du vill att den ska göra. Du kan anropa flera färdigheter på en rad, upp till fem; den återstående texten blir uppgiften:

/github-pr-workflow /test-driven-development close issue 123 and open a PR

För kombinationer du använder regelbundet finns färdighetspaket, som kallas bundles i Hermes terminologi: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development grupperar flera färdigheter under ett kort /backend-dev-kommando. Ett sådant paket fungerar som ett alias; färdigheterna i det måste vara installerade i förväg.

Snedstreckskommandon fungerar också i Telegram om gatewayen är ansluten; installationen beskrivs i guiden hur du ansluter Hermes Agent till Telegram. Det är också ett smidigt sätt att köra färdigheter från mobilen.

Hur skapar du en egen färdighet: vad ska stå i SKILL.md?

Det viktigaste

En egen färdighet är en mapp i ~/.hermes/skills/ med en obligatorisk fil, SKILL.md: en kort inledning med namn och beskrivning, följd av instruktioner ordnade i avsnitt—när den ska användas, arbetsordningen, vanliga misstag och verifiering. Den skrivs i vanlig text; ingen programmering behövs. För en enkel version räcker en mapp och en fil.

Färdigheter är det främsta sättet att lägga till nya funktioner i Hermes Agent: de är enklare att skapa än verktyg, kräver inga ändringar i agentens kod och kan delas med communityn.

— Hermes Agent-dokumentation (översatt från engelska), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills

Du kan kopiera den här färdigheten och anpassa den för dig själv:

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

Inledningen mellan de tre strecken är metadata. De viktigaste fälten är name (på latinska bokstäver, avdelade med bindestreck och används för att anropa färdigheten som ett kommando) och description. Agenten använder beskrivningsfältet för att avgöra om färdigheten passar den aktuella uppgiften och ska läsas in. Om beskrivningen är vag kanske färdigheten inte läses in när den behövs.

Efter inledningen följer instruktionernas avsnitt. When to Use anger när färdigheten ska läsas in. Procedure beskriver stegen. Pitfalls tar upp var agenten ofta gör misstag och hur de kan undvikas. Verification förklarar hur resultatet ska kontrolleras. Om instruktionerna är långa flyttar du huvudinnehållet till filer i references/; de läses in först när de behövs, och lägger hjälpprogram i scripts/.

Tips

Lägg det vanligaste scenariot först och sällsynta fall sist i filen. Hermes läser en färdighet uppifrån och ned, och den här ordningen sparar kontextutrymme.

Om en färdighet behöver en API-nyckel anger du den i inledningen med required_environment_variables; lägg inte själva nyckeln i filen, utan ange bara variabelns namn. Hermes frågar efter värdet en gång, vid det första anropet i en lokal terminal, och tillhandahåller det sedan automatiskt (i meddelandeappar uppmanas du att konfigurera nyckeln lokalt). Fälten platforms, config, blueprint och andra beskrivs på den officiella dokumentationssidan Creating Skills.

När filen är klar följer du de här stegen:

  1. Skapa färdighetsmappen

    mkdir -p ~/.hermes/skills/weekly-review
    

    Mappnamnet motsvarar fältet name i inledningen.

  2. Spara SKILL.md

    Lägg en fil med namnet SKILL.md och dina instruktioner i mappen; du kan använda exemplet ovan och skriva om det för din uppgift.

  3. Anropa färdigheten och kontrollera den

    Skriv /weekly-review och be agenten gå igenom din vecka. Om den följer stegen i dina instruktioner fungerar färdigheten.

Hur skapar du en färdighet från befintligt material med /learn?

Det viktigaste

Kommandot /learn skapar en färdighet utifrån befintligt material: ge det en dokumentationsmapp, en sidlänk, dina anteckningar eller en muntlig beskrivning av en process, så skriver Hermes en SKILL.md enligt vedertagna konventioner som du kan granska. En bok eller ett stort arkiv resulterar i en färdighet med separata filer för olika ämnen.

/learn documentation for the demo API in ~/projects/example-docs, especially the section on authentication
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn how I just published a site to hosting

Om du precis har genomfört en komplicerad process med agenten ber du /learn att spara den som en färdighet medan alla steg fortfarande finns i konversationen. Nästa gång upprepar Hermes processen med hjälp av de färdiga instruktionerna.

En stor källa, som en bok, specifikation eller ett dokumentarkiv, får inte plats i en enda fil. Hermes skapar en kompakt SKILL.md med en ämneskarta och flyttar detaljerna till references/. Filerna tar inte upp något kontextutrymme förrän agenten läser in dem för att besvara en fråga. Om du anropar /learn igen om samma ämne läggs innehållet till den befintliga färdigheten i stället för att skapa en dubblett.

Hur kontrollerar du att en färdighet fungerar?

Det viktigaste

Kontrollera färdigheten genom att köra hermes chat --toolsets skills -q och ge agenten en uppgift som hör till färdigheten, till exempel be den gå igenom en vecka med hjälp av en uppgiftslista. Om agenten sorterar uppgifterna i grupperna i dina instruktioner fungerar färdigheten. Om den svarar som vanligt kontrollerar du filnamnet, beskrivningen i inledningen och var du lade mappen.

hermes chat --toolsets skills -q "review my week using the weekly-review skill: done - report and calls, stalled - hosting payment"

Det här är kontrollen som dokumentationen rekommenderar: kör färdigheten och se om agenten följer dina instruktioner. Om den inte gör det kontrollerar du tre möjliga orsaker. För det första kanske mappnamnet eller name i inledningen inte stämmer med namnet du anropar. För det andra kanske beskrivningen inte tydligt visar när färdigheten ska användas; skriv om beskrivningen med uppgiftens egna ord. För det tredje kanske mappen inte ligger i ~/.hermes/skills/, så Hermes inte kan se den. Observera att flaggan --toolsets skills begränsar verktygsuppsättningen i kontrollen: den visar hur agenten hanterar instruktionen, men kontrollerar inte färdighetens beroenden, till exempel externa program.

hermes skills list i terminalen visar exakt vad som är installerat.

Färdigheter är en del av en AI-klon: ett sätt att dokumentera en gång hur du utför en uppgift så att agenten kan upprepa den utan påminnelser. Kombinationen består av AI-klon + Second Brain + Context Engineering. Den hjälper agenten att förstå din arbetslogik och uppgiftens kontext.

Hur uppdaterar och tar du bort färdigheter?

Det viktigaste

hermes skills check visar vilka installerade färdigheter som har uppdaterats vid källan, hermes skills update hämtar de nya versionerna och hermes skills uninstall name tar bort en färdighet. Dina ändringar i någon annans färdighet bevaras vid uppdateringar: Hermes hoppar över ändrade filer. Du kan återställa originalet: för en färdighet från hubben använder du hermes skills update name --force; för en inbyggd färdighet använder du hermes skills reset name --restore.

hermes skills check      # what changed at the sources
hermes skills update     # download new versions
hermes skills uninstall pdf   # remove a skill from the hub

Om du vill ta bort en färdighet du skapat manuellt raderar du dess mapp från ~/.hermes/skills/. Om du har anpassat någon annans färdighet lämnar update den ifred: Hermes jämför hashvärden och hoppar över ändrade filer för att undvika att skriva över ditt arbete. Om du vill återställa originalet för en färdighet från hubben använder du hermes skills update name --force; för en inbyggd färdighet använder du hermes skills reset name --restore. Båda kommandona skriver över dina ändringar, så spara din version först.

Om du inte behöver de inbyggda färdigheterna och de gör listan rörig inaktiverar hermes skills opt-out tillägget av dem vid uppdateringar. Kommandot opt-out --remove tar också bort dem som du inte har ändrat.

Vad ska du göra om en färdighet inte installeras eller fungerar?

Det viktigaste

Tre saker ställer oftast till problem: GitHubs gräns på 60 förfrågningar per timme, att säkerhetskontrollen blockerar installationen och att filen ligger i fel mapp. Om du når hastighetsgränsen lägger du till GITHUB_TOKEN. Om kontrollen blockerar installationen läser du utlåtandet. Om Hermes inte hittar färdigheten kontrollerar du om den ligger i ~/.hermes/skills/.

SymptomOrsakÅtgärd
Fel om hastighetsbegränsning vid sökning eller installationUtan en token tillåter GitHub upp till 60 förfrågningar per timmeLägg till GITHUB_TOKEN i ~/.hermes/.env
Installationen blockeradesKontrollen hittade en risk i färdighetens kodLäs kontrollresultatet under installationen; om du vill kontrollera en installerad färdighet igen kör du hermes skills audit. Om det är en varning kan du fortsätta med --force; om utlåtandet är ”farligt” kan du inte det
Färdigheten är installerad, men /name fungerar inteNamnet stämmer inte eller mappen ligger felKör hermes skills list och kontrollera mappen ~/.hermes/skills/
Färdigheten finns inte ens i listanSKILL.md har en begränsning för plattform eller nödvändiga verktygÖppna SKILL.md och kontrollera fälten platforms och requires_*
Den nya färdighetsversionen hämtades inte efter uppdateringenDu ändrade filen lokalt, och Hermes bevarar dina ändringarOm du vill ha originalet använder du update name --force för en färdighet från hubben eller reset --restore för en inbyggd färdighet; om din version är viktigare gör du ingenting
Färdigheter från ett annat arkiv läses inte inArkivet måste vara markerat som betrottKör hermes skills trust i arkivet

Hermes hittar färdigheter i mapparna .hermes/skills/ och .agents/skills/ i ett Git-arkiv. Innan de läses in måste du markera arkivet som betrott: de här filerna innehåller instruktioner som agenten kommer att följa. Därefter fungerar färdigheter från arkivet bara där och genomgår samma säkerhetskontroll. Du behöver bara markera arkivet som betrott en gång.

Vad bör du göra först?

Det viktigaste

Installera en färdig färdighet från katalogen; installationen kräver bara ett kommando. Välj sedan en instruktion som du brukar upprepa, skicka den till /learn och kontrollera resultatet på en verklig uppgift från ditt arbete.

Nästa artikel på ämnet: hur du ansluter Hermes Agent till Telegram, så att du kan anropa färdigheter från mobilen, och hur du håller en agent igång på en server dygnet runt, om du vill använda schemalagda färdigheter. Om du väljer agent kan du läsa jämförelsen OpenClaw eller Hermes Agent.

Du kan fortsätta utforska Ailoot på ailoot.ai.

Fler detaljer

Frågor om den här guiden: Hermes Agent-färdigheter: Installera och skapa en egen färdighet

Varför visas en installerad skill inte som snedstreckskommando?

Kontrollera listan över installerade skills, SKILL.md-filnamn och name-fält samt aktiv profils skills-mapp. Plattforms-, verktygs- eller kodförrådsförtroendebegränsningar kan också hindra inläsning.

Verifierar det begränsade skills-röktestet varje beroende?

Nej. Ett skills-test kontrollerar att agenten läser in och följer instruktionen. Kontrollera nödvändiga verktyg, program och nycklar separat och verifiera sedan ett avgränsat verkligt resultat före hela arbetsflödet.

Alla artiklar