Hermes Agent -taidot: Valmiin taidon asentaminen ja oman luominen

Taito on agentille tallennettu ohje: kuvaat kerran, miten tehtävä tehdään, ja siitä lähtien Hermes soveltaa ohjetta, kun kutsut komentoa /skill-name ilman, että sinun tarvitsee selittää asiaa uudelleen. Valmiin taidon voi asentaa yhdellä komennolla, ja voit luoda oman kahdella tavalla: kirjoittaa SKILL.md:n käsin tai käyttää komentoa /learn.

Jos et ole vielä asentanut Hermesiä, aloita oppaasta mikä tämä agentti on ja miten se asennetaan ja siirry sitten taitoihin.

Mikä taito on Hermes Agentissa?#

Kirjoitat agentille viestiin kehotteen. Taito tallennetaan erilliseen tiedostoon, ja Hermes voi käyttää ohjetta tulevissa tehtävissä. Agentilla on käytettävissään nimien ja kuvausten luettelo, ja se lataa koko taidon tekstin, kun se liittyy tehtävään. Näin säästyy kontekstitilaa: kaikkia ohjeita ei ladata kerralla.

Taito ei itsessään anna agentille uusia työkaluja tai käyttöoikeuksia, vaan kuvaa, miten se käyttää jo käytettävissään olevia työkaluja. Uusi integraatio ulkoiseen palveluun toteutetaan MCP:llä, joka on erillinen aihe. Jos tehtävä edellyttää tarkkaa ohjelmalogiikkaa, erityistä valtuutusta tai tapahtumavirran käsittelyä, siihen tarvitaan agentin työkaluja; pelkkä taito ei riitä.

Valitse vakiotehtävään valmis taito, jos sen ohjeet sopivat tarkoitukseen ja sen lähde on tarkistettu. Kirjoita oma taito, kun sinun on säilytettävä oma toimintajärjestyksesi, rajoituksesi ja tulostusmuotosi. Käytä komentoa /learn, kun sinulla on jo materiaalia tai olet suorittanut prosessin etkä halua kirjoittaa tiedostoa käsin.

Muoto on avoin ja yhteensopiva Agent Skills -määrityksen kanssa, joten muiden luetteloiden taidot toimivat yleensä Hermesissä ilman muotomuutoksia, vaikka jokin tietty taito saattaa edellyttää omia työkaluja tai avaimia. Voit myös jakaa oman taitosi, jos haluat.

Mitä taitoja on jo asennettu, ja mihin ne tallennetaan?#

Kansio on järjestetty näin:

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

SKILL.md on ainoa pakollinen tiedosto. Muu lisätään tarpeen mukaan: references/ pidemmille materiaaleille, scripts/ apuohjelmille sekä templates/ ja assets/ malleille ja tiedostoille.

Sisäänrakennettu luettelo sisältää taitoja arkisiin tehtäviin: GIF-kuvien etsimiseen, PDF-tiedostojen, laskentataulukoiden, YouTuben, GitHubin ja muistiinpanojen käsittelyyn. Täydellinen kuvauksineen oleva luettelo löytyy sisäänrakennettujen taitojen luettelo -sivulta. Jokaisen hermes update -komennon yhteydessä Hermes päivittää myös sisäänrakennetut taidot ja säilyttää niihin tekemäsi muutokset.

Miten asennat valmiin taidon luettelosta?#

1. Hae luettelosta

   hermes skills search pdf
   

   Haku kattaa kaikki yhdistetyt lähteet. Voit tarkastella koko luetteloa ilman suodatinta suorittamalla komennon hermes skills browse.

2. Tarkastele taidon tietokorttia

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

   Kortissa näkyvät kuvaus, lähde ja luottamustaso. Älä asenna jonkun toisen taitoa lukematta sen tietokorttia.

3. Asenna taito

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

   Hermes lataa SKILL.md-tiedoston ja siihen liittyvät tiedostot, suorittaa tietoturvatarkistuksen ja sijoittaa kaiken kansioon ~/.hermes/skills/. Taito on heti käytettävissä /pdf-komentona. Jos taito tarvitsee lisätyökaluja tai avaimia, ne luetellaan sen SKILL.md-tiedostossa, ja Hermes kertoo niistä asennuksen aikana.

Tietoturvatarkistuksessa etsitään yrityksiä lähettää tietoja ulkopuolelle, agentille injektoituja ohjeita sekä komentoja, jotka voivat poistaa tai vahingoittaa tiedostoja. Lähteillä on eri luottamustasot:

