XMTP agents
Build event-driven messaging agents on the XMTP network. This skill is the entry point; use the sub-skills below for specific features.
When to apply
- Starting or configuring a new XMTP agent
- Adding behavior: commands, attachments, reactions, groups, payments, inline actions, or address/domain resolution
Sub-skills
| Sub-skill |
Use when |
| building-agents |
Setup, env vars, text/lifecycle events, middleware |
| handling-commands |
Slash commands, validators, message filters, type guards |
| handling-attachments |
Send/receive files, remote attachments, upload storage |
| sending-reactions |
Send or receive reactions, thinking/reply patterns |
| managing-groups |
Create groups, add members, roles, welcome-on-install |
| handling-transactions |
USDC transfers, balance checks, transaction references |
| creating-inline-actions |
Inline actions, confirmation/selection helpers, config menus |
| resolving-domains |
Resolve addresses, Farcaster profiles, extract mentions |
How to use
- Pick the sub-skill that matches the task (e.g. slash commands →
handling-commands).
- Read that sub-skill’s
SKILL.md and its rules/ for step-by-step guidance.
- For SDK or API details, use the xmtp-docs skill (index + specific page fetch).
Quick start
Install the Agent SDK, create an agent from env, handle text, then start:
npm install @xmtp/agent-sdk
Create the agent and handle messages using patterns from building-agents (setup, events, middleware). For commands, attachments, reactions, groups, transactions, inline actions, or resolution, use the corresponding sub-skill above.
1---2name: xmtp-agents3description: Building and extending XMTP agents with the Agent SDK. Use when: (1) creating or configuring an XMTP agent, (2) implementing agent features (commands, attachments, reactions, groups, transactions, inline actions, or domain resolution).4license: MIT5---6
7# XMTP agents
8
9Build event-driven messaging agents on the XMTP network. This skill is the entry point; use the sub-skills below for specific features.
10
11## When to apply
12
13- Starting or configuring a new XMTP agent
14- Adding behavior: commands, attachments, reactions, groups, payments, inline actions, or address/domain resolution
15
16## Sub-skills
17
18| Sub-skill | Use when |
19|-----------|----------|
20| **building-agents** | Setup, env vars, text/lifecycle events, middleware |
21| **handling-commands** | Slash commands, validators, message filters, type guards |
22| **handling-attachments** | Send/receive files, remote attachments, upload storage |
23| **sending-reactions** | Send or receive reactions, thinking/reply patterns |
24| **managing-groups** | Create groups, add members, roles, welcome-on-install |
25| **handling-transactions** | USDC transfers, balance checks, transaction references |
26| **creating-inline-actions** | Inline actions, confirmation/selection helpers, config menus |
27| **resolving-domains** | Resolve addresses, Farcaster profiles, extract mentions |
28
29## How to use
30
311. Pick the sub-skill that matches the task (e.g. slash commands → `handling-commands`).
322. Read that sub-skill’s `SKILL.md` and its `rules/` for step-by-step guidance.
333. For SDK or API details, use the xmtp-docs skill (index + specific page fetch).
34
35## Quick start
36
37Install the Agent SDK, create an agent from env, handle text, then start:
38
39```bash
40npm install @xmtp/agent-sdk
41```
42
43Create the agent and handle messages using patterns from **building-agents** (setup, events, middleware). For commands, attachments, reactions, groups, transactions, inline actions, or resolution, use the corresponding sub-skill above.
modbender