Hermes Agent Skills: instalacja i własne umiejętności

Umiejętność to zapisane instrukcje dla agenta: raz opisujesz, jak wykonać zadanie, a od tej pory Hermes stosuje te instrukcje po wywołaniu /skill-name, bez potrzeby wielokrotnego wyjaśniania. Gotową umiejętność można zainstalować jednym poleceniem, a własną utworzyć na dwa sposoby: ręcznie napisać plik SKILL.md albo użyć /learn.

Jeśli nie masz jeszcze zainstalowanego Hermesa, zacznij od przewodnika czym jest ten agent i jak go zainstalować, a potem przejdź do umiejętności.

Czym jest umiejętność w Hermes Agent?#

Prompt wpisujesz w wiadomości do agenta. Umiejętność jest zapisana w osobnym pliku, dzięki czemu Hermes może korzystać z tych instrukcji przy kolejnych zadaniach. Agent ma dostęp do listy nazw i opisów, a pełny tekst umiejętności wczytuje wtedy, gdy jest ona przydatna do zadania. Pozwala to oszczędzać miejsce w kontekście: nie wszystkie instrukcje są wczytywane jednocześnie.

Sama umiejętność nie daje agentowi nowych narzędzi ani dostępu; opisuje, jak korzystać z narzędzi, które już ma. Nową integrację z usługą zewnętrzną obsługuje MCP — to osobny temat. Jeśli zadanie wymaga precyzyjnej logiki programu, specjalnego upoważnienia albo przetwarzania strumienia zdarzeń, potrzebne są narzędzia agenta; sama umiejętność nie wystarczy.

Do standardowego zadania wybierz gotową umiejętność, jeśli jej instrukcje pasują do potrzeb, a jej źródło zostało sprawdzone. Stwórz własną, gdy chcesz zachować konkretną kolejność działań, ograniczenia i format wyniku. Użyj /learn, jeśli masz już materiały albo zakończyłeś proces i nie chcesz ręcznie pisać pliku.

Format jest otwarty i zgodny ze specyfikacją Agent Skills, dlatego umiejętności z innych katalogów zwykle działają w Hermes bez zmian formatu. Konkretna umiejętność może jednak wymagać własnych narzędzi lub kluczy. Możesz też udostępnić własną umiejętność.

Jakie umiejętności są już zainstalowane i gdzie są przechowywane?#

Folder ma następującą strukturę:

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

SKILL.md to jedyny wymagany plik. Pozostałe dodaje się w razie potrzeby: references/ na dłuższe materiały, scripts/ na programy pomocnicze, a templates/ i assets/ na szablony i pliki.

Wbudowany katalog obejmuje umiejętności do codziennych zadań: wyszukiwania GIF-ów, pracy z plikami PDF, arkuszami kalkulacyjnymi, YouTube, GitHubem i notatkami. Pełną listę wraz z opisami znajdziesz na stronie katalogu wbudowanych umiejętności. Przy każdym hermes update Hermes aktualizuje również wbudowane umiejętności, zachowując wprowadzone przez ciebie zmiany.

Jak zainstalować gotową umiejętność z katalogu?#

1. Przeszukaj katalog

   hermes skills search pdf
   

   Wyszukiwanie obejmuje wszystkie podłączone źródła. Aby wyświetlić cały katalog bez filtrowania, uruchom hermes skills browse.

2. Wyświetl kartę umiejętności

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

   Karta zawiera opis, źródło i poziom zaufania. Nie instaluj umiejętności innej osoby bez przeczytania jej karty.

3. Zainstaluj ją

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

   Hermes pobiera SKILL.md i powiązane pliki, przeprowadza kontrolę bezpieczeństwa, a następnie umieszcza wszystko w ~/.hermes/skills/. Umiejętność jest od razu dostępna jako polecenie /pdf. Jeśli wymaga dodatkowych narzędzi lub kluczy, są one wymienione w jej pliku SKILL.md, a Hermes poinformuje cię o nich podczas instalacji.

Kontrola bezpieczeństwa szuka prób wysyłania danych na zewnątrz, instrukcji wstrzykniętych dla agenta oraz poleceń, które mogłyby usunąć lub uszkodzić pliki. Źródła mają różne poziomy zaufania:

