Blogg

Hermes Agent-skills: installering og oppretting av din egen skill

Markdown

Mapper og GitHub, SKILL.md-formatet, /learn, kontroll, oppdatering og fjerning av Hermes Agent-skills med fullstendige kommandoeksempler.

Les hele artikkelen

En skill er en lagret instruksjon for en agent: Du beskriver én gang hvordan en oppgave skal utføres, og deretter bruker Hermes den når du kaller /skill-name, uten at du trenger å forklare det på nytt hver gang. En ferdig skill kan installeres med én kommando, og du kan lage din egen på to måter: skrive SKILL.md manuelt eller bruke /learn.

Hvis du ikke har installert Hermes ennå, kan du begynne med veiledningen hva denne agenten er og hvordan du installerer den, og deretter gå videre til skills.

Praktiske instruksjoner for bruk av Ailoot finner du i dokumentasjonen.

Hva er en skill i Hermes Agent?

Hovedpoeng

En skill er en fil med instruksjoner for en agent: hva den skal gjøre, hvilke kommandoer den skal bruke, hva den skal være oppmerksom på, og hvor det ofte oppstår feil. Den lagres i mappen ~/.hermes/skills/ som en SKILL.md-fil, sammen med eventuelt tilhørende materiale. Etter installasjon blir skillen automatisk til en /name-kommando i alle chatter med agenten.

Du skriver en prompt i en melding til agenten. En skill lagres i en egen fil, og Hermes kan bruke instruksjonen i fremtidige oppgaver. Agenten har tilgang til en liste med navn og beskrivelser, og laster inn hele skill-teksten når den er relevant for oppgaven. Det sparer plass i konteksten: Ikke alle instruksjoner lastes inn samtidig.

En skill gir ikke agenten nye verktøy eller tilgang i seg selv; den beskriver hvordan verktøyene agenten allerede har, skal brukes. En ny integrasjon med en ekstern tjeneste håndteres av MCP, som er et eget tema. Hvis en oppgave krever presis programlogikk, spesiell autorisasjon eller behandling av en hendelsesstrøm, trengs agentverktøy; en skill alene er ikke nok.

Velg en ferdig skill til en standardoppgave hvis instruksjonene passer og kilden er kontrollert. Skriv din egen når du trenger å bevare din bestemte handlingsrekkefølge, begrensninger og utdataformat. Bruk /learn når du allerede har materiale eller har fullført en prosess og ikke vil skrive filen manuelt.

Skills er dokumenter med informasjon en agent trenger, som den bare laster inn når det trengs.

— Hermes Agent-dokumentasjon (oversatt fra engelsk), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills

Formatet er åpent og kompatibelt med Agent Skills-spesifikasjonen, så skills fra andre kataloger fungerer vanligvis i Hermes uten formatendringer, selv om en bestemt skill kan kreve egne verktøy eller nøkler. Du kan også dele din egen skill hvis du vil.

Hvilke skills er allerede installert, og hvor lagres de?

Hovedpoeng

Som standard lagres skills i mappen ~/.hermes/skills/, organisert i undermapper etter kategori (hvis du bruker en ikke-standard profil eller variabelen HERMES_HOME, blir banen annerledes; hermes config path viser den). Etter installasjonen har Hermes allerede dusinvis av innebygde skills, fra søk på arXiv til arbeid med GitHub og dokumenter. Kommandoen hermes skills list viser listen, og du kan også spørre agenten i chatten hvilke skills den har.

Mappestrukturen ser slik ut:

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

SKILL.md er den eneste obligatoriske filen. Alt annet legges til ved behov: references/ for lengre materiale, scripts/ for hjelpeprogrammer og templates/ og assets/ for maler og filer.

Den innebygde katalogen inneholder skills for hverdagsoppgaver: finne GIF-er og arbeide med PDF-filer, regneark, YouTube, GitHub og notater. Den fullstendige listen med beskrivelser finnes på siden for katalogen over innebygde skills. Hver gang du kjører hermes update, oppdaterer Hermes også innebygde skills, samtidig som endringene dine i dem bevares.