Jos tarkistus antaa varoituksen, voit jatkaa asennusta --force-lipulla, mutta lue ensin, minkä riskin se havaitsi. ”Vaarallista” arviota ei voi ohittaa. Tarkistus ei itsessään takaa turvallisuutta: ennen kuin ajat jonkun toisen taitoa ensimmäistä kertaa, lue sen ohjeet ja siihen liittyvät komennot.

Miten asennat taidon GitHubista tai linkistä?#

Kolme tapaa asentaa:

# 1. A specific skill from a GitHub repository (the path inside the repository comes after its name)
hermes skills install anthropics/skills/skills/pdf

# 2. A direct link to a SKILL.md on any site (share this skill in a chat)
hermes skills install '<OFFICIAL_URL>'

# 3. Connect an entire repository as a source (replace with your owner and repository)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Suoran linkin kautta Hermes lataa SKILL.md-tiedoston ja vain ne palvelun alikansioissa olevat tiedostot, jotka siinä mainitaan; se ei lataa sivustolta tiedostoja, jotka eivät liity taitoon. Linkki tallennetaan lähteeksi, ja hermes skills update päivittää taidon myöhemmin samasta osoitteesta.

GitHubin lisäksi käytössä on ulkoisia taitoluetteloita. Voit etsiä niistä taitoja samalla komennolla hermes skills search määrittämällä lähteen.

Miten käytät taitoa asennuksen jälkeen?#

Kirjoita hermes ... -komennot terminaaliin ja /skill-name-kutsut keskusteluun agentin kanssa (samassa terminaalissa, verkkokäyttöliittymässä tai viestisovelluksessa):

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

Jos kirjoitat /skill-name ilman tehtävää, Hermes lataa ohjeet ja kysyy, mitä haluat sen tekevän. Voit kutsua useita taitoja yhdellä rivillä, enintään viittä; jäljelle jäävästä tekstistä tulee tehtävä:

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

Säännöllisesti käyttämiäsi yhdistelmiä varten on taitopaketteja, joita kutsutaan Hermesin terminologiassa bundleiksi: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development kokoaa useita taitoja yhden lyhyen /backend-dev-komennon alle. Tällainen bundle toimii aliaksena; sen sisältämät taidot on asennettava etukäteen.

Vinoviivakomennot toimivat myös Telegramissa, jos yhdyskäytävä on yhdistetty; asetukset esitellään oppaassa Hermes Agentin yhdistäminen Telegramiin. Näin taitoja on kätevä käyttää myös puhelimella.

Miten luot oman taidon: mitä SKILL.md-tiedostoon kirjoitetaan?#

Voit kopioida tämän taidon ja mukauttaa sen itsellesi:

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

Kolmen viivan välinen otsake on metadataa. Tärkeimmät kentät ovat name (latinalaisin kirjaimin, väliviivoin eroteltuna ja käytössä taidon kutsumiseen komentona) ja description. Agentti käyttää kuvauskenttää arvioidakseen, sopiiko taito käsillä olevaan tehtävään ja pitäisikö se ladata. Jos kuvaus on epämääräinen, taitoa ei ehkä ladata silloin, kun sitä tarvitaan.

Otsaketta seuraavat ohjeiden osiot. When to Use kertoo, milloin taito ladataan. Procedure kuvaa vaiheet. Pitfalls käsittelee tavallisia agentin virheitä ja niiden välttämistä. Verification kertoo, miten tulos tarkistetaan. Jos ohjeet ovat pitkiä, siirrä pääsisältö references/-kansiossa oleviin tiedostoihin; ne ladataan vasta tarvittaessa, ja sijoita apuohjelmat scripts/-kansioon.

Jos taito tarvitsee API-avaimen, määritä se otsakkeessa kentällä required_environment_variables; älä lisää tiedostoon itse avainta, vaan ainoastaan muuttujan nimi. Hermes pyytää arvon kerran, kun taitoa kutsutaan ensimmäistä kertaa paikallisessa terminaalissa, ja toimittaa sen sen jälkeen automaattisesti (viestisovelluksissa se kehottaa määrittämään avaimen paikallisesti). Kentät platforms, config, blueprint ja muut kuvataan virallisella dokumentaatiosivulla Creating Skills.

Kun tiedosto on valmis, toimi näin:

