Blog

Veščine Hermes Agent: namestitev in ustvarjanje lastne veščine

Markdown

Imeniki in GitHub, format SKILL.md, /learn ter preverjanje, posodabljanje in odstranjevanje veščin Hermes Agent s celotnimi primeri ukazov.

Preberi celoten članek

Veščina je shranjeno navodilo za agenta: enkrat opišete, kako naj opravi nalogo, Hermes pa ga nato uporabi, ko pokličete /skill-name, brez ponavljajočih se pojasnil. Pripravljeno veščino lahko namestite z enim ukazom, svojo pa ustvarite na dva načina: ročno napišete SKILL.md ali uporabite /learn.

Če Hermesa še niste namestili, začnite z vodnikom kaj je ta agent in kako ga namestiti, nato pa nadaljujte z veščinami.

Praktična navodila za uporabo Ailoota so v dokumentaciji.

Kaj je veščina v Hermes Agent?

Ključna ugotovitev

Veščina je datoteka z navodili za agenta: kaj naj naredi, katere ukaze naj uporabi, na kaj naj bo pozoren in kje pogosto pride do napak. Shranjena je v mapi ~/.hermes/skills/ kot datoteka SKILL.md, skupaj z morebitnimi spremljevalnimi gradivi. Po namestitvi veščina samodejno postane ukaz /name v katerem koli klepetu z agentom.

V sporočilu agentu napišete prompt. Veščina je shranjena v ločeni datoteki, Hermes pa lahko to navodilo uporabi pri prihodnjih nalogah. Agent ima dostop do seznama imen in opisov, celotno besedilo veščine pa naloži, ko je pomembno za nalogo. Tako prihranite prostor v kontekstu: vsa navodila se ne naložijo hkrati.

Sama veščina agentu ne daje novih orodij ali dostopa; opisuje, kako naj uporabi orodja, ki jih že ima. Za novo integracijo z zunanjo storitvijo poskrbi MCP, kar je ločena tema. Če naloga zahteva natančno programsko logiko, posebno pooblastilo ali obdelavo toka dogodkov, potrebuje orodja agenta; sama veščina ne zadostuje.

Za standardno nalogo izberite pripravljeno veščino, če so njena navodila ustrezna in ste preverili njen vir. Svojo ustvarite, kadar želite ohraniti določen vrstni red dejanj, omejitve in obliko izhoda. /learn uporabite, če že imate gradivo ali ste že izvedli postopek in datoteke ne želite pisati ročno.

Veščine so dokumenti z informacijami, ki jih agent potrebuje in jih naloži le, ko jih potrebuje.

— Dokumentacija Hermes Agent (prevedeno iz angleščine), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills

Format je odprt in združljiv s specifikacijo Agent Skills, zato veščine iz drugih katalogov v Hermesu običajno delujejo brez sprememb formata, čeprav posamezna veščina morda potrebuje svoja orodja ali ključe. Če želite, lahko delite tudi svojo veščino.

Katere veščine so že nameščene in kje so shranjene?

Ključna ugotovitev

Veščine so privzeto shranjene v mapi ~/.hermes/skills/, razvrščene v podmape po kategorijah (če uporabljate nestandardni profil ali spremenljivko HERMES_HOME, bo pot drugačna; prikaže jo hermes config path). Po namestitvi Hermes že vključuje več deset vgrajenih veščin, od iskanja po arXiv do dela z GitHubom in dokumenti. Ukaz hermes skills list prikaže seznam, agenta pa lahko v klepetu vprašate, katere veščine ima.

Mapa je organizirana takole:

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

SKILL.md je edina obvezna datoteka. Vse drugo dodate po potrebi: references/ za daljša gradiva, scripts/ za pomožne programe ter templates/ in assets/ za predloge in datoteke.

Vgrajeni katalog vključuje veščine za vsakodnevna opravila: iskanje GIF-ov, delo z datotekami PDF, preglednicami, YouTubom, GitHubom in zapiski. Celoten seznam z opisi je na strani katalog vgrajenih veščin. Hermes z vsakim hermes update posodobi tudi vgrajene veščine, pri tem pa ohrani vaše spremembe.

Kako namestiti pripravljeno veščino iz kataloga?

Ključna ugotovitev

