Zručnosti Hermes Agent: Inštalácia a vytvorenie vlastnej zručnosti

Zručnosť je uložený pokyn pre agenta: raz opíšete, ako vykonať úlohu, a Hermes ho potom použije, keď zavoláte /skill-name, bez potreby opakovaných vysvetlení. Hotovú zručnosť možno nainštalovať jedným príkazom a vlastnú si môžete vytvoriť dvoma spôsobmi: napísať SKILL.md ručne alebo použiť /learn.

Ak ste Hermes ešte nenainštalovali, začnite sprievodcom čo je tento agent a ako ho nainštalovať a potom pokračujte zručnosťami.

Čo je zručnosť v Hermes Agent?#

Agentovi napíšete prompt v správe. Zručnosť sa uloží do samostatného súboru a Hermes môže tento pokyn použiť pri budúcich úlohách. Agent má prístup k zoznamu názvov a opisov a celý text zručnosti načíta, keď je pre danú úlohu relevantná. Šetrí sa tým miesto v kontexte: nenačítajú sa naraz všetky pokyny.

Samotná zručnosť agentovi neposkytuje nové nástroje ani prístup; opisuje, ako používať nástroje, ktoré už má. Nová integrácia s externou službou sa rieši cez MCP, čo je samostatná téma. Ak úloha vyžaduje presnú programovú logiku, osobitné oprávnenie alebo spracovanie prúdu udalostí, potrebuje nástroje agenta; samotná zručnosť nestačí.

Na štandardnú úlohu si vyberte hotovú zručnosť, ak jej pokyny vyhovujú a overili ste jej zdroj. Vlastnú si napíšte, keď potrebujete zachovať svoj konkrétny postup, obmedzenia a formát výstupu. Použite /learn, keď už máte materiály alebo ste dokončili postup a nechcete súbor písať ručne.

Formát je otvorený a kompatibilný so špecifikáciou Agent Skills, takže zručnosti z iných katalógov zvyčajne fungujú v Hermes bez úprav formátu, hoci konkrétna zručnosť môže vyžadovať vlastné nástroje alebo kľúče. Ak chcete, môžete svoju zručnosť aj zdieľať.

Ktoré zručnosti sú už nainštalované a kde sa ukladajú?#

Priečinok je usporiadaný takto:

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

SKILL.md je jediný povinný súbor. Všetko ostatné sa pridáva podľa potreby: references/ pre rozsiahlejšie materiály, scripts/ pre pomocné programy a templates/ a assets/ pre šablóny a súbory.

Vstavaný katalóg obsahuje zručnosti na každodenné úlohy: vyhľadávanie GIFov, prácu s PDF, tabuľkami, YouTube, GitHubom a poznámkami. Úplný zoznam s opismi nájdete na stránke katalóg vstavaných zručností. Pri každom hermes update Hermes aktualizuje aj vstavané zručnosti a zachová vaše úpravy.

Ako nainštalovať hotovú zručnosť z katalógu?#

1. Vyhľadajte zručnosť v katalógu

   hermes skills search pdf
   

   Vyhľadávanie prebieha vo všetkých pripojených zdrojoch. Ak chcete zobraziť celý katalóg bez filtra, spustite hermes skills browse.

2. Zobrazte kartu zručnosti

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

   Karta zobrazuje opis, zdroj a úroveň dôveryhodnosti. Neinštalujte zručnosť niekoho iného bez toho, aby ste si prečítali jej kartu.

3. Nainštalujte ju

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

   Hermes stiahne SKILL.md a sprievodné súbory, vykoná bezpečnostnú kontrolu a uloží všetko do ~/.hermes/skills/. Zručnosť je okamžite dostupná ako príkaz /pdf. Ak potrebuje ďalšie nástroje alebo kľúče, sú uvedené v jej SKILL.md a Hermes vás na ne upozorní počas inštalácie.

Bezpečnostná kontrola hľadá pokusy o odosielanie údajov mimo systému, vložené pokyny pre agenta a príkazy, ktoré by mohli odstrániť alebo poškodiť súbory. Zdroje majú rôzne úrovne dôveryhodnosti:

