whatsapp-automation: Skill for Claude Code

.claude/skills/run-whatsapp-automation/SKILL.md

run-whatsapp-automation is a skill for Claude Code from sumioshi/whatsapp-automation. It costs 0 tokens per session (5,444 once invoked), scanned A, original, Apache-2.0.

Um conjunto de instruções para executar uma automação que coleta mensagens, arquivos e mídias de grupos do WhatsApp e disponibiliza esse conteúdo para uma IA.

In plain words
What is it for?
Serve para rodar o coletor, o painel web, a transcrição de áudio, as notificações e o servidor que fornece essas funções à IA.
Why use it?
Ajuda a iniciar e verificar os vários serviços necessários para coletar, visualizar, pesquisar e transcrever o conteúdo.

Skill for Claude Code

Written for Claude Code: installed under .claude/. Also seen: reads .claude/ paths; mentions CLAUDE.md; mentions Claude Code.

This is sumioshi/whatsapp-automation's own configuration. It tells Claude Code how to work on whatsapp-automation itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything whatsapp-automation configures →

Reuse

Borrowing it

Nothing to install: this file belongs to sumioshi/whatsapp-automation. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/sumioshi/whatsapp-automation/main/.claude/skills/run-whatsapp-automation/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/sumioshi/whatsapp-automation

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for run-whatsapp-automation

README.md
[![agentmods](https://agentmods.dev/badge/skills/sumioshi/whatsapp-automation/run-whatsapp-automation/github.svg)](https://agentmods.dev/skills/sumioshi/whatsapp-automation/run-whatsapp-automation)
Your own site
<a href="https://agentmods.dev/skills/sumioshi/whatsapp-automation/run-whatsapp-automation"><img src="https://agentmods.dev/badge/skills/sumioshi/whatsapp-automation/run-whatsapp-automation/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for run-whatsapp-automation

Your own site · 80×15
<a href="https://agentmods.dev/skills/sumioshi/whatsapp-automation/run-whatsapp-automation"><img src="https://agentmods.dev/badge/skills/sumioshi/whatsapp-automation/run-whatsapp-automation.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 5,444 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.05444
Opus 5.5 $0.00000 $0.02178
Sonnet 5.5 $0.00000 $0.01089
Haiku 4.5 $0.00000 $0.00544

Measured 2d ago against content hash 184810a625e1, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

run-whatsapp-automation scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (driver.mjs), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

> vazio NÃO significa serviços fora — confirme sempre pelos smoke `curl`
.claude/skills/run-whatsapp-automation/SKILL.md · 293 lines

How it starts

The opening of the file, as written. The whole thing — 293 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Run: WhatsApp Automation

Coleta conteúdo de grupos de WhatsApp (áudio/vídeo/imagem/documento/texto) e expõe tudo pra IA. São 5 processos: wa-collector (daemon Baileys), wa-panel (Next.js em :3000), wa-transcriber (serviço MLX em :4320), wa-notifier (notificação de mensagens de cliente, ver seção abaixo) e o MCP server (stdio, sob demanda). O MCP é dirigido pelo driver abaixo. Tools de escrita preparar_resposta (contexto antes de redigir) e revisar_texto (revisa sem enviar) entram no pipeline de envio — ver seção "Regra: enviar mensagem no grupo" abaixo.

Como os 3 primeiros rodam: em dev local (o caso atual) é npm run dev na raiz, que sobe os três via concurrently — não pm2. Em produção é pm2 (ecosystem.config.cjs). Os dois caminhos existem; veja "Run" abaixo. pm2 ls vazio NÃO significa serviços fora — confirme sempre pelos smoke curl (:3000 / :4310 / :4320), não pelo pm2.

Plataforma: macOS Apple Silicon. A transcrição usa mlx_whisper (MLX), que só roda em Apple Silicon — em Linux o coletor e o painel sobem, mas o transcriber não. Paths neste arquivo são relativos à raiz do repo.

Dois coletores, dois servidores MCP

  • whatsapp-collector = coletor PRINCIPAL (número business, clientes). É o default.
  • whatsapp-pessoal = coletor PESSOAL (2º container na Railway, WhatsApp pessoal do operador). Mesmas tools, mesmo código, outro trio de acesso. Use quando o operador disser "no pessoal", "meu WhatsApp pessoal", ou o chat não existir no principal. Contas diferentes → slugs diferentes; listar_grupos em cada um. Plantão no pessoal: PLANTAO_CLOUD=pessoal no plantao-stream.sh.

⚠️ Regra: enviar mensagem (grupo ou DM) → humanizar SEMPRE

Sempre que o usuário pedir para enviar, responder ou redigir uma mensagem num grupo (via responder, responder_midia com legenda, pelo painel, ou pela API de controle :4310):

Pipeline de envio, nesta ordem: preparar_resposta(grupo) → skill de voz do operador (voz-do-dono nesta máquina; molde voz-do-operador) → comunicacao-cliente (conduta) → no modo confirmar, revisar_texto e mostrar ao operador o texto já revisado → responder com candidatos (2-3 versões) ou baloes. humanizer não entra em balão de conversa. Se a revisão recusar, reescreva seguindo sugestoes; não use revisao: 'ignorar' sem OK explícito do operador.

Read the full file on GitHub · 293 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago Changed · +53 lines 184810a625e1
  2. 2mo ago First seen · 240 lines · 0 tokens per session scan A e8b8192cd56e

Subscribe to this mod's changes

run-whatsapp-automation is a skill published in the GitHub repository sumioshi/whatsapp-automation (2 stars, last pushed 7d ago), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 5,444 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

run-whatsapp-automation compared with skills from other repositories

run-whatsapp-automation next to 6 skills from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
run-whatsapp-automationsumioshi/whatsapp-automationSkill27d agoApache-2.0A0Claude Code
quick-capturevscarpenter/gsd-task-managerSkill41todayMITA0Claude Code, Codex
triage-inboxvscarpenter/gsd-task-managerSkill41todayMITA0Claude Code, Codex
todoxbeydemirfurkan/todoxSkill24d agoMITA63Claude Code
lastestlas-team/lastestSkill222d agononeA33Claude Code, Codex
lastestlas-team/lastestSkill222d agononeA0Claude Code, Codex
Lastest design systemlas-team/lastestSkill222d agononeA39Claude Code, Codex