v1.0.0 to v1.0.0

---

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

```bash

hermes skills install hermes-wag-summarizer

```

### 2. Buat Wrapper untuk Grup Baru

Gunakan script helper untuk membuat wrapper script baru:

```bash

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

```bash

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:

```bash

~/.hermes/skills/hermes-wag-summarizer/templates/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

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