Skill Writer

核心用法

skill-writer 是 ClawdHub/MoltHub 生态的官方技能编写规范，用于创建标准化、Agent 可消费的 SKILL.md 文件。其核心功能是提供一套完整的技能文档模板体系，包括：

1. Frontmatter 规范：强制包含 name（slug 标识）、description（语义搜索优化的触发描述）、metadata.clawdbot（emoji、依赖工具、支持平台）
2. 内容结构模板：

3. 质量检查清单：300-550 行目标长度、每节至少一个代码块、5-10 条实战 Tips、语义化版本控制

• CLI 工具参考模板：适用于单一命令族（如 docker、git）
• 语言/框架模式模板：适用于编程范式（如 React Hooks、Python 装饰器）
• 工作流/流程模板：适用于多步骤操作（如部署流水线、数据迁移）

显著优点

• Agent 优先设计：描述字段直接用于向量嵌入检索，"When to Use" 章节明确触发场景，降低 Agent 误激活率
• 实战导向：强制要求可运行的代码示例，禁止纯理论描述；提供多语言对比（Bash → JavaScript → Python）
• 发布即生产：内置 npx molthub@latest publish 完整工作流，含 slug 查重、YAML 校验、依赖工具声明
• 反模式清单：明确标记"过于抽象""代码墙""范围过窄"等常见陷阱，配套修复示例

潜在局限

• 平台绑定：专为 ClawdHub 生态设计， frontmatter 的 metadata.clawdbot schema 不具备跨平台通用性
• 长度刚性：300 行下限要求对简单工具（如单命令 alias）可能造成过度工程
• Node.js 依赖：发布工具链依赖 npx，Windows 原生环境需额外配置

适合人群

• ClawdHub 技能贡献者
• 需要为内部 Agent 系统创建结构化知识库的 DevOps/平台工程师
• 技术文档工程师（学习 Agent-Consumable 文档写作范式）

常规风险

• 描述字段 SEO 失效：若未包含用户实际搜索的关键词（动词+名词组合），技能将难以被 Agent 检索到
• 依赖工具漂移：requires.anyBins 声明与实际命令不匹配时，Agent 可能在无工具环境执行失败
• 版本管理疏忽：重大重构未升级 major version 可能导致下游 Agent 行为突变

Skill Writer 综合评估

核心用途

Skill Writer 是一个元技能（meta-skill），用于创建符合 ClawdHub/MoltHub 注册表规范的高质量 SKILL.md 文件。它本身不执行具体任务，而是教会 AI Agent 如何编写可被其他 Agent 消费的技术文档。

显著优点

1. 格式规范详尽

提供了完整的 frontmatter YAML 架构说明，包括 name 命名规则、description 优化模式、以及 metadata.clawdbot 的精确字段定义。这对确保技能在注册表中被正确索引至关重要。

2. 内容结构模板化

针对不同技能类型（CLI 工具、语言/框架、工作流指南）提供了可复用的模板，大幅降低新技能编写门槛。特别是强调"按任务组织而非按概念组织"的原则，契合 Agent 检索执行指令的实际需求。

3. 实用主义导向

明确要求每个代码块必须可运行、每个示例必须真实、避免 foo/bar 等占位符。这种务实风格提升了技能的落地价值。

4. 反模式清单完整

列出 "太抽象"、"太狭窄"、"文本墙无示例"、"过时命令" 等常见问题，帮助开发者自我审查。

5. 量化规模指南

提供行数、章节数、代码块数的具体区间建议（300-550 行、5-10 章节、15-40 代码块），对技能拆分决策有指导意义。

潜在局限

• 生态依赖性：技能价值完全取决于目标平台（ClawdHub/MoltHub）的存续与演进，若平台规范变更，此技能需同步更新。
• 无动态验证：仅提供编写规范，不包含对生成技能的自动化验证工具（如 schema 校验、命令可执行性测试）。
• 语言局限：示例以 Bash 优先，对其他语言生态（如 Windows PowerShell、Rust Cargo 工作流）覆盖深度可能不足。
• T3 来源风险：认证报告明确标识为个人/社区项目（Trust Level T3），非 Anthropic 官方背书，长期维护稳定性依赖社区。

适合人群

• 需要向 ClawdHub/MoltHub 贡献技能的开发者
• 希望标准化团队内部 Agent 技能文档的技术负责人
• 学习如何编写 "Agent 可消费" 技术文档的写作人员

常规风险

• 规范过时风险：MoltHub CLI 工具版本迭代可能导致发布命令示例失效。
• 过度标准化风险：严格遵循模板可能抑制针对特定领域的灵活表达。
• 版本碎片化：技能版本与平台索引版本的同步管理需要人工注意。

安全认证亮点

获得 S 级评分（100/100），纯文档属性使其成为零攻击面技能的理想范例。