Ak kontrola zobrazí upozornenie, môžete v inštalácii pokračovať pomocou príznaku --force, najprv si však prečítajte, aké riziko zistila. Verdikt „dangerous“ nemožno obísť. Samotná kontrola nezaručuje bezpečnosť: pred prvým spustením cudzej zručnosti si prečítajte jej pokyny a sprievodné príkazy.

Ako nainštalovať zručnosť z GitHubu alebo z odkazu?#

Tri spôsoby inštalácie:

# 1. Konkrétna zručnosť z repozitára GitHubu (cesta v repozitári nasleduje po jeho názve)
hermes skills install anthropics/skills/skills/pdf

# 2. Priamy odkaz na SKILL.md na ľubovoľnej stránke (zdieľajte túto zručnosť v chate)
hermes skills install '<OFFICIAL_URL>'

# 3. Pripojenie celého repozitára ako zdroja (nahraďte vlastníkom a názvom svojho repozitára)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Pri priamom odkaze Hermes stiahne SKILL.md a iba súbory z podpriečinkov služby, ktoré sú v ňom uvedené; nesťahuje nesúvisiace súbory z webovej stránky. Odkaz si zapamätá ako zdroj a príkaz hermes skills update neskôr zručnosť aktualizuje z tej istej adresy.

Okrem GitHubu možno pripojiť aj externé katalógy zručností. Zručnosti z nich nájdete rovnakým príkazom hermes skills search a určíte zdroj.

Ako používať zručnosť po inštalácii?#

Príkazy hermes ... zadávajte v termináli a volania /skill-name v chate s agentom (v tom istom termináli, webovom rozhraní alebo aplikácii na posielanie správ):

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

Ak zadáte /skill-name bez úlohy, Hermes načíta pokyny a opýta sa, čo má urobiť. Na jednom riadku môžete vyvolať viacero zručností, najviac päť; zvyšný text bude úlohou:

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

Pre kombinácie, ktoré používate pravidelne, existujú balíky zručností, v terminológii Hermes nazývané bundles: príkaz hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development zoskupí viacero zručností pod jeden krátky príkaz /backend-dev. Takýto balík funguje ako alias; zručnosti v ňom musia byť najprv nainštalované.

Príkazy so lomkou fungujú aj v Telegrame, ak je pripojená brána; nastavenie opisuje sprievodca ako pripojiť Hermes Agent k Telegramu. Je to aj praktický spôsob, ako spúšťať zručnosti z telefónu.

Ako vytvoriť vlastnú zručnosť: čo patrí do SKILL.md?#

Túto zručnosť môžete skopírovať a prispôsobiť si ju:

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

Hlavička medzi tromi pomlčkami obsahuje metadáta. Hlavné polia sú name (píše sa latinkou, slová sa oddeľujú pomlčkami a používa sa na vyvolanie zručnosti ako príkazu) a description. Agent používa pole opisu na rozhodnutie, či zručnosť vyhovuje aktuálnej úlohe a má sa načítať. Ak je opis nejasný, zručnosť sa nemusí načítať, keď ju potrebujete.

Za hlavičkou nasledujú sekcie s pokynmi. Sekcia When to Use uvádza, kedy načítať zručnosť. Procedure uvádza jednotlivé kroky. Pitfalls opisuje, kde agent často robí chyby a ako sa im vyhnúť. Verification vysvetľuje, ako skontrolovať výsledok. Ak sú pokyny dlhé, presuňte hlavný obsah do súborov v references/; načítajú sa až vtedy, keď ich agent potrebuje, a pomocné programy umiestnite do scripts/.

Ak zručnosť potrebuje kľúč API, uveďte ho v hlavičke pomocou required_environment_variables; samotný kľúč do súboru nevkladajte, uveďte iba názov premennej. Hermes si hodnotu vyžiada raz, pri prvom vyvolaní v lokálnom termináli, a potom ju bude dodávať automaticky (v aplikáciách na posielanie správ vás vyzve, aby ste kľúč nastavili lokálne). Polia platforms, config, blueprint a ďalšie opisuje oficiálna dokumentácia na stránke Creating Skills.

Keď je súbor pripravený, postupujte takto:

1. Vytvorte priečinok zručnosti

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

   Názov priečinka zodpovedá poľu name v hlavičke.

2. Uložte SKILL.md

   Do priečinka vložte súbor s názvom SKILL.md obsahujúci vaše pokyny; môžete použiť vyššie uvedený príklad a upraviť ho pre svoju úlohu.

