# Dovednosti Hermes Agentu: instalace a tvorba vlastní dovednosti > Adresáře a GitHub, formát SKILL.md, příkaz /learn, kontrola, aktualizace a odebírání dovedností Hermes Agentu včetně úplných příkladů příkazů. Source: https://ailoot.ai/blog/cs/hermes-agent-skills/ Canonical: https://ailoot.ai/blog/cs/hermes-agent-skills/ Language: cs Publisher: Ailoot (https://ailoot.ai/) Translation: guide-117 Revision: sha256-c02f40b939ed105230d12af18b7497594b010d564e1d28fe6e3ac014dc91575f 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](https://ailoot.ai/blog/cs/hermes-agent-install-setup/) a pak pokračujte k dovednostem.
Praktické pokyny k používání Ailoot najdete v [dokumentaci](https://ailoot.ai/docs/).
## Co je dovednost v Hermes Agentu?
Hlavní poznatek Dovednost je soubor obsahující pokyny pro agenta: co má dělat, které příkazy použít, na co si dát pozor a kde obvykle dochází k chybám. Je uložená ve složce `~/.hermes/skills/` jako soubor SKILL.md spolu s případnými doprovodnými materiály. Po instalaci se dovednost automaticky změní na příkaz `/name`, který lze použít v kterémkoli chatu s agentem.
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ě.

Dovednosti jsou dokumenty obsahující informace, které agent potřebuje a načítá je jen tehdy, když jsou potřeba.

— Dokumentace Hermes Agent (přeloženo z angličtiny), https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
Formát je otevřený a kompatibilní se [specifikací Agent Skills](https://agentskills.io/specification), 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é?
Hlavní poznatek Dovednosti se ve výchozím nastavení ukládají do složky `~/.hermes/skills/` a řadí se do podsložek podle kategorií (pokud používáte nestandardní profil nebo proměnnou HERMES_HOME, cesta se bude lišit; zobrazí ji příkaz `hermes config path`). Po instalaci už Hermes obsahuje desítky vestavěných dovedností, od vyhledávání na arXiv po práci s GitHubem a dokumenty. Seznam zobrazí příkaz `hermes skills list`; agenta se také můžete v chatu zeptat, jaké dovednosti má k dispozici.
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í](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog). 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?
Hlavní poznatek Katalog otevřete příkazem `hermes skills browse`, potřebnou dovednost najdete pomocí `hermes skills search`, její kartu zobrazíte příkazem `hermes skills inspect` a nainstalujete ji pomocí `hermes skills install`. Každá dovednost před instalací prochází bezpečnostní kontrolou a u oficiálních dovedností se nezobrazuje upozornění na zdroj třetí strany.
1. ### Vyhledejte dovednost v katalogu ```bash 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 ```bash 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 ```bash 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: | Úroveň | Zdroj dovednosti | Co se děje při instalaci | |----|----|----| | Vestavěná | Součást Hermes | Už je k dispozici; instalace není potřeba | | Oficiální | Složka volitelných dovedností v repozitáři Hermes | Instaluje se bez upozornění na zdroj třetí strany: `hermes skills install official/security/1password` | | Důvěryhodná | Repozitáře openai/skills, anthropics/skills, huggingface/skills a NVIDIA/skills | Méně přísná kontrola | | Jiná | Katalogy, repozitáře GitHubu jiných lidí, přímé odkazy | Upozornění a úplná kontrola | 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?
Hlavní poznatek Dovednost z GitHubu nainstalujete příkazem `hermes skills install owner/repository/path` nebo použijete přímý odkaz na soubor SKILL.md; Hermes stáhne i doprovodné soubory. Vlastní zdroj dovedností můžete připojit příkazem `hermes skills tap add` a potom bude fungovat jako kterýkoli jiný katalog.
Dovednost lze nainstalovat třemi způsoby: ```bash # 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 '' # 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.
Upozornění GitHub omezuje neověřené požadavky na 60 za hodinu. Pokud při instalaci nebo vyhledávání narazíte na chybu omezení počtu požadavků, přidejte `GITHUB_TOKEN` do souboru `~/.hermes/.env`; limit se zvýší na 5000 požadavků za hodinu.
## Jak používat dovednost po instalaci?
Hlavní poznatek Nainstalovaná dovednost se automaticky změní na příkaz: napište `/skill-name` a úkol na stejný řádek. Není nutná žádná samostatná aktivace. Funguje v terminálu, webovém rozhraní i messengerech přes gateway. V jedné zprávě můžete vyvolat až pět dovedností nebo opakovaně používanou kombinaci převést na jeden příkaz.
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](https://ailoot.ai/blog/cs/hermes-agent-telegram-setup/). Je to také pohodlný způsob, jak používat dovednosti z telefonu. ## Jak vytvořit vlastní dovednost: co patří do SKILL.md?
Hlavní poznatek Vlastní dovednost je složka v `~/.hermes/skills/` s jedním povinným souborem SKILL.md: krátkou hlavičkou s názvem a popisem, po níž následují pokyny rozdělené do oddílů — kdy dovednost použít, jaký je postup, jaké jsou časté chyby a jak výsledek ověřit. Píše se prostým textem; programování není potřeba. Pro jednoduchou verzi stačí jedna složka a jeden soubor.

Dovednosti jsou hlavním způsobem, jak do Hermes Agentu přidat nové schopnosti: vytvářejí se snadněji než nástroje, nevyžadují změny kódu agenta a lze je sdílet s komunitou.

— Dokumentace Hermes Agent (přeloženo z angličtiny), https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills
Tuto dovednost můžete zkopírovat a upravit pro sebe: ```markdown --- 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/`.
Tip Nejběžnější scénář uveďte jako první a výjimečné případy až na konci souboru. Hermes čte dovednost odshora dolů a toto pořadí šetří kontext.
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](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills). Až bude soubor připravený, postupujte takto: 1. ### Vytvořte složku dovednosti ```bash 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?
Hlavní poznatek Příkaz `/learn` vytvoří dovednost z existujících materiálů: zadejte mu složku s dokumentací, odkaz na stránku, své poznámky nebo ústní popis postupu a Hermes pro vás napíše SKILL.md podle zavedených zvyklostí, abyste si jej mohli zkontrolovat. Z knihy nebo rozsáhlého archivu vytvoří dovednost se samostatnými soubory podle témat.
``` /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?
Hlavní poznatek Ověřte ji spuštěním `hermes chat --toolsets skills -q` a zadejte požadavek související s dovedností, například požádejte o zhodnocení týdne podle seznamu úkolů. Pokud agent roztřídí úkoly do skupin uvedených v pokynech, dovednost funguje. Pokud odpoví jako obvykle, zkontrolujte název souboru, popis v hlavičce a umístění složky.
```bash 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?
Hlavní poznatek Příkaz `hermes skills check` ukáže, které nainstalované dovednosti byly aktualizovány ve zdroji, `hermes skills update` stáhne nové verze a `hermes skills uninstall name` dovednost odstraní. Vaše úpravy dovednosti někoho jiného se při aktualizaci zachovají: Hermes přeskočí změněné soubory. Původní verzi můžete obnovit: u dovednosti z hubu použijte `hermes skills update name --force`; u vestavěné dovednosti `hermes skills reset name --restore`.
```bash 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?
Hlavní poznatek Nejčastěji překážejí tři věci: limit GitHubu 60 požadavků za hodinu, zablokování instalace bezpečnostní kontrolou a umístění souboru do nesprávné složky. Pokud narazíte na limit počtu požadavků, přidejte `GITHUB_TOKEN`. Pokud kontrola instalaci zablokovala, přečtěte si její verdikt. Pokud Hermes dovednost nevidí, zkontrolujte, zda je ve složce `~/.hermes/skills/`.
| Příznak | Příčina | Co dělat | |----|----|----| | Chyby omezení počtu požadavků při vyhledávání nebo instalaci | Bez tokenu GitHub povoluje až 60 požadavků za hodinu | Přidejte `GITHUB_TOKEN` do `~/.hermes/.env` | | Instalace je zablokovaná | Kontrola našla v kódu dovednosti riziko | Přečtěte si výstup kontroly během instalace; chcete-li znovu zkontrolovat nainstalovanou dovednost, spusťte `hermes skills audit`. Pokud jde o upozornění, můžete pokračovat pomocí `--force`; pokud je verdikt „dangerous“, pokračovat nelze | | Dovednost je nainstalovaná, ale `/name` nefunguje | Název neodpovídá nebo je složka na nesprávném místě | Spusťte `hermes skills list` a zkontrolujte složku `~/.hermes/skills/` | | Dovednost vůbec není v seznamu | Její SKILL.md obsahuje omezení platformy nebo požadovaných nástrojů | Otevřete SKILL.md a zkontrolujte pole `platforms` a `requires_*` | | Po aktualizaci se nenačetla nová verze dovednosti | Změnili jste soubor místně a Hermes vaše úpravy zachovává | Pokud potřebujete původní verzi, použijte `update name --force` u dovednosti z hubu nebo `reset --restore` u vestavěné; pokud je pro vás důležitější vaše verze, nedělejte nic | | Dovednosti z jiného repozitáře se nenačtou | Repozitář musí být označen jako důvěryhodný | Spusťte `hermes skills trust` uvnitř repozitáře | 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í?
Hlavní poznatek Nainstalujte jednu hotovou dovednost z katalogu; instalace vyžaduje jen jeden příkaz. Pak vezměte pokyn, který opakujete, předejte ho příkazu `/learn` a výsledek ověřte na skutečném úkolu ze své práce.
Dále k tomuto tématu: [jak připojit Hermes Agent k Telegramu](https://ailoot.ai/blog/cs/hermes-agent-telegram-setup/), abyste mohli vyvolávat dovednosti z telefonu, a [jak udržet agenta nepřetržitě spuštěného na serveru](https://ailoot.ai/blog/cs/hermes-agent-vps-24-7/), pokud chcete plánované dovednosti. Pokud vybíráte agenta, přečtěte si srovnání [OpenClaw nebo Hermes Agent](https://ailoot.ai/blog/cs/openclaw-vs-hermes-agent/).
### Zdroje - [Dokumentace Hermes Agent](https://hermes-agent.nousresearch.com/docs/) - [Systém dovedností – jak dovednosti fungují](https://hermes-agent.nousresearch.com/docs/user-guide/features/skills) - [Tvorba dovedností – jak napsat vlastní dovednost](https://hermes-agent.nousresearch.com/docs/developer-guide/creating-skills) - [Katalog vestavěných dovedností](https://hermes-agent.nousresearch.com/docs/reference/skills-catalog) - [Oficiální volitelné dovednosti](https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog) - [Repozitář Hermes Agent na GitHubu](https://github.com/NousResearch/hermes-agent) - [Otevřený standard Agent Skills](https://agentskills.io/specification)
V průzkumu Ailoot můžete pokračovat na [ailoot.ai](https://ailoot.ai/).
## Časté otázky ### Proč se nainstalovaný skill nezobrazuje jako lomítkový příkaz? Zkontrolujte seznam nainstalovaných skillů, název souboru SKILL.md, pole name a složku skills aktivního profilu. Načtení mohou bránit i omezení platformy, požadovaných nástrojů nebo důvěry v repozitář. ### Ověří omezený smoke test skillů všechny závislosti? Ne. Test samotného skillu ověřuje načtení a dodržení instrukcí agentem. Požadované nástroje, programy a klíče ověřte samostatně a před použitím celého postupu prokažte jeden vymezený skutečný výsledek. ## Ailoot · Společnost a její portfolio projektů Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI. Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách. Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.