Hermes Agent-képességek: képesség telepítése és saját készítése

A képesség egy elmentett utasítás az ügynök számára: egyszer leírod, hogyan végezzen el egy feladatot, Hermes pedig ezután alkalmazza, amikor meghívod a /skill-name paranccsal, így nem kell újra és újra elmagyaráznod. Egy kész képesség egyetlen paranccsal telepíthető, sajátot pedig kétféleképpen készíthetsz: kézzel megírod a SKILL.md fájlt, vagy használod a /learn parancsot.

Ha még nem telepítetted a Hermest, kezdd azzal az útmutatóval, amely bemutatja, mi ez az ügynök, és hogyan telepíthető, majd térj át a képességekre.

Mi az a képesség a Hermes Agentben?#

Az ügynöknek küldött üzenetben promptot írsz. A képesség külön fájlban van elmentve, és Hermes későbbi feladatokban is használhatja az utasítást. Az ügynök hozzáfér a nevek és leírások listájához, és akkor tölti be a képesség teljes szövegét, amikor az releváns a feladathoz. Ez helyet takarít meg a kontextusban: nem töltődik be egyszerre az összes utasítás.

Önmagában egy képesség nem ad új eszközöket vagy hozzáférést az ügynöknek; azt írja le, hogyan használja a már meglévő eszközeit. Egy külső szolgáltatással való új integrációt az MCP kezel, ami külön téma. Ha egy feladat pontos programlogikát, külön engedélyezést vagy eseményfolyam-feldolgozást igényel, akkor ügynökeszközökre van szükség; önmagában egy képesség nem elegendő.

Szabványos feladathoz válassz kész képességet, ha annak utasításai megfelelnek, és ellenőrizted a forrását. Akkor írj sajátot, ha meg kell őrizned a konkrét műveletsort, korlátozásokat és kimeneti formátumot. A /learn parancsot akkor használd, ha már vannak anyagaid, vagy elvégeztél egy folyamatot, és nem akarod kézzel megírni a fájlt.

A formátum nyílt, és kompatibilis az Agent Skills specifikációval, ezért más katalógusok képességei általában formátummódosítás nélkül működnek a Hermesben, bár egy adott képességhez szükség lehet saját eszközökre vagy kulcsokra. Saját képességedet is megoszthatod.

Milyen képességek vannak már telepítve, és hol találhatók?#

A mappa felépítése:

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

A SKILL.md az egyetlen kötelező fájl. Minden más szükség szerint kerül hozzá: a references/ mappa hosszabb anyagokhoz, a scripts/ segédprogramokhoz, a templates/ és az assets/ pedig sablonokhoz és fájlokhoz való.

A beépített katalógus hétköznapi feladatokhoz kínál képességeket: GIF-ek kereséséhez, PDF-fájlokkal, táblázatokkal, YouTube-bal, GitHubbal és jegyzetekkel való munkához. A teljes lista leírásokkal a beépített képességek katalógusa oldalon található. Minden hermes update futtatásakor a Hermes a beépített képességeket is frissíti, miközben megőrzi a módosításaidat.

Hogyan telepíthetsz kész képességet a katalógusból?#

1. Keresés a katalógusban

   hermes skills search pdf
   

   A keresés az összes csatlakoztatott forrásban fut. A teljes katalógus szűrés nélküli megjelenítéséhez futtasd a hermes skills browse parancsot.

2. A képesség adatlapjának megtekintése

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

   Az adatlap a leírást, a forrást és a megbízhatósági szintet mutatja. Ne telepíts másoktól származó képességet az adatlap elolvasása nélkül.

3. Telepítés

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

   Hermes letölti a SKILL.md fájlt és a hozzá tartozó fájlokat, biztonsági ellenőrzést futtat, majd mindent a ~/.hermes/skills/ mappába helyez. A képesség azonnal elérhetővé válik /pdf parancsként. Ha a képességhez további eszközökre vagy kulcsokra van szükség, ezeket felsorolja a SKILL.md, Hermes pedig telepítés közben tájékoztat róla.

A biztonsági ellenőrzés adatküldési kísérleteket, az ügynöknek szánt beinjektált utasításokat, valamint fájlok törlésére vagy megrongálására alkalmas parancsokat keres. A források megbízhatósági szintje eltérő:

Ha az ellenőrzés figyelmeztetést ad, a --force kapcsolóval folytathatod a telepítést, de előbb olvasd el, milyen kockázatot talált. A „dangerous” minősítés nem kerülhető meg. Maga az ellenőrzés nem garantálja a biztonságot: mielőtt először futtatnál másoktól származó képességet, olvasd el az utasításait és a hozzá tartozó parancsokat.

Hogyan telepíthetsz képességet GitHubról vagy hivatkozásból?#

Háromféleképpen telepíthetsz:

# 1. Adott képesség egy GitHub-repozitóriumból (a repozitóriumon belüli útvonal a neve után következik)
hermes skills install anthropics/skills/skills/pdf