Hvordan installerer du en ferdig skill fra katalogen?

Hovedpoeng

Åpne katalogen med hermes skills browse, finn det du trenger med hermes skills search, vis et skill-kort med hermes skills inspect, og installer skillen med hermes skills install. Hver skill gjennomgår en sikkerhetskontroll før installasjon, og offisielle skills utløser ingen advarsel om tredjepartskilde.

  1. Søk i katalogen

    hermes skills search pdf
    

    Søket går gjennom alle tilkoblede kilder. Kjør hermes skills browse for å se hele katalogen uten filter.

  2. Vis skill-kortet

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

    Kortet viser beskrivelsen, kilden og tillitsnivået. Ikke installer en skill fra noen andre uten å lese kortet først.

  3. Installer den

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

    Hermes laster ned SKILL.md og tilhørende filer, kjører en sikkerhetskontroll og legger alt i ~/.hermes/skills/. Skillen blir umiddelbart tilgjengelig som kommandoen /pdf. Hvis skillen trenger flere verktøy eller nøkler, er de oppført i SKILL.md, og Hermes informerer deg om dette under installasjonen.

Sikkerhetskontrollen leter etter forsøk på å sende data ut av systemet, instruksjoner som er injisert for agenten, og kommandoer som kan slette eller skade filer. Kilder har ulike tillitsnivåer:

NivåSkill-kildeHva skjer under installasjonen
InnebygdFølger med HermesAllerede på plass; trenger ikke installeres
OffisiellMappen for valgfrie skills i Hermes-repositorietInstalleres uten advarsel om tredjepartskilde: hermes skills install official/security/1password
BetroddRepositoriene openai/skills, anthropics/skills, huggingface/skills og NVIDIA/skillsMindre streng kontroll
AnnenKataloger, andre personers GitHub-repositorier, direkte lenkerAdvarsel og full kontroll

Hvis kontrollen gir en advarsel, kan du fortsette installasjonen med flagget --force, men les først hvilken risiko den fant. En vurdering som «farlig» kan ikke omgås. Selve kontrollen garanterer ikke sikkerhet: Før du kjører en skill fra noen andre for første gang, bør du lese instruksjonene og tilhørende kommandoer.

Hvordan installerer du en skill fra GitHub eller en lenke?

Hovedpoeng

Installer en skill fra GitHub med hermes skills install owner/repository/path, eller bruk en direkte lenke til en SKILL.md-fil; Hermes laster ned tilhørende filer. Du kan koble til din egen skill-kilde med hermes skills tap add, og deretter fungerer den som enhver annen katalog.

Det finnes tre måter å installere på:

# 1. En bestemt skill fra et GitHub-repositorium (banen inne i repositoriet kommer etter navnet)
hermes skills install anthropics/skills/skills/pdf

# 2. En direkte lenke til SKILL.md på et hvilket som helst nettsted (del denne skillen i en chat)
hermes skills install '<OFFICIAL_URL>'

# 3. Koble til et helt repositorium som kilde (bytt ut med din eier og ditt repositorium)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

For en direkte lenke laster Hermes ned SKILL.md og bare filene som er nevnt i den, fra undermapper på tjenesten; den laster ikke ned uvedkommende filer fra nettstedet. Lenken huskes som en kilde, og hermes skills update oppdaterer senere skillen fra den samme adressen.

I tillegg til GitHub kan eksterne ferdighetskataloger kobles til. Du kan finne ferdigheter fra dem med den samme kommandoen hermes skills search, ved å angi kilden.

Merk

GitHub begrenser uautentiserte forespørsler til 60 per time. Hvis du får feil om forespørselsbegrensning under installasjon eller søk, legger du til GITHUB_TOKEN i filen ~/.hermes/.env; da øker grensen til 5000 forespørsler per time.

Hvordan bruker du en skill etter installasjon?

Hovedpoeng

