XMTP reactions

SkillCommunication

Emoji reactions and thinking indicators for XMTP agents. Use when adding reactions to messages or showing processing state with thinking emoji. Triggers on emoji reactions, thinking indicator, or message acknowledgment.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the XMTP reactions skill

What this skill tells your AI

The instructions your AI receives, as published by xmtplabs/xmtp-agent-examples in skills/sending-reactions/SKILL.md and read by ahel’s review.

Send and receive emoji reactions, including thinking indicator patterns.

When to apply

Reference these guidelines when:

  • Reacting to user messages with emoji
  • Showing processing/thinking state
  • Receiving and handling reactions
  • Implementing acknowledgment patterns

Rule categories by priority

PriorityCategoryImpactPrefix
1SendHIGHsend-
2ReceiveHIGHreceive-
3PatternsMEDIUMpatterns-

Quick reference

Send (HIGH)

  • send-reaction - Send emoji reactions to messages

Receive (HIGH)

  • receive-reaction - Handle incoming reactions

Patterns (MEDIUM)

  • patterns-thinking - Thinking indicator pattern

Quick start

// Send a reaction
await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "added",
  content: "👍",
  schema: "unicode",
});

// Thinking indicator pattern
await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "added",
  content: "⏳",
  schema: "unicode",
});

// Process...

await ctx.conversation.sendReaction({
  reference: ctx.message.id,
  action: "removed",
  content: "⏳",
  schema: "unicode",
});

How to use

Read individual rule files for detailed explanations:

rules/send-reaction.md
rules/receive-reaction.md
rules/patterns-thinking.md

Signals

GitHub stars
54
Forks
23
Last commit
Feb 2026
Advanced
Catalog kind
skill
Gateway key
sending-reactions
Source
github.com/xmtplabs/xmtp-agent-examples