1. Luo taitokansio

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

   Kansion nimi vastaa otsakkeen name-kenttää.

2. Tallenna SKILL.md

   Tallenna kansioon tiedosto nimeltä SKILL.md, jonka sisältämät ohjeet voit ottaa yllä olevasta esimerkistä ja kirjoittaa uudelleen tehtävääsi varten.

3. Kutsu taitoa ja tarkista se

   Kirjoita /weekly-review ja pyydä agenttia käymään viikkosi läpi. Jos se noudattaa ohjeidesi vaiheita, taito toimii.

Miten luot taidon olemassa olevasta materiaalista komennolla /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

Jos olet juuri suorittanut agentin kanssa monimutkaisen prosessin, pyydä /learn-komentoa tallentamaan se taidoksi, kun kaikki vaiheet ovat vielä keskustelussa. Seuraavalla kerralla Hermes toistaa prosessin valmiiden ohjeiden avulla.

Suuri lähde, kuten kirja, määritys tai asiakirja-arkisto, ei mahdu yhteen tiedostoon. Hermes luo tiiviin SKILL.md:n, jossa on aihehakemisto, ja siirtää yksityiskohdat references/-kansioon. Nämä tiedostot eivät vie kontekstitilaa ennen kuin agentti lataa ne vastatakseen kysymykseen. Jos kutsut /learn-komentoa uudelleen samasta aiheesta, se lisää sisältöä olemassa olevaan taitoon uuden luomisen sijaan.

Miten tarkistat, että taito toimii?#

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

Tämä on dokumentaation suosittelema testi: suorita taito ja tarkista, noudattaako agentti ohjeitasi. Jos se ei noudata niitä, tarkista kolme mahdollista syytä. Ensinnäkin kansion nimi tai otsakkeen name ei ehkä vastaa kutsumaasi nimeä. Toiseksi kuvaus ei ehkä kerro selkeästi, milloin taitoa tulisi käyttää; kirjoita kuvaus uudelleen käyttäen tehtävän omia sanoja. Kolmanneksi kansio ei ehkä ole paikassa ~/.hermes/skills/, jolloin Hermes ei näe sitä. Huomaa, että --toolsets skills-lippu rajoittaa testin työkalusarjaa: se näyttää, miten agentti toimii ohjeen perusteella, mutta ei tarkista taidon riippuvuuksia, kuten ulkoisia ohjelmia.

hermes skills list näyttää terminaalissa täsmälleen, mitä on asennettu.

Miten päivität ja poistat taitoja?#

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

Jos haluat poistaa itse luomasi taidon, poista sen kansio polusta ~/.hermes/skills/. Jos olet mukauttanut jonkun toisen taitoa, update jättää sen rauhaan: Hermes vertaa tarkistussummia ja ohittaa muuttuneet tiedostot, jotta työtäsi ei korvata. Jos haluat palauttaa hubista peräisin olevan taidon alkuperäisen version, käytä komentoa hermes skills update name --force; sisäänrakennetun taidon kohdalla käytä komentoa hermes skills reset name --restore. Molemmat komennot korvaavat tekemäsi muutokset, joten tallenna versiosi ensin.

Jos et tarvitse sisäänrakennettuja taitoja ja ne tekevät luettelosta sekavan, hermes skills opt-out poistaa niiden lisäämisen käytöstä päivitysten yhteydessä. Komento opt-out --remove poistaa myös ne sisäänrakennetut taidot, joita et ole muuttanut.

Mitä tehdä, jos taito ei asennu tai toimi?#

Hermes löytää taitoja Git-arkiston kansioista .hermes/skills/ ja .agents/skills/. Ennen niiden lataamista sinun on merkittävä arkisto luotetuksi: nämä tiedostot sisältävät ohjeita, joita agentti noudattaa. Sen jälkeen arkiston taidot toimivat vain kyseisessä arkistossa ja käyvät läpi saman tietoturvatarkistuksen. Arkisto tarvitsee merkitä luotetuksi vain kerran.

Mitä kannattaa tehdä ensin?#

Seuraavaksi aiheesta: Hermes Agentin yhdistäminen Telegramiin, jotta voit kutsua taitoja puhelimellasi, ja agentin pitäminen käynnissä palvelimella ympäri vuorokauden, jos haluat ajastettuja taitoja. Jos valitset agenttia, katso vertailu OpenClaw vai Hermes Agent.