Skill Hermes Agent: Memasang dan Mencipta Skill Sendiri

Skill ialah arahan tersimpan untuk ejen: anda menerangkan cara melaksanakan tugas sekali, kemudian Hermes menggunakannya apabila anda menaip /skill-name, tanpa perlu mengulang penjelasan. Skill sedia ada boleh dipasang dengan satu arahan, dan anda boleh mencipta skill sendiri dengan dua cara: tulis SKILL.md secara manual atau gunakan /learn.

Jika anda belum memasang Hermes, mulakan dengan panduan apa itu ejen ini dan cara memasangnya, kemudian teruskan kepada skill.

Apakah skill dalam Hermes Agent?#

Anda menulis prompt dalam mesej kepada ejen. Skill disimpan dalam fail berasingan, dan Hermes boleh menggunakan arahan itu dalam tugasan akan datang. Ejen mempunyai akses kepada senarai nama dan penerangan, lalu memuatkan teks penuh skill apabila relevan dengan tugasan. Ini menjimatkan ruang konteks: bukan semua arahan dimuatkan serentak.

Skill itu sendiri tidak memberikan alat atau akses baharu kepada ejen; ia menerangkan cara menggunakan alat yang sudah dimilikinya. Integrasi baharu dengan perkhidmatan luaran dikendalikan oleh MCP, iaitu topik berasingan. Jika tugasan memerlukan logik program yang tepat, kebenaran khas atau pemprosesan strim peristiwa, tugasan itu memerlukan alat ejen; skill sahaja tidak mencukupi.

Pilih skill sedia ada untuk tugasan standard jika arahannya sesuai dan sumbernya telah disemak. Tulis skill sendiri apabila anda perlu mengekalkan urutan tindakan, kekangan dan format output khusus anda. Gunakan /learn apabila anda sudah mempunyai bahan atau telah menyelesaikan suatu proses dan tidak mahu menulis fail secara manual.

Format ini terbuka dan serasi dengan spesifikasi Agent Skills, jadi skill daripada katalog lain biasanya boleh digunakan dalam Hermes tanpa perubahan format, walaupun skill tertentu mungkin memerlukan alat atau kuncinya sendiri. Anda juga boleh berkongsi skill sendiri jika mahu.

Skill apa yang sudah dipasang, dan di manakah ia disimpan?#

Folder itu disusun seperti berikut:

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

SKILL.md ialah satu-satunya fail yang diwajibkan. Semua yang lain ditambah apabila perlu: references/ untuk bahan yang lebih panjang, scripts/ untuk program pembantu, serta templates/ dan assets/ untuk templat dan fail.

Katalog terbina dalam merangkumi skill untuk tugasan harian: mencari GIF, bekerja dengan PDF, hamparan, YouTube, GitHub dan nota. Senarai lengkap berserta penerangan terdapat pada halaman katalog skill terbina dalam. Setiap kali hermes update dijalankan, Hermes turut mengemas kini skill terbina dalam sambil mengekalkan perubahan anda.

Bagaimanakah cara memasang skill sedia ada daripada katalog?#

1. Cari dalam katalog

   hermes skills search pdf
   

   Carian merangkumi semua sumber yang disambungkan. Untuk melihat seluruh katalog tanpa penapis, jalankan hermes skills browse.

2. Lihat kad skill

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

   Kad itu menunjukkan penerangan, sumber dan tahap kepercayaan. Jangan pasang skill orang lain tanpa membaca kadnya.

3. Pasangnya

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

   Hermes memuat turun SKILL.md dan fail iringannya, menjalankan pemeriksaan keselamatan, kemudian meletakkan semuanya dalam ~/.hermes/skills/. Skill itu tersedia serta-merta sebagai arahan /pdf. Jika skill tersebut memerlukan alat atau kunci tambahan, semuanya disenaraikan dalam SKILL.md dan Hermes akan memaklumkan anda semasa pemasangan.

Pemeriksaan keselamatan mencari percubaan menghantar data ke luar, arahan yang disuntik untuk ejen dan arahan yang boleh memadam atau merosakkan fail. Sumber mempunyai tahap kepercayaan yang berbeza:

