add-reactions

Add emoji reactions to WhatsApp messages with SQLite storage and MCP tooling.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill adds reliable emoji reaction support to NanoClaw’s WhatsApp channel, so you can receive, persist, search, and send message reactions instead of losing reaction history or needing manual tracking.

Core Features & Use Cases

  • Receive, store, and query reactions: Records reactions in SQLite and supports retrieving recent reaction history.
  • Send reactions via MCP: Allows the container agent to react to a specific message using the react_to_message MCP tool.
  • Message lifecycle signaling: Implements a forward-only emoji state machine with persistence and retry so reaction handling is resilient.

Quick Start

Run the skill’s apply steps in the NanoClaw repository, then validate by reacting to a message on WhatsApp and confirming the latest entries appear in the SQLite reactions table.

Frequently Asked Questions about add-reactions

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

FAQPage Schema
How do I persist WhatsApp emoji reactions in SQLite for agent integration?

Storing WhatsApp emoji reactions in SQLite requires a database migration that creates a reactions table with composite primary keys and indexes, enabling the agent to receive, persist, and search reaction history tied to specific messages.

Can I send WhatsApp emoji reactions from an agent using an MCP tool?

Sending WhatsApp emoji reactions from an agent requires exposing a react_to_message MCP tool via IPC wiring with correct authorization scoping, allowing the container agent to react to specific messages through the WhatsApp integration.

Does the SQLite reaction store support querying historical emoji reactions?

Yes, the SQLite-backed reactions table supports querying historical emoji reactions by leveraging composite primary keys and indexes, allowing operators to verify reaction history and retrieve recent entries tied to specific messages.

What database migration is needed to add emoji reaction support to a chat application?

Adding emoji reaction support requires a database migration that creates a reactions table with composite primary keys and indexes, designed to tie reactions to specific messages and support a forward-only emoji state machine with persistence and retry.

How does the forward-only emoji state machine handle reaction retries?

The forward-only emoji state machine implements persistent state tracking and retry logic for emoji reactions, ensuring resilient reaction handling by storing transitions in SQLite without rolling back previous emoji states during failures.

Do I need IPC wiring to expose the react_to_message tool for WhatsApp reactions?

Yes, IPC wiring is required to expose the react_to_message MCP tool, connecting the container agent to the WhatsApp integration and applying correct authorization scoping to control which messages the agent can react to.