En installert skill blir automatisk en kommando: Skriv /skill-name og oppgaven på samme linje. Du trenger ikke å aktivere den separat. Den fungerer i terminalen, nettgrensesnittet og meldingsappene via gatewayen. Du kan kalle opptil fem skills i én melding, eller gjøre en kombinasjon du bruker ofte om til én kommando.

Skriv hermes ...-kommandoer i terminalen og /skill-name-kall i en chat med agenten (i samme terminal, nettgrensesnittet eller en meldingsapp):

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

Hvis du skriver /skill-name uten en oppgave, laster Hermes instruksjonene og spør hva du vil at den skal gjøre. Du kan kalle flere skills på én linje, opptil fem; resten av teksten blir oppgaven:

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

For kombinasjoner du bruker regelmessig, finnes det skill-bunter, som på Hermes-språket kalles bundles: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development grupperer flere skills under én kort /backend-dev-kommando. En slik bundle fungerer som et alias; skillene i den må være installert på forhånd.

Slash-kommandoer fungerer også i Telegram hvis gatewayen er tilkoblet; oppsettet beskrives i veiledningen slik kobler du Hermes Agent til Telegram. Dette er også en praktisk måte å kjøre skills fra telefonen på.

Hvordan lager du din egen skill: hva skal stå i SKILL.md?

Hovedpoeng

Din egen skill er en mappe i ~/.hermes/skills/ med én obligatorisk fil, SKILL.md: en kort header med navn og beskrivelse, fulgt av instruksjoner organisert i seksjoner om når den skal brukes, handlingsrekkefølgen, vanlige feil og verifisering. Den skrives i ren tekst; du trenger ikke å programmere. For en enkel skill holder det med én mappe og én fil.

Skills er den viktigste måten å legge til nye funksjoner i Hermes Agent på: De er enklere å lage enn verktøy, krever ingen endringer i agentens kode og kan deles med fellesskapet.

— Hermes Agent-dokumentasjon (oversatt fra engelsk), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills

Du kan kopiere denne skillen og tilpasse den til deg selv:

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

Headeren mellom de tre bindestrekene inneholder metadata. De viktigste feltene er name (med latinske bokstaver, bindestreksdelt, og brukt til å kalle skillen som en kommando) og description. Agenten bruker beskrivelsesfeltet for å avgjøre om skillen passer til den aktuelle oppgaven og bør lastes inn. Hvis beskrivelsen er vag, kan det hende skillen ikke lastes inn når den trengs.

Etter headeren følger seksjoner med instruksjoner. When to Use angir når skillen skal lastes inn. Procedure beskriver trinnene. Pitfalls tar for seg hvor agenten ofte gjør feil, og hvordan de kan unngås. Verification forklarer hvordan resultatet skal kontrolleres. Hvis instruksjonene er lange, flytter du hovedinnholdet til filer i references/; de lastes bare inn ved behov, og hjelpeprogrammer legges i scripts/.

Tips

Plasser det vanligste scenarioet først og sjeldne tilfeller mot slutten av filen. Hermes leser en skill ovenfra og ned, og denne rekkefølgen sparer kontekst.

Hvis en skill trenger en API-nøkkel, oppgir du den i headeren med required_environment_variables; ikke legg selve nøkkelen i filen, bare oppgi variabelnavnet. Hermes spør etter verdien én gang, ved første gangs bruk i en lokal terminal, og fyller den deretter inn automatisk (i meldingsapper ber den deg om å konfigurere nøkkelen lokalt). Feltene platforms, config, blueprint og andre beskrives på den offisielle dokumentasjonssiden Creating Skills.

Når filen er klar, følger du disse trinnene:

  1. Opprett skill-mappen

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

    Mappenavnet samsvarer med feltet name i headeren.

  2. Lagre SKILL.md

    Legg en fil som heter SKILL.md med instruksjonene dine i mappen; du kan bruke eksempelet ovenfor og tilpasse det til oppgaven din.

  3. Kall skillen og kontroller den

    Skriv /weekly-review og be agenten gå gjennom uken din. Hvis den følger trinnene i instruksjonene, fungerer skillen.