Katalog odprite z hermes skills browse, poiščite, kar potrebujete, z hermes skills search, oglejte si kartico veščine z hermes skills inspect in jo namestite z hermes skills install. Vsaka veščina pred namestitvijo prestane varnostno preverjanje, pri uradnih veščinah pa se opozorilo o viru tretje osebe ne prikaže.

  1. Poiščite veščino v katalogu

    hermes skills search pdf
    

    Iskanje poteka po vseh povezanih virih. Celoten katalog brez filtra prikažete z ukazom hermes skills browse.

  2. Oglejte si kartico veščine

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

    Kartica prikazuje opis, vir in stopnjo zaupanja. Veščine drugega avtorja ne namestite, ne da bi prej prebrali njeno kartico.

  3. Namestite jo

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

    Hermes prenese SKILL.md in spremljevalne datoteke, opravi varnostno preverjanje in vse shrani v ~/.hermes/skills/. Veščina je takoj na voljo kot ukaz /pdf. Če potrebuje dodatna orodja ali ključe, so navedeni v njenem SKILL.md, Hermes pa vas o njih obvesti med namestitvijo.

Varnostno preverjanje išče poskuse pošiljanja podatkov navzven, vstavljena navodila za agenta ter ukaze, ki bi lahko izbrisali ali poškodovali datoteke. Viri imajo različne stopnje zaupanja:

StopnjaVir veščineKaj se zgodi med namestitvijo
VgrajenaPriložena HermesuŽe je na voljo; namestitev ni potrebna
UradnaMapa optional-skills v repozitoriju HermesNamesti se brez opozorila o viru tretje osebe: hermes skills install official/security/1password
Zaupanja vrednaRepozitoriji openai/skills, anthropics/skills, huggingface/skills in NVIDIA/skillsManj strogo preverjanje
DrugaKatalogi, repozitoriji GitHub drugih avtorjev, neposredne povezaveOpozorilo in celotno preverjanje

Če preverjanje izda opozorilo, lahko namestitev nadaljujete z zastavico --force, vendar prej preberite, kakšno tveganje je bilo ugotovljeno. Ocene »dangerous« ni mogoče obiti. Samo preverjanje ne zagotavlja varnosti: preden prvič zaženete veščino drugega avtorja, preberite njena navodila in spremljevalne ukaze.

Kako namestiti veščino z GitHuba ali povezave?

Ključna ugotovitev

Veščino z GitHuba namestite z ukazom hermes skills install owner/repository/path ali uporabite neposredno povezavo do datoteke SKILL.md; Hermes bo prenesel tudi spremljevalne datoteke. Svoj vir veščin lahko povežete z hermes skills tap add, nato pa deluje kot kateri koli drug katalog.

Veščino lahko namestite na tri načine:

# 1. Določena veščina iz repozitorija GitHub (pot znotraj repozitorija sledi njegovemu imenu)
hermes skills install anthropics/skills/skills/pdf

# 2. Neposredna povezava do datoteke SKILL.md na katerem koli spletnem mestu (to veščino delite v klepetu)
hermes skills install '<OFFICIAL_URL>'

# 3. Povežite celoten repozitorij kot vir (zamenjajte z lastnikom in repozitorijem)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Pri neposredni povezavi Hermes prenese SKILL.md in samo datoteke iz podmap storitve, ki so omenjene v njem; nepovezanih datotek s spletnega mesta ne prenese. Povezavo si zapomni kot vir, zato bo hermes skills update pozneje posodobil veščino z istega naslova.

Poleg GitHuba so lahko povezani tudi zunanji katalogi veščin. Veščine iz njih poiščete z istim ukazom hermes skills search, pri čemer navedete vir.

Pozor

GitHub omejuje neavtenticirane zahteve na 60 na uro. Če se pri nameščanju ali iskanju prikaže napaka zaradi omejitve hitrosti, dodajte GITHUB_TOKEN v datoteko ~/.hermes/.env; omejitev se bo povečala na 5000 zahtev na uro.

Kako uporabljati veščino po namestitvi?

Ključna ugotovitev

Nameščena veščina samodejno postane ukaz: vnesite /skill-name in nalogo v isto vrstico. Ločena aktivacija ni potrebna. Deluje v terminalu, spletnem vmesniku in sporočilnikih prek prehoda. V enem sporočilu lahko pokličete do pet veščin ali pa pogosto uporabljeno kombinacijo združite v en ukaz.