# 2. Közvetlen hivatkozás bármely webhelyen található SKILL.md fájlra (oszd meg ezt a képességet egy csevegésben)
hermes skills install '<OFFICIAL_URL>'

# 3. Teljes repozitórium csatlakoztatása forrásként (cseréld le a tulajdonosra és a repozitóriumra)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Közvetlen hivatkozás esetén Hermes letölti a SKILL.md fájlt, valamint az abból megnevezett, szolgáltatási almappákban található fájlokat; a webhely nem kapcsolódó fájljait nem tölti le. A hivatkozást forrásként megjegyzi, és a hermes skills update később ugyanarról a címről frissíti a képességet.

A GitHub mellett külső készségkatalógusok is csatlakoztathatók. Ezekben ugyanazzal a hermes skills search paranccsal kereshetsz, a forrás megadásával.

Hogyan használj egy képességet a telepítés után?#

A hermes ... parancsokat a terminálba írd be, a /skill-name hívásokat pedig az ügynökkel folytatott csevegésbe (ugyanebben a terminálban, a webes felületen vagy egy üzenetküldőben):

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

Ha feladat nélkül írod be a /skill-name parancsot, Hermes betölti az utasításokat, és megkérdezi, mit szeretnél, hogy tegyen. Egy sorban több képességet is meghívhatsz, legfeljebb ötöt; a fennmaradó szöveg lesz a feladat:

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

A rendszeresen használt kombinációkhoz képességcsomagok is rendelkezésre állnak, amelyeket a Hermes terminológiája bundles néven említ: a hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development több képességet csoportosít egyetlen rövid /backend-dev parancs alá. Az ilyen csomag alias-ként működik; a benne lévő képességeket előbb telepíteni kell.

A perjeles parancsok Telegramon is működnek, ha a gateway csatlakoztatva van; a beállításról a Hermes Agent Telegramhoz csatlakoztatásáról szóló útmutató ír. Ez kényelmes módja annak is, hogy a telefonodról futtass képességeket.

Hogyan készíthetsz saját képességet: mi kerüljön a SKILL.md fájlba?#

Másold le ezt a képességet, majd alakítsd a saját igényeidhez:

---
name: weekly-review
description: Heti áttekintés: mi készült el, mi akadt el, terv a következő hétre
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Heti áttekintés

## Mikor használd
Amikor a felhasználó a hét áttekintését vagy a következő hét tervének összeállítását kéri.

## Eljárás
1. Kérd le a hét feladatlistáját a felhasználó által megadott fájlból, vagy kérd meg, hogy küldje el.
2. Sorold a feladatokat három csoportba: kész, elakadt és új.
3. Nevezz meg három prioritást a következő hétre.

## Buktatók
- Ne találj ki olyan feladatokat, amelyek nem szerepelnek az eredeti listában.

## Ellenőrzés
Kérd meg a felhasználót, hogy erősítse meg: a feladatok helyesen kerültek-e a „kész”, „elakadt” és „új” csoportba.

A három kötőjel közötti fejléc metaadatokat tartalmaz. A fő mezők a name (latin betűkkel, kötőjellel elválasztva írandó, és a képesség parancsként való meghívására szolgál) és a description. Az ügynök a leírás mező alapján dönti el, hogy a képesség illik-e az aktuális feladathoz, és be kell-e töltenie. Ha a leírás homályos, előfordulhat, hogy a képesség nem töltődik be, amikor szükség lenne rá.

A fejlécet utasításokat tartalmazó szakaszok követik. A When to Use azt írja le, mikor kell betölteni a képességet. A Procedure megadja a lépéseket. A Pitfalls bemutatja, hol szokott hibázni az ügynök, és hogyan kerülhetők el ezek a hibák. A Verification elmagyarázza az eredmény ellenőrzését. Ha hosszúak az utasítások, helyezd át a fő tartalmat a references/ mappában lévő fájlokba; ezek csak szükség esetén töltődnek be, a segédprogramokat pedig tedd a scripts/ mappába.

Ha egy képességhez API-kulcs szükséges, a fejlécben a required_environment_variables mezővel deklaráld; magát a kulcsot ne tedd bele a fájlba, csak a változó nevét add meg. Hermes első alkalommal, a helyi terminálban történő meghíváskor egyszer bekéri az értéket, majd automatikusan megadja (üzenetküldőkben arra kér, hogy helyben állítsd be a kulcsot). A platforms, config, blueprint és egyéb mezőket a hivatalos Képességek készítése dokumentációs oldal ismerteti.

Ha elkészült a fájl, kövesd ezeket a lépéseket:

1. Hozd létre a képesség mappáját

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

   A mappa neve egyezzen meg a fejléc name mezőjével.

2. Mentsd el a SKILL.md fájlt

   Helyezz el a mappában egy SKILL.md nevű fájlt az utasításokkal; használhatod a fenti példát, és átírhatod a feladatodhoz.

