Whatsapp Skill

whatsapp-skill

A [Claude Code](https://claude.com/claude-code) skill that lets Claude send WhatsApp messages and search your WhatsApp history from the terminal — via [wacli](https://github.com/steipete/wacli), the WhatsApp CLI by [@steipete](https://github.com/steipete).

Claude picks it up automatically when you say things like *"send a WhatsApp to Jane"*, *"text the Friday Football group that I'm running late"*, or *"find that link Marco sent me last month"*.

---

Why this skill exists

`wacli` gives you a terminal interface to WhatsApp (search, send, history, group listing). But dropping a CLI in front of Claude by itself isn't enough — Claude still has to *discover* who and what you mean every single time. Every conversation turn where Claude has to look up a group JID or figure out whose phone number "Jane" is burns API calls and real latency.

The skill wraps `wacli` with two persistent catalogues that Claude consults **before** falling back to live CLI queries:

`references/groups.yaml` — known groups

WhatsApp group JIDs look like `120363222222222222@g.us`. They're unguessable and they change nothing about the human-readable name of the group. `wacli chats list --query ""` searches only the local DB, misses groups that haven't been synced, and can't do much with fuzzy matching.

Pre-caching the names, short codes, and JIDs of the groups you actually use means:

• Zero API round-trips when Claude needs a JID you've already saved
• Stable short codes so you can say "send to COMMA-CHAT" and it just works
• Community tagging so you can run things like "list all Example Community A groups" without scanning everything

`references/contacts.yaml` — known contacts

`wacli contacts search` only sees contacts already in your phone's address book. But the people you message through Claude often come from elsewhere — event attendee spreadsheets, Luma exports, community rosters, screenshots of group chats, a message someone forwarded you. Those na