Agent skill · software engineering · steipete

whatsapp

WhatsApp router: history/search/read/send; wacrawl read, wacli live.

Why this skill is useful

Provides specific commands and workflows for interacting with WhatsApp's desktop and linked-device functionalities that the AI wouldn't reliably generate on its own.

What it needs

Requires wacli, wacrawl installed locally. About 2k tokens when loaded. Last updated 2026-08-06. 6,510 stars on the source repository.

What this skill does

WhatsApp Use this as the first stop for WhatsApp work. Keep the source boundary sharp: wacrawl: primary WhatsApp Desktop archive. Read-only, best local history, no network, no sending. wacli: linked-device accounts. Use for alt accounts, live sync, auth, sending, chat/group mutation, and WhatsApp Web protocol questions. If the user names wacrawl or wacli repo work specifically, read that tool's own skill too. Routing Primary WhatsApp reads/search/history: use wacrawl. Read/unread counts from WhatsApp Desktop: use wacrawl; it has chat-level unread counts, not per-message read state. Freshness-sensitive primary reads: check wacrawl status; run wacrawl sync when asked or when current data matters. Alt accounts such as me, molty, or named stores: use wacli --account NAME. Sending, reactions, presence, archive/pin/mute/mark-read, group/channel mutations: use wacli only after explicit user intent. Comparing coverage between sources: treat wacrawl as Desktop archive truth for primary history, and wacli as linked-device/live coverage with protocol limits. Safety Never send or mutate WhatsApp state unless explicitly requested. Prefer read-only wacli commands for inspection: pass --read-only or set WACLIREADONLY=1. Do not write into WhatsApp Desktop's app container. Do not edit wacli session.db directly. Keep named wacli accounts isolated; do not merge stores. Report source freshness, account name, and known gaps when answering from local stores. Common Commands Primary Archive Freshness and status: Unread triage: Search and slice messages: Archive media or backups, only when asked: Alt/Live Accounts Account discovery and read-only inspection: Background live sync, only when requested. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills steipete/whatsapp

View the source on GitHub

Browse the @skills marketplace