Hvordan lager du en skill fra eksisterende materiale med /learn?

Hovedpoeng

Kommandoen /learn lager en skill fra eksisterende materiale: Gi den en dokumentasjonsmappe, en lenke til en side, notatene dine eller en muntlig beskrivelse av en prosess, så skriver Hermes SKILL.md etter anerkjente konvensjoner, slik at du kan gå gjennom den. En bok eller et stort arkiv gir en skill med separate filer for hvert emne.

/learn dokumentasjon for demo-API-et i ~/projects/example-docs, særlig delen om autentisering
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn hvordan jeg nettopp publiserte et nettsted til hosting

Hvis du nettopp har fullført en komplisert prosess sammen med agenten, ber du /learn om å lagre den som en skill mens alle trinnene fortsatt står i samtalen. Neste gang gjentar Hermes prosedyren ved hjelp av de ferdige instruksjonene.

En stor kilde, for eksempel en bok, spesifikasjon eller et dokumentarkiv, får ikke plass i én fil. Hermes oppretter en kompakt SKILL.md med et emnekart og flytter detaljene til references/. Disse filene tar ikke opp plass i konteksten før agenten laster dem inn for å svare på et spørsmål. Kaller du /learn igjen for samme emne, legger den innhold til den eksisterende skillen i stedet for å opprette en kopi.

Hvordan kontrollerer du at en skill fungerer?

Hovedpoeng

For å kontrollere skillen kjører du hermes chat --toolsets skills -q og gir agenten en forespørsel som er relevant for skillen, for eksempel å gå gjennom uken ved hjelp av en oppgaveliste. Hvis agenten sorterer oppgavene i gruppene i instruksjonene dine, fungerer skillen. Hvis den svarer som vanlig, bør du kontrollere filnavnet, beskrivelsen i headeren og hvor du la mappen.

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

Dette er testen dokumentasjonen anbefaler: Kjør skillen og kontroller at agenten følger instruksjonene dine. Hvis den ikke gjør det, bør du undersøke tre mulige årsaker. For det første stemmer kanskje ikke mappenavnet eller name i headeren med navnet du kaller. For det andre er beskrivelsen kanskje ikke tydelig nok på når skillen skal brukes; skriv den om med ordene du selv ville brukt om oppgaven. For det tredje ligger mappen kanskje ikke i ~/.hermes/skills/, slik at Hermes ikke finner den. Merk at flagget --toolsets skills begrenser verktøysettet i testen: Det viser hvordan agenten følger instruksjonen, men kontrollerer ikke skillens avhengigheter, for eksempel eksterne programmer.

hermes skills list i terminalen viser nøyaktig hva som er installert.

Skills er en del av en AI-klone: en måte å registrere én gang hvordan du utfører en oppgave, slik at agenten kan gjenta den uten påminnelser. Kombinasjonen består av AI-klone + Second Brain + Context Engineering. Den hjelper deg med å overføre arbeidslogikken og oppgavekonteksten din til agenten.

Hvordan oppdaterer og fjerner du skills?

Hovedpoeng

hermes skills check viser hvilke installerte skills som er oppdatert hos kilden, hermes skills update laster ned nye versjoner, og hermes skills uninstall name fjerner en skill. Endringene dine i en skill fra noen andre bevares ved oppdateringer: Hermes hopper over filer som er endret. Du kan gjenopprette originalen: Bruk hermes skills update name --force for en skill fra huben og hermes skills reset name --restore for en innebygd skill.

hermes skills check      # hva som er endret hos kildene
hermes skills update     # last ned nye versjoner
hermes skills uninstall pdf   # fjern en skill fra huben

Hvis du vil fjerne en skill du har laget manuelt, sletter du mappen dens fra ~/.hermes/skills/. Hvis du har tilpasset en skill fra noen andre, lar update den være: Hermes sammenligner hasher og hopper over endrede filer for å unngå å overskrive arbeidet ditt. Bruk hermes skills update name --force for å gjenopprette originalen til en skill fra huben, og hermes skills reset name --restore for en innebygd skill. Begge kommandoene overskriver endringene dine, så lagre din egen versjon først.