Ukaze hermes ... vnesite v terminal, klice /skill-name pa v klepet z agentom (v istem terminalu, spletnem vmesniku ali sporočilniku):

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

Če vnesete /skill-name brez naloge, bo Hermes naložil navodila in vprašal, kaj želite, da naredi. V eni vrstici lahko pokličete več veščin, največ pet; preostalo besedilo postane naloga:

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

Za kombinacije, ki jih redno uporabljate, so na voljo paketi veščin, v Hermesovi terminologiji imenovani bundles: ukaz hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development združi več veščin pod en kratek ukaz /backend-dev. Tak paket deluje kot vzdevek; veščine v njem morajo biti predhodno nameščene.

Ukazi s poševnico delujejo tudi v Telegramu, če je prehod povezan; nastavitev je opisana v vodniku kako povezati Hermes Agent s Telegramom. To je tudi priročen način za zagon veščin s telefona.

Kako ustvariti svojo veščino: kaj sodi v SKILL.md?

Ključna ugotovitev

Vaša veščina je mapa v ~/.hermes/skills/ z eno obvezno datoteko, SKILL.md: kratko glavo z imenom in opisom, ki ji sledijo navodila, razdeljena na odseke—kdaj jo uporabiti, zaporedje dejanj, pogoste napake in preverjanje. Zapisana je v navadnem besedilu; programiranje ni potrebno. Za preprosto različico zadostujeta ena mapa in ena datoteka.

Veščine so glavni način dodajanja novih zmožnosti Hermes Agentu: lažje jih je ustvariti kot orodja, ne zahtevajo sprememb kode agenta in jih je mogoče deliti s skupnostjo.

— Dokumentacija Hermes Agent (prevedeno iz angleščine), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills

To veščino lahko kopirate in prilagodite:

---
name: weekly-review
description: Tedenski pregled: kaj je bilo opravljeno, kaj je zastalo, načrt za naslednji teden
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Tedenski pregled

## Kdaj uporabiti
Ko uporabnik prosi za pregled tedna ali pripravo načrta za naslednji teden.

## Postopek
1. Pridobi seznam opravil za ta teden iz datoteke, ki jo je posredoval uporabnik, ali ga prosi zanj.
2. Razvrsti opravila v tri skupine: opravljeno, zastalo in novo.
3. Določi tri prednostne naloge za prihodnji teden.

## Pasti
- Ne izmišljaj si opravil, ki niso na izvirnem seznamu.

## Preverjanje
Prosi uporabnika, naj potrdi, da so opravila pravilno razvrščena med »opravljeno«, »zastalo« in »novo«.

Glava med trojnimi pomišljaji vsebuje metapodatke. Glavni polji sta name (zapisano z latiničnimi črkami, ločenimi z vezaji, uporablja pa se za klic veščine kot ukaza) in description. Agent na podlagi polja z opisom presodi, ali veščina ustreza trenutni nalogi in ali jo mora naložiti. Če je opis nejasen, se veščina morda ne bo naložila, ko jo boste potrebovali.

Glavi sledijo razdelki z navodili. When to Use pove, kdaj naložiti veščino. Procedure poda korake. Pitfalls obravnava pogoste napake agenta in kako se jim izogniti. Verification pojasni, kako preveriti rezultat. Če so navodila dolga, glavno vsebino premaknite v datoteke v references/; naložene bodo samo po potrebi, pomožne programe pa shranite v scripts/.

Nasvet

Najpogostejši scenarij postavite na začetek, redke primere pa na konec datoteke. Hermes bere veščino od vrha navzdol, tak vrstni red pa prihrani prostor v kontekstu.

Če veščina potrebuje ključ API, ga navedite v glavi s poljem required_environment_variables; samega ključa ne vnašajte v datoteko, navedite samo ime spremenljivke. Hermes bo vrednost prvič zahteval ob prvem klicu v lokalnem terminalu, nato pa jo samodejno posredoval (v sporočilnikih vas bo pozval, da ključ nastavite lokalno). Polja platforms, config, blueprint in druga so opisana na uradni dokumentacijski strani Ustvarjanje veščin.

