xmtplabs/handling-commands
skills/handling-commands/SKILL.md
Patterns for handling commands, validating input, and filtering messages in XMTP agents. Use when implementing slash commands, validators, or message filters. Triggers on command handling, input validation, or type guards.
$ install --global
skillsauthnpx skillsauth add xmtplabs/xmtp-agent-examples handling-commandsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 25, 2026, 2:46 PM13.6s4 files scanned
SKILL.md
- name:
- handling-commands
- description:
- Patterns for handling commands, validating input, and filtering messages in XMTP agents. Use when implementing slash commands, validators, or message filters. Triggers on command handling, input validation, or type guards.
- license:
- MIT
- author:
- xmtp
- version:
- 1.0.0
XMTP commands and validation
Best practices for handling commands, validating input, and filtering messages.
When to apply
Reference these guidelines when:
- Implementing slash commands
- Validating hex strings and addresses
- Filtering message types
- Using type guards instead of type assertions
Rule categories by priority
| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Validators | CRITICAL | validators- |
| 2 | Filters | HIGH | filters- |
| 3 | Type Guards | HIGH | guards- |
Quick reference
Validators (CRITICAL)
validators-hex- Use validHex() for hex string validationvalidators-address- Validate Ethereum addresses
Filters (HIGH)
filters-message-types- Filter by message type (SDK 2.0+: use direct importsisText,isReaction,isReply, etc. from@xmtp/agent-sdk; keepfilter.fromSelf,filter.hasDefinedContent)filters-sender- Filter out self-messagesfilters-content- Check for defined content
Type Guards (HIGH)
guards-codec- Use usesCodec() instead of type assertionsguards-content-type- Use filter helpers for type safety
How to use
Read individual rule files for detailed explanations:
rules/validators-hex.md
rules/filters-message-types.md
rules/guards-codec.md
Related Skills
xmtplabs/sending-reactions
development
VerifiedTrustedCommunity
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.
51SKILL.mdUpdated Apr 25, 2026
xmtplabs/resolving-domains
development
VerifiedTrustedCommunity
ENS and Web3 identity resolution for XMTP agents. Use when resolving domain names, extracting mentions, or fetching Farcaster profiles. Triggers on ENS resolution, Farcaster lookup, or mention extraction.
51SKILL.mdUpdated Apr 25, 2026
xmtplabs/managing-groups
data-ai
VerifiedTrustedCommunity
Group conversation management for XMTP agents. Use when creating groups, managing members, setting permissions, or sending welcome messages. Triggers on group creation, member management, or permissions.
51SKILL.mdUpdated Apr 25, 2026
xmtplabs/handling-transactions
data-ai
VerifiedTrustedCommunity
Token transactions and wallet integration for XMTP agents. Use when sending USDC, creating transaction requests, or handling transaction confirmations. Triggers on USDC transfer, wallet calls, or transaction reference.
51SKILL.mdUpdated Apr 25, 2026