hermes-wag-summarizer

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 "[e-mail]" \
  --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:[e-mail]"

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.