Ko je datoteka pripravljena, sledite tem korakom:

  1. Ustvarite mapo veščine

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

    Ime mape naj se ujema s poljem name v glavi.

  2. Shranite SKILL.md

    V mapo shranite datoteko z imenom SKILL.md, ki vsebuje vaša navodila; uporabite lahko zgornji primer in ga prilagodite svoji nalogi.

  3. Pokličite veščino in jo preverite

    Vnesite /weekly-review in prosite agenta, naj pregleda vaš teden. Če sledi korakom v vaših navodilih, veščina deluje.

Kako ustvariti veščino iz obstoječega gradiva z /learn?

Ključna ugotovitev

Ukaz /learn iz obstoječega gradiva izdela veščino: posredujte mu mapo z dokumentacijo, povezavo do strani, svoje zapiske ali ustni opis postopka, Hermes pa bo pripravil SKILL.md v skladu s sprejetimi konvencijami, da ga pregledate. Iz knjige ali velikega arhiva bo nastala veščina z ločenimi datotekami za posamezne teme.

/learn dokumentacija za predstavitveni API v ~/projects/example-docs, zlasti razdelek o preverjanju pristnosti
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn kako sem pravkar objavil spletno mesto na gostovanju

Če ste z agentom pravkar opravili zapleten postopek, ga prosite z /learn, naj ga shrani kot veščino, dokler so vsi koraki še v pogovoru. Naslednjič bo Hermes postopek ponovil na podlagi pripravljenih navodil.

Velik vir, kot so knjiga, specifikacija ali arhiv dokumentov, ne bo ustrezal eni sami datoteki. Hermes bo ustvaril zgoščen SKILL.md z zemljevidom tem, podrobnosti pa premaknil v references/. Te datoteke ne zasedajo prostora v kontekstu, dokler jih agent ne naloži za odgovor na vprašanje. Če /learn znova pokličete za isto temo, bo vsebino dodal obstoječi veščini, namesto da bi ustvaril dvojnik.

Kako preveriti, ali veščina deluje?

Ključna ugotovitev

Za preverjanje zaženite hermes chat --toolsets skills -q in podajte zahtevo, povezano z veščino, na primer prosite agenta, naj pregleda teden na podlagi seznama opravil. Če agent razvrsti opravila v skupine iz vaših navodil, veščina deluje. Če odgovori kot običajno, preverite ime datoteke, opis v glavi in lokacijo mape.

hermes chat --toolsets skills -q "preglej moj teden z veščino weekly-review: opravljeno - poročilo in klici, zastalo - plačilo gostovanja"

To je preizkus, ki ga priporoča dokumentacija: zaženite veščino in preverite, ali agent upošteva vaša navodila. Če jih ne, preverite tri možne vzroke. Prvič, ime mape ali name v glavi se morda ne ujema z imenom, ki ga pokličete. Drugič, opis morda ne pojasnjuje jasno, kdaj je treba veščino uporabiti; preoblikujte ga z besedami same naloge. Tretjič, mapa morda ni v ~/.hermes/skills/, zato je Hermes ne vidi. Upoštevajte, da zastavica --toolsets skills omeji nabor orodij za preizkus: pokaže, kako agent deluje z navodilom, ne preveri pa odvisnosti veščine, kot so zunanji programi.

Ukaz hermes skills list v terminalu natančno prikaže, kaj je nameščeno.

Veščine so del klona umetne inteligence: način, da enkrat zabeležite, kako opravite nalogo, agent pa jo nato lahko ponovi brez opomnikov. Kombinacija vključuje klon umetne inteligence + Second Brain + Context Engineering. Pomaga prenesti vašo delovno logiko in kontekst naloge na agenta.

Kako posodabljati in odstraniti veščine?

Ključna ugotovitev

hermes skills check prikaže, katere nameščene veščine so bile posodobljene pri viru, hermes skills update prenese nove različice, hermes skills uninstall name pa odstrani veščino. Vaše spremembe veščine drugega avtorja se med posodobitvami ohranijo: Hermes preskoči spremenjene datoteke. Izvirnik lahko obnovite: za veščino iz središča uporabite hermes skills update name --force, za vgrajeno veščino pa hermes skills reset name --restore.

hermes skills check      # kaj se je spremenilo v virih
hermes skills update     # prenesi nove različice
hermes skills uninstall pdf   # odstrani veščino iz središča