Hvis du ikke trenger de innebygde skillene og de fyller opp listen, deaktiverer hermes skills opt-out at de legges til under oppdateringer. Kommandoen opt-out --remove fjerner også de du ikke har endret.

Hva gjør du hvis en skill ikke vil installeres eller ikke fungerer?

Hovedpoeng

Tre ting skaper oftest problemer: GitHubs grense på 60 forespørsler i timen, at sikkerhetskontrollen blokkerer installasjonen, og at filen ligger i feil mappe. Hvis du når forespørselsgrensen, legger du til GITHUB_TOKEN. Hvis kontrollen blokkerer installasjonen, leser du vurderingen. Hvis Hermes ikke finner skillen, kontrollerer du om den ligger i ~/.hermes/skills/.

SymptomÅrsakHva du kan gjøre
Feil om forespørselsgrense under søk eller installasjonUten token tillater GitHub opptil 60 forespørsler i timenLegg til GITHUB_TOKEN i ~/.hermes/.env
Installasjonen er blokkertKontrollen fant en risiko i koden til skillenLes resultatet fra kontrollen under installasjonen; kjør hermes skills audit for å kontrollere en installert skill på nytt. Er resultatet en advarsel, kan du fortsette med --force; er vurderingen «farlig», kan du ikke fortsette
Skillen er installert, men /name fungerer ikkeNavnet stemmer ikke, eller mappen ligger feilKjør hermes skills list og kontroller mappen ~/.hermes/skills/
Skillen står ikke engang på listenSKILL.md har en begrensning for plattform eller påkrevde verktøyÅpne SKILL.md og kontroller feltene platforms og requires_*
En ny versjon av skillen ble ikke hentet etter oppdateringenDu endret filen lokalt, og Hermes bevarer endringene dineHvis du trenger originalen, bruker du update name --force for en skill fra huben eller reset --restore for en innebygd skill; hvis din egen versjon er viktigere, gjør du ingenting
Skills fra et annet repositorium lastes ikke innRepositoriet må være merket som betroddKjør hermes skills trust inne i repositoriet

Hermes finner skills i mappene .hermes/skills/ og .agents/skills/ inne i et Git-repositorium. Før de lastes inn, må du merke repositoriet som betrodd: Disse filene inneholder instruksjoner agenten vil følge. Etter det fungerer skills fra repositoriet bare der og gjennomgår den samme sikkerhetskontrollen. Du trenger bare å merke repositoriet som betrodd én gang.

Hva bør du gjøre først?

Hovedpoeng

Installer én ferdig skill fra katalogen; det tar bare én kommando. Gi deretter en instruksjon du gjentar, til /learn, og kontroller resultatet med en ekte oppgave fra arbeidet ditt.

Les videre om hvordan du kobler Hermes Agent til Telegram, slik at du kan kalle skills fra telefonen, og hvordan du holder en agent i gang på en server døgnet rundt hvis du vil bruke planlagte skills. Hvis du velger agent, kan du se sammenligningen OpenClaw eller Hermes Agent.

Du kan fortsette å utforske Ailoot på ailoot.ai.

Flere detaljer

Spørsmål om denne veiledningen: Hermes Agent-skills: installering og oppretting av din egen skill

Hvorfor vises ikke en installert skill som slash-kommando?

Kontroller installert skill-liste, SKILL.md-filnavn og name-felt samt aktiv profils skills-mappe. Plattform-, verktøy- eller repositorytillitsbegrensninger kan også hindre lasting.

Verifiserer en begrenset skills-røyktest alle avhengigheter?

Nei. En skills-only-test kontrollerer at agenten laster og følger instruksjonen. Kontroller nødvendige verktøy, programmer og nøkler separat, og verifiser ett avgrenset reelt resultat før full arbeidsflyt brukes.

Alle artikler