skill-writer

skill-writer 是专为设计给自主代理使用的技术文档而开发的核心工具。它标准化了 SKILL.md 文件的创建过程，确保内容能被 ClawdHub 或 MoltHub 等注册表正确索引，并能被基于 LLM 的代理轻松解析。通过强制执行一致的结构模式，该工具协助开发者定义明确的触发场景、元数据和以任务为中心的内容区域，从而显著提升代理的激活率与执行表现。

• 标准化 YAML 前端元数据，包括名称、描述及 clawdbot 元数据模式。

• 提供「何时使用 (When to Use)」模板，以明确代理的激活触发条件。

• 推动以任务为导向的内容结构，取代过于抽象的概念解释。

• 强制执行包含语言标识符与真实数据示例的可运行代码块。

• 定义跨平台支持 (linux, darwin, win32) 及依赖项管理 (requires.anyBins)。

• 在创建新技能时使用此工具，以确保其具备机器可读性并针对向量搜索进行语义优化。

• 极适合作作为 CLI 包装器、自动化脚本及项目级任务运行器的文档编写标准。

• 描述建议采用「做什么。适用于 [触发场景]。」的格式，以优化搜索索引。

• 确保代码块包含输出注释与具体的技术实现，以避免代理执行时的模糊性。

• 在最终发布前，务必使用注册表查询工具验证技能别名 (slug) 是否冲突。

• 务必加入「提示 (Tips)」章节，提供经淬炼的专家建议，让代理在执行过程中能优先参考。