Dovednosti Hermes Agentu: instalace a tvorba vlastní dovednosti

Dovednost je uložený pokyn pro agenta: jednou popíšete, jak úkol provést, a Hermes se jím pak řídí, když zadáte /skill-name, aniž byste museli vše opakovaně vysvětlovat. Hotovou dovednost lze nainstalovat jedním příkazem a vlastní můžete vytvořit dvěma způsoby: ručně napsat SKILL.md nebo použít /learn.

Pokud jste Hermes ještě nenainstalovali, začněte průvodcem co tento agent umí a jak ho nainstalovat a pak pokračujte k dovednostem.

Co je dovednost v Hermes Agentu?#

Agentovi napíšete zadání ve zprávě. Dovednost se uloží do samostatného souboru a Hermes může tento pokyn použít i při budoucích úkolech. Agent má k dispozici seznam názvů a popisů a celý text dovednosti načte, když se hodí pro daný úkol. Šetří to místo v kontextu: nenačítají se všechny pokyny najednou.

Dovednost sama o sobě agentovi nedává nové nástroje ani přístup; popisuje, jak používat nástroje, které už má. Nová integrace s externí službou se řeší pomocí MCP, což je samostatné téma. Pokud úkol vyžaduje přesnou programovou logiku, zvláštní oprávnění nebo zpracování proudu událostí, potřebuje agent nástroje; samotná dovednost nestačí.

Pro běžný úkol zvolte hotovou dovednost, pokud její pokyny vyhovují a ověřili jste její zdroj. Vlastní dovednost si napište, když potřebujete zachovat konkrétní pořadí kroků, omezení a formát výstupu. /learn použijte, pokud už máte podklady nebo jste dokončili určitý postup a nechcete soubor psát ručně.

Formát je otevřený a kompatibilní se specifikací Agent Skills, takže dovednosti z jiných katalogů v Hermes obvykle fungují bez změny formátu, i když konkrétní dovednost může vyžadovat vlastní nástroje nebo klíče. Pokud chcete, můžete svou dovednost také sdílet.

Které dovednosti Hermes Agentu jsou předinstalované a kde jsou uložené?#

Složky jsou uspořádané takto:

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

Jediným povinným souborem je SKILL.md. Vše ostatní se přidává podle potřeby: references/ pro delší materiály, scripts/ pro pomocné programy a templates/ a assets/ pro šablony a soubory.

Vestavěný katalog obsahuje dovednosti pro každodenní úkoly: hledání GIFů, práci s PDF, tabulkami, YouTube, GitHubem a poznámkami. Úplný seznam s popisy najdete na stránce katalog vestavěných dovedností. Při každém spuštění hermes update Hermes aktualizuje také vestavěné dovednosti a zároveň zachová vaše změny.

Jak nainstalovat hotovou dovednost z katalogu?#

1. Vyhledejte dovednost v katalogu

   hermes skills search pdf
   

   Vyhledávání prochází všechny připojené zdroje. Celý katalog bez filtru zobrazíte příkazem hermes skills browse.

2. Zobrazte kartu dovednosti

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

   Karta obsahuje popis, zdroj a úroveň důvěry. Neinstalujte dovednost někoho jiného, aniž byste si její kartu přečetli.

3. Nainstalujte dovednost

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

   Hermes stáhne SKILL.md a doprovodné soubory, provede bezpečnostní kontrolu a uloží vše do ~/.hermes/skills/. Dovednost bude okamžitě dostupná jako příkaz /pdf. Pokud vyžaduje další nástroje nebo klíče, jsou uvedené v jejím SKILL.md a Hermes vás na ně upozorní během instalace.

Bezpečnostní kontrola hledá pokusy o odesílání dat mimo systém, vložené pokyny pro agenta a příkazy, které by mohly mazat nebo poškodit soubory. Zdroje mají různé úrovně důvěry:

Pokud kontrola zobrazí upozornění, můžete v instalaci pokračovat pomocí příznaku --force, ale nejprve si přečtěte, jaké riziko odhalila. Verdikt „dangerous“ nelze obejít. Samotná kontrola bezpečnost nezaručuje: před prvním spuštěním dovednosti někoho jiného si přečtěte její pokyny a doprovodné příkazy.

Jak nainstalovat dovednost z GitHubu nebo pomocí odkazu?#

Dovednost lze nainstalovat třemi způsoby:

# 1. Konkrétní dovednost z repozitáře GitHub (cesta uvnitř repozitáře následuje za jeho názvem)
hermes skills install anthropics/skills/skills/pdf

# 2. Přímý odkaz na SKILL.md na libovolném webu (sdílejte tuto dovednost v chatu)
hermes skills install '<OFFICIAL_URL>'

# 3. Připojení celého repozitáře jako zdroje (nahraďte vlastními údaji vlastníka a repozitáře)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

U přímého odkazu Hermes stáhne SKILL.md a pouze soubory ze servisních podsložek, které jsou v něm uvedené; ostatní soubory z webu nestahuje. Odkaz si zapamatuje jako zdroj a příkaz hermes skills update později dovednost aktualizuje ze stejné adresy.

Kromě GitHubu jsou připojené také externí katalogy dovedností. Dovednosti z nich najdete stejným příkazem hermes skills search, stačí určit zdroj.

Jak používat dovednost po instalaci?#

Příkazy hermes ... zadávejte v terminálu a příkazy /skill-name v chatu s agentem (ve stejném terminálu, webovém rozhraní nebo messengeru):

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

Pokud zadáte /skill-name bez úkolu, Hermes načte pokyny a zeptá se, co má udělat. Na jednom řádku můžete vyvolat několik dovedností, nejvýše pět; zbývající text představuje úkol:

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