3. Zavolajte zručnosť a skontrolujte ju

   Zadajte /weekly-review a požiadajte agenta, aby zhodnotil váš týždeň. Ak postupuje podľa pokynov, zručnosť funguje.

Ako vytvoriť zručnosť z existujúcich materiálov pomocou /learn?#

/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

Ak ste práve dokončili zložitý postup s agentom, požiadajte /learn, aby ho uložil ako zručnosť, kým sú všetky kroky ešte v konverzácii. Nabudúce Hermes zopakuje postup podľa pripravených pokynov.

Rozsiahly zdroj, napríklad kniha, špecifikácia alebo archív dokumentov, sa nezmestí do jedného súboru. Hermes vytvorí stručný SKILL.md s mapou tém a podrobnosti presunie do references/. Tieto súbory nezaberajú miesto v kontexte, kým ich agent nenačíta pri odpovedi na otázku. Opätovné použitie /learn na tú istú tému doplní existujúcu zručnosť namiesto vytvorenia duplikátu.

Ako overiť, že zručnosť funguje?#

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

Toto je test, ktorý odporúča dokumentácia: spustite zručnosť a skontrolujte, či agent dodržiava vaše pokyny. Ak ich nedodržiava, overte tri možné príčiny. Po prvé, názov priečinka alebo hodnota name v hlavičke sa nemusí zhodovať s názvom, ktorý vyvolávate. Po druhé, opis nemusí jasne uvádzať, kedy sa má zručnosť použiť; prepíšte ho slovami, ktoré opisujú samotnú úlohu. Po tretie, priečinok nemusí byť v ~/.hermes/skills/, takže ho Hermes nevidí. Príznak --toolsets skills obmedzuje sadu nástrojov testu: ukáže, ako agent pracuje s pokynom, ale neoverí závislosti zručnosti, napríklad externé programy.

Príkaz hermes skills list v termináli presne zobrazí, čo je nainštalované.

Zručnosti sú súčasťou klonu umelej inteligencie: umožňujú raz zaznamenať, ako vykonávate úlohu, aby ju agent mohol zopakovať bez pripomínania. Táto kombinácia zahŕňa klon umelej inteligencie + Druhý mozog + Inžinierstvo kontextu. Pomáha agentovi odovzdať logiku vašej práce a kontext úlohy.

Ako aktualizovať a odstraňovať zručnosti?#

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

Ak chcete odstrániť zručnosť, ktorú ste vytvorili ručne, vymažte jej priečinok z ~/.hermes/skills/. Ak ste upravili zručnosť niekoho iného, príkaz update ju ponechá nedotknutú: Hermes porovnáva kontrolné súčty a preskakuje zmenené súbory, aby neprepísal vašu prácu. Pôvodnú verziu zručnosti z hubu obnovíte príkazom hermes skills update name --force; pri vstavanej zručnosti použite hermes skills reset name --restore. Oba príkazy prepíšu vaše zmeny, preto si najprv uložte svoju verziu.

Ak vstavané zručnosti nepotrebujete a zapĺňajú zoznam, príkaz hermes skills opt-out vypne ich pridávanie počas aktualizácií. Príkaz opt-out --remove odstráni aj tie, ktoré ste nezmenili.

Čo robiť, ak sa zručnosť nedá nainštalovať alebo nefunguje?#

Hermes vyhľadáva zručnosti v priečinkoch .hermes/skills/ a .agents/skills/ vnútri gitového repozitára. Pred načítaním musíte repozitár označiť ako dôveryhodný: tieto súbory obsahujú pokyny, ktorými sa agent bude riadiť. Potom zručnosti z repozitára fungujú iba v jeho rámci a prechádzajú rovnakou bezpečnostnou kontrolou. Repozitár stačí označiť ako dôveryhodný raz.

Čo urobiť ako prvé?#

Ďalej k tejto téme: ako pripojiť Hermes Agent k Telegramu, aby ste mohli vyvolávať zručnosti z telefónu, a ako nechať agenta nepretržite bežať na serveri, ak chcete plánované zručnosti. Ak si vyberáte agenta, pozrite si porovnanie OpenClaw alebo Hermes Agent.