用途：指导如何为命令行工具编写 agent skill，核心原则是动手使用工具而非只读文档。
主要能力与流程：先安装并试用工具，对每个子命令运行 --help，亲自尝试常见操作，记录意外或不明显之处；若工具不可用，可用 WebFetch 查阅官方文档和 man 手册，但需在 skill 中标注“未经实操验证”。随后复制 references/template.md 到新 skill 目录，按实操经验填写章节，删除不适用部分。
安装方式（按工具而定）：Claude Code 使用 ln -s "$PWD/skills/my-tool" ~/.claude/skills/my-tool；OpenCode 使用 ln -s "$PWD/skills/my-tool" ~/.config/opencode/skills/my-tool；Clawdbot 使用 ln -s "$PWD/skills/my-tool" ~/clawd/skills/my-tool。
章节要求：必需项为 Frontmatter（name、含触发短语的 description）、Installation、Usage；推荐项包括 Requirements、Quick Start、Output Formats、Tips & Gotchas、Troubleshooting、Configuration、Uninstall、References。命令按任务分组（查看/列表、创建/添加、编辑/更新、删除/移除、搜索），而非按命令名。
限制与禁忌：不要逐字转储 --help 输出，不要记录每个 flag，只聚焦 80% 用例；不要包含未测试的命令；不要超过 500 行，以免膨胀 agent 上下文窗口。采用渐进式披露，将细节移入 references/。发布前按清单检查：frontmatter、安装覆盖目标平台、含验证命令（tool --version）、配置文件位置、必需环境变量、常见操作、真实示例与输出、输出格式、调试模式、卸载清理、行数限制。
适用场景：创建或审查封装 CLI 工具的 agent skill。