Pro pravidelně používané kombinace existují balíčky dovedností, kterým se v terminologii Hermes říká bundles: příkaz hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development sdruží několik dovedností pod jeden krátký příkaz /backend-dev. Takový bundle funguje jako alias; obsažené dovednosti musí být předem nainstalované.

Příkazy se lomítkem fungují také v Telegramu, pokud je připojená gateway; nastavení popisuje průvodce jak připojit Hermes Agent k Telegramu. Je to také pohodlný způsob, jak používat dovednosti z telefonu.

Jak vytvořit vlastní dovednost: co patří do SKILL.md?#

Tuto dovednost můžete zkopírovat a upravit pro sebe:

---
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 mezi třemi pomlčkami obsahuje metadata. Hlavní pole jsou name (v latince, s částmi oddělenými pomlčkami; používá se k vyvolání dovednosti jako příkazu) a description. Agent používá pole description k rozhodnutí, zda se dovednost hodí pro aktuální úkol a má se načíst. Pokud je popis neurčitý, dovednost se v potřebnou chvíli nemusí načíst.

Po hlavičce následují oddíly s pokyny. When to Use určuje, kdy dovednost načíst. Procedure uvádí jednotlivé kroky. Pitfalls popisuje, kde agent obvykle chybuje a jak tomu předejít. Verification vysvětluje, jak výsledek ověřit. Pokud jsou pokyny dlouhé, přesuňte hlavní obsah do souborů ve složce references/; načtou se jen tehdy, když budou potřeba. Pomocné programy umístěte do scripts/.

Pokud dovednost potřebuje klíč API, deklarujte ho v hlavičce pomocí required_environment_variables; samotný klíč do souboru nevkládejte, uveďte pouze název proměnné. Při prvním vyvolání v místním terminálu si Hermes jednou vyžádá hodnotu a pak ji bude dodávat automaticky (v messengerech vás vyzve, abyste klíč nastavili místně). Pole platforms, config, blueprint a další jsou popsána na oficiální stránce dokumentace Creating Skills.

Až bude soubor připravený, postupujte takto:

1. Vytvořte složku dovednosti

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

   Název složky odpovídá poli name v hlavičce.

2. Uložte SKILL.md

   Do složky vložte soubor nazvaný SKILL.md s pokyny. Můžete použít výše uvedený příklad a upravit ho pro svůj úkol.

3. Vyvolejte dovednost a ověřte ji

   Zadejte /weekly-review a požádejte agenta, aby zhodnotil váš týden. Pokud postupuje podle pokynů, dovednost funguje.

Jak vytvořit dovednost z existujících materiálů pomocí /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

Pokud jste právě s agentem dokončili složitý postup, požádejte /learn, aby ho uložil jako dovednost, dokud jsou všechny kroky ještě v konverzaci. Příště Hermes zopakuje postup podle připravených pokynů.

Rozsáhlý zdroj, například kniha, specifikace nebo archiv dokumentů, se nevejde do jednoho souboru. Hermes vytvoří stručný SKILL.md s mapou témat a podrobnosti přesune do složky references/. Tyto soubory nezabírají místo v kontextu, dokud je agent nenačte, aby odpověděl na otázku. Když znovu spustíte /learn na stejné téma, doplní existující dovednost místo toho, aby vytvořil duplicitní.

Jak ověřit, že dovednost funguje?#

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

To je test doporučený v dokumentaci: spusťte dovednost a ověřte, že agent dodržuje vaše pokyny. Pokud ne, zkontrolujte tři možné příčiny. Zaprvé, název složky nebo name v hlavičce nemusí odpovídat názvu, který zadáváte. Zadruhé, popis nemusí jasně říkat, kdy se má dovednost použít; přepište ho pomocí slov, kterými popisujete samotný úkol. Zatřetí, složka nemusí být v ~/.hermes/skills/, takže ji Hermes nevidí. Příznak --toolsets skills omezuje sadu nástrojů testu: ukazuje, jak agent pracuje s pokynem, ale nekontroluje závislosti dovednosti, například externí programy.

Příkaz hermes skills list v terminálu ukazuje přesně to, co je nainstalováno.

Jak dovednosti aktualizovat a odebrat?#

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

Chcete-li odebrat dovednost vytvořenou ručně, smažte její složku z ~/.hermes/skills/. Pokud jste upravili dovednost někoho jiného, update ji ponechá beze změny: Hermes porovnává kontrolní součty a upravené soubory přeskočí, aby nepřepsal vaši práci. Původní verzi dovednosti z hubu obnovíte příkazem hermes skills update name --force; u vestavěné dovednosti použijte hermes skills reset name --restore. Oba příkazy přepíší vaše změny, proto si nejprve uložte vlastní verzi.

Pokud vestavěné dovednosti nepotřebujete a zahlcují seznam, příkaz hermes skills opt-out zakáže jejich přidávání při aktualizacích. Příkaz opt-out --remove odstraní také ty, které jste nezměnili.

Co dělat, když se dovednost nenainstaluje nebo nefunguje?#

Hermes vyhledává dovednosti ve složkách .hermes/skills/ a .agents/skills/ uvnitř repozitáře Git. Než je načte, musíte repozitář označit jako důvěryhodný: tyto soubory obsahují pokyny, kterými se agent bude řídit. Poté dovednosti z repozitáře fungují pouze v jeho rámci a procházejí stejnou bezpečnostní kontrolou. Repozitář stačí označit jako důvěryhodný pouze jednou.

Co udělat jako první?#

Dále k tomuto tématu: jak připojit Hermes Agent k Telegramu, abyste mohli vyvolávat dovednosti z telefonu, a jak udržet agenta nepřetržitě spuštěného na serveru, pokud chcete plánované dovednosti. Pokud vybíráte agenta, přečtěte si srovnání OpenClaw nebo Hermes Agent.