add-reactions

Add WhatsApp emoji reaction support with SQLite persistence and MCP tooling.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/theowenyoung/nanoclaw --skill add-reactions
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-reactions
Source: https://github.com/theowenyoung/nanoclaw/tree/main/.claude/skills/add-reactions
Command: npx skills add https://github.com/theowenyoung/nanoclaw --skill add-reactions

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires better-sqlite3.

What problem does it solve?

Adds end-to-end emoji reaction support to NanoClaw's WhatsApp channel so users and agents can react to messages, reactions are persisted, and reaction history can be queried instead of relying on ephemeral client UI only.

Core Features & Use Cases

  • Receive & persist reactions: Incoming WhatsApp reaction events are captured and stored in a dedicated SQLite reactions table for history and analytics.
  • Agent-initiated reactions: Container agents can react to specific messages or the latest message using an MCP tool exposed to the agent runtime.
  • Querying & utilities: Database helpers let you fetch reactions by message, by user, and aggregated reaction stats; includes migration script and tests.
  • Reliability & safety: Status tracking, group-scoped IPC authorization, and retries are implemented to ensure correct delivery and bounded access.

Quick Start

Apply the skill package using the repository's skill engine and run the included database migration to enable WhatsApp reaction support.

Frequently Asked Questions about add-reactions

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I store and query WhatsApp emoji reactions instead of losing them when the client closes?

WhatsApp emoji reactions are captured and stored in a dedicated SQLite table, letting you fetch reactions by message, by user, and view aggregated reaction stats for persistent history and analytics.

Can an automated agent send emoji reactions to specific WhatsApp messages?

Yes, container agents can send emoji reactions to specific messages or the latest message using an exposed MCP tool, enabling agent-initiated reaction support for both group and direct chats.

How do I persist inbound WhatsApp reaction events for my NanoClaw channel?

Inbound WhatsApp reaction events are persisted by applying the skill package and running the included deterministic SQLite migration, which sets up the required database schema and IPC handlers.

Does this WhatsApp reaction skill work for both direct chats and group chats?

Yes, the skill handles reaction support for both group and direct WhatsApp chats, implementing group-scoped IPC authorization to ensure bounded access and correct delivery in multi-user environments.

What happens if an agent-initiated WhatsApp reaction fails to deliver?

The skill implements status tracking with retry and recovery behavior, ensuring that failed agent-initiated reactions are monitored and reattempted for reliable delivery.