XMTP

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).

Security Scan

The skill's code and instructions match the XMTP agent purpose, but the manifest claims no required credentials while the runtime docs clearly require and use sensitive environment variables, filesystem writes, and third‑party endpoints — this inconsistency is concerning and deserves caution.

Purpose & Capability

The skill's name and description (

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

1. Pick the sub-skill that matches the task (e.g. slash commands → handling-commands).
2. Read that sub-skill’s SKILL.md and its rules/ for step-by-step guidance.
3. 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.