核心用法
xmtp-cli 是一个纯文档型的 Agent Skill，作为 XMTP 官方命令行工具的交互入口。它通过结构化的子技能体系（setup、groups、send、list、debug、sync、permissions、content、debugging）为开发者提供完整的 CLI 操作指南。用户可以通过该技能学习如何初始化环境、发送消息、管理群组权限、同步对话以及调试各类内容类型（文本、Markdown、附件、交易等）。支持通过 npm/pnpm/yarn 全局安装或直接使用 npx 运行，无需编写代码即可与 XMTP 去中心化消息网络进行交互。
显著优点
首先，安全性极高，作为纯 Markdown 文档资产，无任何可执行代码，彻底杜绝了远程代码执行或恶意脚本注入的风险。其次，内容权威，由 XMTP Labs 官方维护，与 docs.xmtp.org 官方文档保持同步，确保命令用法的准确性和时效性。第三，功能覆盖全面，从基础的 init、send 到复杂的 permissions、content types 演示，几乎涵盖了 XMTP 协议的所有核心操作场景。第四，使用灵活，既支持全局安装作为长期工具，也支持通过 npx 临时调用，适应不同的开发和测试环境需求。
潜在局限
该 skill 本身仅为操作指南，实际功能完全依赖外部 @xmtp/cli 工具，用户需要自行安装 Node.js 环境并处理 CLI 的版本兼容性问题。此外，文档中涉及私钥配置（XMTP_WALLET_KEY）等敏感操作，虽然 skill 本身不处理密钥，但用户在使用过程中存在误操作导致密钥泄露的风险。对于需要高度自定义的自动化脚本场景，该 skill 仅提供基础命令参考，无法直接替代脚本开发工作。网络连接是硬性要求，无法在离线环境下使用。
适用人群
主要面向 Web3 开发者、区块链应用工程师以及测试人员，特别是正在集成 XMTP 协议构建去中心化社交、即时通讯或通知系统的技术团队。也适合需要快速验证 XMTP 网络连接、调试消息收发逻辑或演示内容类型的产品经理和技术写作者。对于学习 Web3 通信协议的初学者，该 skill 提供了结构化的入门路径和操作参考。
使用风险
尽管 skill 本身安全，但使用过程中需注意：外部 CLI 工具的版本更新可能导致命令行为变化，建议锁定版本使用；私钥管理完全交由用户侧，务必确保 XMTP_WALLET_KEY 等环境变量不被提交到代码仓库或泄露给第三方；在生产环境操作前，务必确认目标环境（dev/production）配置正确，避免误操作影响真实用户数据；部分命令（如批量发送、权限修改）具有不可逆性，执行前需仔细验证参数和目标地址。