Jeśli kontrola wyświetli ostrzeżenie, możesz kontynuować instalację za pomocą flagi --force, ale najpierw przeczytaj, jakie ryzyko wykryto. Werdyktu „niebezpieczne” nie można ominąć. Sama kontrola nie gwarantuje bezpieczeństwa: przed pierwszym uruchomieniem cudzej umiejętności przeczytaj jej instrukcje i powiązane polecenia.

Jak zainstalować umiejętność z GitHuba lub linku?#

Są trzy sposoby instalacji:

# 1. Konkretna umiejętność z repozytorium GitHub (ścieżka w repozytorium znajduje się po jego nazwie)
hermes skills install anthropics/skills/skills/pdf

# 2. Bezpośredni link do SKILL.md w dowolnej witrynie (udostępnij tę umiejętność na czacie)
hermes skills install '<OFFICIAL_URL>'

# 3. Podłącz całe repozytorium jako źródło (zastąp własną nazwą właściciela i repozytorium)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

W przypadku bezpośredniego linku Hermes pobiera SKILL.md oraz tylko te pliki z podfolderów usług, o których wspomina ten plik; nie pobiera niezwiązanych plików z witryny. Link zostaje zapamiętany jako źródło, a polecenie hermes skills update później zaktualizuje umiejętność z tego samego adresu.

Oprócz GitHuba można podłączyć zewnętrzne katalogi umiejętności. Umiejętności z nich znajdziesz za pomocą tego samego polecenia hermes skills search, wskazując źródło.

Jak używać umiejętności po instalacji?#

Polecenia hermes ... wpisuj w terminalu, a wywołania /skill-name — w czacie z agentem (w tym samym terminalu, interfejsie WWW albo komunikatorze):

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

Jeśli wpiszesz /skill-name bez zadania, Hermes wczyta instrukcje i zapyta, co ma zrobić. W jednym wierszu możesz wywołać kilka umiejętności, maksymalnie pięć; pozostały tekst staje się zadaniem:

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

Jeśli regularnie używasz tych samych połączeń, możesz skorzystać z pakietów umiejętności, które w terminologii Hermesa nazywają się bundles. Polecenie hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development grupuje kilka umiejętności pod jednym krótkim poleceniem /backend-dev. Taki pakiet działa jak alias; zawarte w nim umiejętności muszą być wcześniej zainstalowane.

Polecenia ze ukośnikiem działają również w Telegramie, jeśli jest połączony gateway; konfigurację opisuje przewodnik jak połączyć Hermes Agent z Telegramem. To wygodny sposób uruchamiania umiejętności z telefonu.

Jak stworzyć własną umiejętność: co umieścić w SKILL.md?#

Możesz skopiować tę umiejętność i dostosować ją do siebie:

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

Nagłówek między potrójnymi kreskami to metadane. Najważniejsze pola to name (nazwa zapisana alfabetem łacińskim, z członami oddzielonymi łącznikami; służy do wywoływania umiejętności jako polecenia) oraz description. Agent korzysta z pola description, aby zdecydować, czy umiejętność pasuje do bieżącego zadania i czy należy ją wczytać. Jeśli opis jest niejasny, umiejętność może nie zostać wczytana wtedy, gdy będzie potrzebna.

Po nagłówku znajdują się sekcje z instrukcjami. When to Use określa, kiedy wczytać umiejętność. Procedure opisuje kolejne kroki. Pitfalls wskazuje, gdzie agent najczęściej popełnia błędy i jak ich unikać. Verification wyjaśnia, jak sprawdzić wynik. Jeśli instrukcje są długie, przenieś główną treść do plików w references/; będą wczytywane tylko wtedy, gdy będą potrzebne. Programy pomocnicze umieść w scripts/.

Jeśli umiejętność wymaga klucza API, zadeklaruj w nagłówku zmienną środowiskową za pomocą required_environment_variables; nie umieszczaj w pliku samego klucza, tylko nazwę zmiennej. Hermes poprosi o jej wartość przy pierwszym wywołaniu w lokalnym terminalu i będzie potem podawać ją automatycznie (w komunikatorach poprosi o lokalne skonfigurowanie klucza). Pola platforms, config, blueprint i inne opisano na stronie oficjalnej dokumentacji Creating Skills.

Gdy plik będzie gotowy, wykonaj następujące kroki:

1. Utwórz folder umiejętności

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

   Nazwa folderu powinna odpowiadać polu name w nagłówku.