Jika pemeriksaan mengeluarkan amaran, anda boleh meneruskan pemasangan dengan bendera --force, tetapi baca dahulu risiko yang ditemui. Keputusan “dangerous” tidak boleh dipintas. Pemeriksaan itu sendiri tidak menjamin keselamatan: sebelum menjalankan skill orang lain buat kali pertama, baca arahannya dan arahan iringannya.

Bagaimanakah cara memasang skill daripada GitHub atau pautan?#

Terdapat tiga cara untuk memasangnya:

# 1. Skill tertentu daripada repositori GitHub (laluan di dalam repositori diletakkan selepas namanya)
hermes skills install anthropics/skills/skills/pdf

# 2. Pautan langsung ke SKILL.md pada mana-mana laman (kongsi skill ini dalam sembang)
hermes skills install '<OFFICIAL_URL>'

# 3. Sambungkan seluruh repositori sebagai sumber (gantikan dengan pemilik dan repositori anda)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Untuk pautan langsung, Hermes memuat turun SKILL.md dan hanya fail yang disebut di dalamnya daripada subfolder perkhidmatan; fail lain yang tidak berkaitan daripada laman itu tidak dimuat turun. Pautan itu diingati sebagai sumber, dan hermes skills update akan mengemas kini skill itu kemudian daripada alamat yang sama.

Selain GitHub, katalog kemahiran luaran boleh disambungkan. Anda boleh mencari kemahiran daripada katalog tersebut dengan arahan hermes skills search yang sama, dengan menyatakan sumber.

Bagaimanakah cara menggunakan skill selepas pemasangan?#

Masukkan arahan hermes ... dalam terminal, dan panggilan /skill-name dalam sembang dengan ejen (dalam terminal yang sama, antara muka web atau aplikasi pesanan):

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

Jika anda memasukkan /skill-name tanpa tugasan, Hermes akan memuatkan arahan dan bertanya apa yang anda mahu ia lakukan. Anda boleh memanggil beberapa skill dalam satu baris, sehingga lima; teks selebihnya menjadi tugasan:

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

Untuk gabungan yang digunakan secara kerap, terdapat himpunan skill yang dipanggil bundles dalam istilah Hermes: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development mengumpulkan beberapa skill di bawah satu arahan pendek /backend-dev. Bundle sedemikian bertindak sebagai alias; skill di dalamnya mesti dipasang terlebih dahulu.

Arahan garis miring juga berfungsi dalam Telegram jika gateway disambungkan; persediaannya diterangkan dalam panduan cara menyambungkan Hermes Agent ke Telegram. Ini juga cara mudah untuk menjalankan skill melalui telefon.

Bagaimanakah cara mencipta skill sendiri: apakah kandungan SKILL.md?#

Anda boleh menyalin skill ini dan menyesuaikannya untuk kegunaan sendiri:

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

Pengepala antara tiga sengkang mengandungi metadata. Medan utamanya ialah name (dalam huruf Latin, dipisahkan dengan sempang dan digunakan untuk memanggil skill sebagai arahan) dan description. Ejen menggunakan medan description untuk menentukan sama ada skill itu sesuai dengan tugasan semasa dan patut dimuatkan. Jika penerangannya kabur, skill mungkin tidak dimuatkan apabila diperlukan.

Pengepala itu diikuti bahagian arahan. When to Use menyatakan bila skill perlu dimuatkan. Procedure memberikan langkah-langkahnya. Pitfalls menerangkan kesilapan yang biasa dilakukan ejen dan cara mengelakkannya. Verification menerangkan cara menyemak hasilnya. Jika arahannya panjang, pindahkan kandungan utama ke fail dalam references/; fail tersebut hanya akan dimuatkan apabila diperlukan. Letakkan program pembantu dalam scripts/.

Jika skill memerlukan kunci API, isytiharkannya dalam pengepala menggunakan required_environment_variables; jangan letakkan kunci itu sendiri dalam fail, hanya isytiharkan nama pemboleh ubah. Hermes akan meminta nilainya sekali, pada penggunaan pertama dalam terminal setempat, kemudian membekalkannya secara automatik (dalam aplikasi pesanan, Hermes akan meminta anda mengkonfigurasi kunci itu secara setempat). Medan platforms, config, blueprint dan medan lain diterangkan pada halaman dokumentasi rasmi Creating Skills.

Setelah fail siap, ikuti langkah-langkah ini:

1. Cipta folder skill

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

   Nama folder sepadan dengan medan name dalam pengepala.

2. Simpan SKILL.md

   Letakkan fail bernama SKILL.md yang mengandungi arahan anda di dalam folder itu; anda boleh menggunakan contoh di atas dan menulis semulanya untuk tugasan anda.

3. Panggil skill dan semaknya

   Masukkan /weekly-review dan minta ejen menyemak minggu anda. Jika ejen mengikuti langkah dalam arahan anda, skill itu berfungsi.

Bagaimanakah cara membina skill daripada bahan sedia ada dengan /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

Jika anda baru sahaja menyelesaikan proses yang rumit dengan ejen, minta /learn menyimpannya sebagai skill sementara semua langkah masih terdapat dalam perbualan. Lain kali, Hermes akan mengulangi prosedur itu menggunakan arahan yang telah disediakan.

Sumber yang besar, seperti buku, spesifikasi atau arkib dokumen, tidak muat dalam satu fail. Hermes akan mencipta SKILL.md yang ringkas dengan peta topik dan memindahkan butiran ke references/. Fail ini tidak menggunakan ruang konteks sehingga ejen memuatkannya untuk menjawab soalan. Menjalankan /learn sekali lagi untuk topik yang sama akan menambah kandungan pada skill sedia ada, bukannya mencipta pendua.

Bagaimanakah cara menyemak sama ada skill berfungsi?#

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

Inilah ujian yang disyorkan oleh dokumentasi: jalankan skill dan semak sama ada ejen mengikuti arahan anda. Jika tidak, semak tiga punca yang mungkin. Pertama, nama folder atau name dalam pengepala mungkin tidak sepadan dengan nama yang anda panggil. Kedua, penerangan mungkin tidak menjelaskan dengan baik bila skill patut digunakan; tulis semula penerangan menggunakan perkataan yang menggambarkan tugasan itu sendiri. Ketiga, folder itu mungkin bukan dalam ~/.hermes/skills/, jadi Hermes tidak dapat melihatnya. Perhatikan bahawa bendera --toolsets skills mengehadkan set alat untuk ujian: ia menunjukkan cara ejen bekerja dengan arahan tersebut, tetapi tidak menyemak kebergantungan skill seperti program luaran.

Arahan hermes skills list dalam terminal menunjukkan dengan tepat perkara yang telah dipasang.

Bagaimanakah cara mengemas kini dan membuang skill?#

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

Untuk membuang skill yang anda cipta secara manual, padam foldernya daripada ~/.hermes/skills/. Jika anda menyesuaikan skill orang lain, update tidak akan mengubahnya: Hermes membandingkan hash dan melangkau fail yang berubah supaya kerja anda tidak ditindih. Untuk memulihkan versi asal skill daripada hub, gunakan hermes skills update name --force; untuk skill terbina dalam, gunakan hermes skills reset name --restore. Kedua-dua arahan ini menindih perubahan anda, jadi simpan versi anda dahulu.

Jika anda tidak memerlukan skill terbina dalam dan senarai menjadi terlalu sesak, hermes skills opt-out akan menyahdayakan penambahannya semasa kemas kini. Arahan opt-out --remove juga akan membuang skill yang belum anda ubah.

Apakah yang patut dilakukan jika skill tidak dapat dipasang atau tidak berfungsi?#

Hermes mencari skill dalam folder .hermes/skills/ dan .agents/skills/ di dalam repositori git. Sebelum memuatkannya, anda mesti menandakan repositori itu sebagai dipercayai: fail ini mengandungi arahan yang akan diikuti oleh ejen. Selepas itu, skill daripada repositori tersebut hanya berfungsi di dalamnya dan menjalani pemeriksaan keselamatan yang sama. Repositori hanya perlu ditandakan sebagai dipercayai sekali sahaja.

Apakah perkara pertama yang patut dilakukan?#

Seterusnya tentang topik ini: cara menyambungkan Hermes Agent ke Telegram, supaya anda boleh memanggil skill melalui telefon, dan cara memastikan ejen terus berjalan pada pelayan sepanjang masa, jika anda mahu skill berjadual. Jika anda sedang memilih ejen, lihat perbandingan OpenClaw atau Hermes Agent.