3. Hívd meg a képességet, és ellenőrizd

   Írd be a /weekly-review parancsot, és kérd meg az ügynököt, hogy tekintse át a hetedet. Ha követi az utasításaid lépéseit, akkor működik a képesség.

Hogyan készíthetsz képességet meglévő anyagokból a /learn segítségével?#

/learn dokumentáció a ~/projects/example-docs mappában lévő demo API-hoz, különösen a hitelesítésről szóló rész
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn hogyan tettem közzé az imént egy webhelyet tárhelyen

Ha épp most fejeztél be egy bonyolult folyamatot az ügynökkel, kérd meg a /learn paranccsal, hogy mentse el képességként, amíg még minden lépés szerepel a beszélgetésben. Legközelebb Hermes az előre elkészített utasításokkal megismétli az eljárást.

Egy nagy forrás, például egy könyv, specifikáció vagy dokumentumarchívum nem fér el egyetlen fájlban. Hermes készít egy tömör SKILL.md fájlt tématérképpel, a részleteket pedig áthelyezi a references/ mappába. Ezek a fájlok addig nem foglalnak helyet a kontextusban, amíg az ügynök be nem tölti őket a kérdés megválaszolásához. Ha ugyanahhoz a témához újra meghívod a /learn parancsot, az a meglévő képességhez fűzi a tartalmat, nem készít duplikátumot.

Hogyan ellenőrizd, hogy működik-e a képesség?#

hermes chat --toolsets skills -q "ellenőrizd a hetemet a weekly-review képességgel: kész - jelentés és hívások, elakadt - tárhelyfizetés"

Ezt a tesztet ajánlja a dokumentáció: futtasd a képességet, és ellenőrizd, hogy az ügynök követi-e az utasításaidat. Ha nem, három lehetséges okot vizsgálj meg. Először is előfordulhat, hogy a mappa neve vagy a fejléc name mezője nem egyezik meg azzal a névvel, amelyet meghívsz. Másodszor lehet, hogy a leírásból nem derül ki egyértelműen, mikor kell használni a képességet; írd át a feladat saját szavaival. Harmadszor előfordulhat, hogy a mappa nincs a ~/.hermes/skills/ helyen, ezért Hermes nem találja. Ne feledd, hogy a --toolsets skills kapcsoló korlátozza a teszt eszközkészletét: megmutatja, hogyan működik az ügynök az utasítással, de nem ellenőrzi a képesség függőségeit, például a külső programokat.

A terminálban futtatott hermes skills list pontosan megmutatja, mi van telepítve.

A képességek egy AI-klón részét képezik: segítségükkel egyszer rögzítheted, hogyan végzel el egy feladatot, az ügynök pedig emlékeztetők nélkül is megismételheti. A kombináció elemei: AI-klón + Second Brain + Context Engineering. Ezzel a kombinációval átadhatod az ügynöknek a munkamódszeredet és a feladat kontextusát.

Hogyan frissítsd és távolítsd el a képességeket?#

hermes skills check      # mi változott a forrásokban
hermes skills update     # új verziók letöltése
hermes skills uninstall pdf   # képesség eltávolítása a hubból

A kézzel létrehozott képesség eltávolításához töröld a mappáját a ~/.hermes/skills/ helyről. Ha más képességét testre szabtad, az update békén hagyja: Hermes összehasonlítja a hash-értékeket, és kihagyja a módosított fájlokat, hogy ne írja felül a munkádat. Hubból származó képesség eredeti változatának visszaállításához használd a hermes skills update name --force parancsot; beépített képességnél a hermes skills reset name --restore parancsot. Mindkét parancs felülírja a módosításaidat, ezért előbb mentsd el a saját verziódat.

Ha nincs szükséged a beépített képességekre, és túlzsúfolják a listát, a hermes skills opt-out letiltja a hozzáadásukat frissítéskor. Az opt-out --remove parancs a még nem módosított képességeket is eltávolítja.

Mi a teendő, ha egy képességet nem lehet telepíteni, vagy nem működik?#

Hermes a git-repozitóriumon belüli .hermes/skills/ és .agents/skills/ mappákban is keres képességeket. Betöltésük előtt megbízhatónak kell jelölnöd a repozitóriumot: ezek a fájlok az ügynök által követendő utasításokat tartalmaznak. Ezután a repozitóriumból származó képességek csak azon belül működnek, és ugyanazon a biztonsági ellenőrzésen esnek át. A repozitóriumot elég egyszer megbízhatónak jelölni.

Mit érdemes először tenned?#

Következő téma: Hermes Agent csatlakoztatása a Telegramhoz, hogy a telefonodról is meghívhasd a képességeket, valamint az ügynök folyamatos futtatása szerveren, ha ütemezett képességeket szeretnél. Ha ügynököt választasz, olvasd el az OpenClaw vagy Hermes Agent összehasonlítását.