2. Zapisz SKILL.md

   Umieść w folderze plik o nazwie SKILL.md z własnymi instrukcjami. Możesz użyć powyższego przykładu i przerobić go na potrzeby swojego zadania.

3. Wywołaj umiejętność i sprawdź jej działanie

   Wpisz /weekly-review i poproś agenta o podsumowanie swojego tygodnia. Jeśli zastosuje się do kroków zapisanych w instrukcjach, umiejętność działa.

Jak utworzyć umiejętność z istniejących materiałów za 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

Jeśli właśnie udało ci się przejść z agentem przez skomplikowany proces, poproś /learn o zapisanie go jako umiejętności, dopóki wszystkie kroki są jeszcze w rozmowie. Następnym razem Hermes powtórzy procedurę, korzystając z gotowych instrukcji.

Duże źródło, takie jak książka, specyfikacja lub archiwum dokumentów, nie zmieści się w jednym pliku. Hermes utworzy zwięzły SKILL.md z mapą tematów i przeniesie szczegóły do references/. Pliki te nie zajmują miejsca w kontekście, dopóki agent nie wczyta ich, aby odpowiedzieć na pytanie. Ponowne użycie /learn dla tego samego tematu rozszerza istniejącą umiejętność zamiast tworzyć duplikat.

Jak sprawdzić, czy umiejętność działa?#

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

To test zalecany w dokumentacji: uruchom umiejętność i sprawdź, czy agent stosuje się do instrukcji. Jeśli nie, sprawdź trzy możliwe przyczyny. Po pierwsze, nazwa folderu lub pole name w nagłówku mogą nie odpowiadać nazwie użytej do wywołania. Po drugie, opis może nie wyjaśniać, kiedy należy używać umiejętności; przeredaguj go, używając słów charakterystycznych dla samego zadania. Po trzecie, folder może nie znajdować się w ~/.hermes/skills/, przez co Hermes go nie widzi. Pamiętaj, że flaga --toolsets skills ogranicza zestaw narzędzi dostępny podczas testu: pokazuje, jak agent korzysta z instrukcji, ale nie sprawdza zależności umiejętności, takich jak zewnętrzne programy.

Polecenie hermes skills list w terminalu pokazuje dokładnie, co jest zainstalowane.

Jak aktualizować i usuwać umiejętności?#

hermes skills check      # co zmieniło się w źródłach
hermes skills update     # pobierz nowe wersje
hermes skills uninstall pdf   # usuń umiejętność z hubu

Aby usunąć umiejętność utworzoną ręcznie, skasuj jej folder z ~/.hermes/skills/. Jeśli dostosujesz umiejętność innej osoby, update pozostawi ją bez zmian: Hermes porównuje sumy kontrolne i pomija zmodyfikowane pliki, aby nie nadpisać twojej pracy. Aby przywrócić oryginał umiejętności z hubu, użyj hermes skills update name --force; w przypadku umiejętności wbudowanej użyj hermes skills reset name --restore. Oba polecenia nadpisują twoje zmiany, więc najpierw zapisz własną wersję.

Jeśli nie potrzebujesz wbudowanych umiejętności i zaśmiecają listę, polecenie hermes skills opt-out wyłączy ich dodawanie podczas aktualizacji. Polecenie opt-out --remove usunie również te umiejętności, których nie zmieniono.

Co zrobić, jeśli nie można zainstalować umiejętności albo nie działa?#

Hermes wyszukuje umiejętności w folderach .hermes/skills/ i .agents/skills/ wewnątrz repozytorium Git. Zanim je wczytasz, oznacz repozytorium jako zaufane, ponieważ pliki te zawierają instrukcje, których agent będzie przestrzegać. Potem umiejętności z tego repozytorium działają tylko w jego obrębie i przechodzą taką samą kontrolę bezpieczeństwa. Repozytorium wystarczy oznaczyć jako zaufane tylko raz.

Co zrobić najpierw?#

Kolejne artykuły na ten temat: jak połączyć Hermes Agent z Telegramem, aby wywoływać umiejętności z telefonu, oraz jak utrzymywać agenta działającego przez całą dobę na serwerze, jeśli chcesz uruchamiać umiejętności według harmonogramu. Jeśli wybierasz agenta, zobacz porównanie OpenClaw czy Hermes Agent.