Files

gavrielc d572bab5c6 feat: add marketplace skills as local project skills

Move skill definitions from the nanoclaw-skills marketplace plugin
into .claude/skills/ so they're available as unprefixed slash commands
(e.g. /add-whatsapp instead of /nanoclaw-skills:add-whatsapp).

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-03-10 02:25:17 +02:00

2.8 KiB

Raw Blame History

name, description

name	description
add-reactions	Add WhatsApp emoji reaction support — receive, send, store, and search reactions.

Add Reactions

This skill adds emoji reaction support to NanoClaw's WhatsApp channel: receive and store reactions, send reactions from the container agent via MCP tool, and query reaction history from SQLite.

Phase 1: Pre-flight

Check if already applied

Check if src/status-tracker.ts exists:

test -f src/status-tracker.ts && echo "Already applied" || echo "Not applied"

If already applied, skip to Phase 3 (Verify).

Phase 2: Apply Code Changes

Ensure WhatsApp fork remote

git remote -v

If whatsapp is missing, add it:

git remote add whatsapp https://github.com/qwibitai/nanoclaw-whatsapp.git

Merge the skill branch

git fetch whatsapp skill/reactions
git merge whatsapp/skill/reactions

This adds:

scripts/migrate-reactions.ts (database migration for reactions table with composite PK and indexes)
src/status-tracker.ts (forward-only emoji state machine for message lifecycle signaling, with persistence and retry)
src/status-tracker.test.ts (unit tests for StatusTracker)
container/skills/reactions/SKILL.md (agent-facing documentation for the react_to_message MCP tool)
Reaction support in src/db.ts, src/channels/whatsapp.ts, src/types.ts, src/ipc.ts, src/index.ts, src/group-queue.ts, and container/agent-runner/src/ipc-mcp-stdio.ts

Run database migration

npx tsx scripts/migrate-reactions.ts

Validate code changes

npm test
npm run build

All tests must pass and build must be clean before proceeding.

Phase 3: Verify

Build and restart

npm run build

Linux:

systemctl --user restart nanoclaw

macOS:

launchctl kickstart -k gui/$(id -u)/com.nanoclaw

Test receiving reactions

Send a message from your phone
React to it with an emoji on WhatsApp
Check the database:

sqlite3 store/messages.db "SELECT * FROM reactions ORDER BY timestamp DESC LIMIT 5;"

Test sending reactions

Ask the agent to react to a message via the react_to_message MCP tool. Check your phone — the reaction should appear on the message.

Troubleshooting

Reactions not appearing in database

Check NanoClaw logs for Failed to process reaction errors
Verify the chat is registered
Confirm the service is running

Migration fails

Ensure store/messages.db exists and is accessible
If "table reactions already exists", the migration already ran — skip it

Agent can't send reactions

Check IPC logs for Unauthorized IPC reaction attempt blocked — the agent can only react in its own group's chat
Verify WhatsApp is connected: check logs for connection status

2.8 KiB Raw Blame History