hermes-wag-summarizer - SKILL.md Agent Skill

name: hermes-wag-summarizer description: Plug & play skill untuk membuat cronjob summary grup WhatsApp secara otomatis menggunakan Hermes WhatsApp Bridge. version: 1.0.0 metadata: hermes: tags: [whatsapp, cron, summary, digest, group, plug-and-play] related_skills: [whatsapp-bridge-watchdog, whatsapp-bridge-diagnostics]

Hermes WAG Summarizer

Skill ini menyediakan solusi lengkap dan plug & play untuk membuat cronjob yang secara otomatis merangkum percakapan grup WhatsApp.

Tujuan Skill

Memberikan cara paling sederhana untuk user Hermes baru agar bisa langsung punya fitur summary grup WhatsApp.
Menjadi single source of truth untuk semua hal terkait WhatsApp Group Summarizer.
Mendukung multiple grup dengan konfigurasi terpisah.
Default delivery ke grup WhatsApp yang sama.

Fitur Utama

Setup summary grup dalam hitungan menit
Support multiple grup WhatsApp
Prompt yang sudah dioptimalkan untuk WhatsApp
Struktur output yang konsisten dan enak dibaca
Auto [SILENT] ketika tidak ada aktivitas
Panduan troubleshooting lengkap

Cara Menggunakan (Plug & Play)

1. Install Skill

hermes skills install hermes-wag-summarizer

2. Buat Wrapper untuk Grup Baru

Gunakan script helper untuk membuat wrapper script baru:

python3 ~/.hermes/skills/hermes-wag-summarizer/scripts/create-group-wrapper.py \
  --chat-id "120363402262217562@g.us" \
  --group-name "VibeDev ID" \
  --hours 12

Script ini akan otomatis membuat:

Wrapper script di ~/.hermes/scripts/
Entry di tabel konfigurasi

3. Buat Cronjob

hermes cron create \
  --name "VibeDev ID Summary" \
  --script "~/.hermes/scripts/vibedev-id-summary.py" \
  --schedule "0 5,17 * * *" \
  --deliver "whatsapp:120363402262217562@g.us"

4. (Opsional) Custom Prompt

Jika ingin mengubah gaya ringkasan, edit file prompt:

~/.hermes/skills/hermes-wag-summarizer/prompts/default-summary-prompt.txt

Lalu arahkan cronjob ke prompt tersebut.

Struktur Output yang Direkomendasikan

*Ringkasan VibeDev ID (12 jam terakhir)*

*Topik yang Dibahas:*
• ...

*Highlight Penting:*
• ...

*Pertanyaan yang Masih Terbuka:*
• ...

*Link / Resource:*
• ...

Konfigurasi Default

Pengaturan	Nilai Default	Keterangan
Window	12 jam	Bisa diubah per grup
Delivery	Ke grup yang sama	Kecuali explicit minta ke tempat lain
Format	Markdown WhatsApp	`teks` untuk bold
Empty Window	`[SILENT]`	Tidak spam grup
Schedule	`0 5,17 * * *`	05:00 & 17:00 UTC

File yang Disertakan

scripts/whatsapp-group-summary.py — Parser utama
scripts/create-group-wrapper.py — Helper membuat wrapper baru
prompts/default-summary-prompt.txt — Prompt default yang sudah dioptimalkan
examples/ — Contoh konfigurasi cronjob

Catatan Penting

Skill ini hanya untuk summary. Untuk moderation atau analytics, gunakan skill terpisah.
Pastikan WhatsApp Bridge sudah berjalan dan messages.jsonl aktif.
Untuk troubleshooting bridge yang "deaf", gunakan skill whatsapp-bridge-watchdog.

Maintenance

Setelah menambah atau mengubah grup, update bagian Live Inventory di skill ini agar tetap menjadi single source of truth.