Če želite odstraniti veščino, ki ste jo ustvarili ročno, izbrišite njeno mapo iz ~/.hermes/skills/. Če ste prilagodili veščino drugega avtorja, je update ne bo spremenil: Hermes primerja zgoščene vrednosti in preskoči spremenjene datoteke, da ne bi prepisal vašega dela. Za obnovitev izvirnika veščine iz središča uporabite hermes skills update name --force, za vgrajeno veščino pa hermes skills reset name --restore. Oba ukaza prepišeta vaše spremembe, zato najprej shranite svojo različico.

Če vgrajenih veščin ne potrebujete in vam polnijo seznam, bo hermes skills opt-out onemogočil njihovo dodajanje med posodobitvami. Ukaz opt-out --remove bo odstranil tudi tiste, ki jih niste spremenili.

Kaj storiti, če se veščina ne namesti ali ne deluje?

Ključna ugotovitev

Najpogosteje težave povzročajo tri stvari: GitHubova omejitev 60 zahtev na uro, blokirana namestitev zaradi varnostnega preverjanja in datoteka v napačni mapi. Če dosežete omejitev hitrosti, dodajte GITHUB_TOKEN. Če je preverjanje blokiralo namestitev, preberite njegovo oceno. Če Hermes veščine ne najde, preverite, ali je v ~/.hermes/skills/.

SimptomVzrokKaj storiti
Napake omejitve hitrosti med iskanjem ali nameščanjemBrez žetona GitHub dovoljuje največ 60 zahtev na uroDodajte GITHUB_TOKEN v ~/.hermes/.env
Namestitev je blokiranaPreverjanje je našlo tveganje v kodi veščinePreberite rezultat preverjanja med namestitvijo; nameščeno veščino znova preverite z ukazom hermes skills audit. Če gre za opozorilo, lahko nadaljujete z --force; pri oceni »dangerous« ne morete
Veščina je nameščena, vendar /name ne delujeIme se ne ujema ali pa je mapa na napačnem mestuZaženite hermes skills list in preverite mapo ~/.hermes/skills/
Veščine sploh ni na seznamuSKILL.md vsebuje omejitev platforme ali zahtevanih orodijOdprite SKILL.md ter preverite polji platforms in requires_*
Po posodobitvi ni bila pridobljena nova različica veščineDatoteko ste spremenili lokalno, Hermes pa ohranja vaše spremembeČe potrebujete izvirnik, uporabite update name --force za veščino iz središča ali reset --restore za vgrajeno; če je pomembnejša vaša različica, ne storite ničesar
Veščine iz drugega repozitorija se ne naložijoRepozitorij mora biti označen kot zaupanja vredenZnotraj repozitorija zaženite hermes skills trust

Hermes išče veščine v mapah .hermes/skills/ in .agents/skills/ znotraj repozitorija git. Preden jih naložite, morate repozitorij označiti kot zaupanja vreden: te datoteke vsebujejo navodila, ki jim bo agent sledil. Nato veščine iz repozitorija delujejo samo znotraj njega in prestanejo enako varnostno preverjanje. Repozitorij morate kot zaupanja vreden označiti samo enkrat.

Kaj storiti najprej?

Ključna ugotovitev

Namestite eno pripravljeno veščino iz kataloga; namestitev zahteva le en ukaz. Nato vzemite navodilo, ki ga pogosto ponavljate, ga posredujte ukazu /learn in rezultat preverite na resnični nalogi iz svojega dela.

Naslednji vsebini na to temo: kako povezati Hermes Agent s Telegramom, da boste lahko veščine klicali s telefona, in kako ohraniti agenta neprekinjeno delujočega na strežniku, če želite načrtovane veščine. Če izbirate agenta, si oglejte primerjavo OpenClaw ali Hermes Agent.

Raziskovanje Ailoota lahko nadaljujete na ailoot.ai.

Več podrobnosti

Vprašanja in odgovori: Veščine Hermes Agent: namestitev in ustvarjanje lastne veščine

Zakaj nameščena spretnost ni ukaz s poševnico?

Preverite seznam nameščenih spretnosti, ime datoteke SKILL.md in polje name ter mapo spretnosti aktivnega profila. Nalaganje lahko preprečijo tudi omejitve platforme, potrebnih orodij ali zaupanja repozitoriju.

Ali omejeni preizkus spretnosti preveri vse odvisnosti?

Ne. Preizkus samo spretnosti preverja nalaganje in upoštevanje navodil. Potrebna orodja, programe in ključe preverite posebej, nato pred celotnim potekom potrdite en omejen resničen rezultat.

Vsi članki