Cara Membuat Skill Kustom Hermes Agent Sendiri

Hermes Agent dapat diperluas untuk menangani tugas khusus melalui skill yang Anda tulis sendiri. Ini berbeda dari panduan 29 Okt tentang memasang skill atau plugin Hermes Agent milik orang lain; ikuti panduan memasang skill atau plugin Hermes Agent jika ingin memakai kemampuan yang sudah dibuat. Di sini, Anda menyusun kemampuan baru agar Hermes mengikuti pengetahuan dan alur kerja sesuai kebutuhan.

Kenali struktur skill terlebih dahulu

Satu skill kustom dibuat sebagai folder dengan lokasi yang ditetapkan: ~/.hermes/skills/<nama>/. Di dalam folder tersebut, buat file SKILL.md. File ini menjadi tempat untuk menjelaskan kapan kemampuan digunakan, apa yang harus disiapkan, bagaimana prosedurnya, apa risikonya, dan bagaimana memeriksa hasilnya.

Tulis frontmatter yang ringkas

Awali SKILL.md dengan frontmatter yang berisi name dan description. Gunakan nama yang mudah dikenali dan deskripsi yang spesifik terhadap tugas. Hindari deskripsi terlalu umum seperti “membantu berbagai hal”, karena Hermes perlu memahami batas kemampuan skill tersebut. Jangan menambahkan format YAML lain yang tidak ditetapkan.

Susun isi dengan lima bagian utama

When to Use

Jelaskan kondisi yang menjadi pemicu skill. Sebutkan jenis permintaan, berkas, atau hasil yang relevan. Bagian ini membantu membedakan skill Anda dari kemampuan lain, sehingga tidak dipakai pada tugas yang tidak sesuai.

Prerequisites

Tuliskan hal yang harus tersedia sebelum prosedur dimulai. Misalnya, jelaskan informasi yang perlu diberikan pengguna, akses yang diperlukan, atau kondisi berkas yang harus dipenuhi. Buat daftar ini realistis dan jangan mengasumsikan sesuatu yang tidak selalu ada.

Procedure

Uraikan langkah kerja secara berurutan. Gunakan instruksi yang dapat diamati, seperti membaca data tertentu, memeriksa hasil, lalu menyusun keluaran dengan format yang ditentukan. Kemampuan yang spesifik biasanya lebih konsisten daripada arahan yang luas. Jika ada keputusan bercabang, jelaskan kapan tiap pilihan digunakan.

Pitfalls

Catat kesalahan umum, batasan, dan kondisi yang perlu dihindari. Anda dapat menjelaskan kapan Hermes harus meminta klarifikasi atau berhenti, terutama jika data yang diperlukan belum tersedia.

Verification

Tentukan cara menguji keberhasilan. Sertakan tanda bahwa hasil sudah benar, misalnya bagian wajib telah ada, format keluaran sesuai, atau pemeriksaan akhir tidak menemukan masalah.

Uji skill pada sesi berikutnya

Simpan file, lalu lakukan pengujian dengan permintaan yang benar-benar sesuai dengan deskripsi. Bandingkan hasilnya dengan prosedur dan kriteria verifikasi yang Anda tulis. Uji juga satu contoh yang seharusnya tidak memicu skill agar batasnya jelas.

Mulailah dengan contoh yang aman dan mudah diperiksa, bukan tugas yang mengubah data penting atau meminta akses lebih luas dari kebutuhan skill. Catat hasil uji agar perubahan berikutnya lebih terarah.

Penting untuk diingat, skill baru muncul di sesi Hermes berikutnya karena loader di-cache per sesi, bukan langsung. Jadi, jangan menganggap perubahan gagal hanya karena belum terlihat pada sesi yang sedang berjalan. Jika lingkungan Anda membutuhkan pendaftaran tambahan, ikuti cara pendaftaran yang didukung dokumentasi, tanpa menambahkan format atau perintah yang tidak ditetapkan.

Mulailah dari satu tugas sempit, uji hasilnya, lalu perbaiki instruksi berdasarkan perilaku Hermes. Dengan begitu, SKILL.md berkembang menjadi kemampuan yang jelas, terukur, dan mudah dirawat.