（12227期）Skill Writer – ClawdHub 官方技能编写规范与模板库

ClawdHub 官方技能编写规范与模板库 ClawdHub 官方技能编写指南，提供结构化 SKILL.md 模板与最佳实践，涵盖 frontmatter 规范、内容组织模式、反模式规避及发布清单，适合开发者创建高质量 Agent 可用技能。 使用说明 核心用法 skill-writer 是 ClawdHub/MoltHub 生态的官方技能编写规范，用于创建标准化、Agent 可消费的 SKILL.md 文件。其核心功能是提供一套完整的技能文档模板体系，包括： Frontmatter 规范：强制包含 name（slug 标识）、description（语义搜索优化的触发描述）、metadata.clawdbot（emoji、依赖工具、支持平台） 内容结构模板： 质量检查清单：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 行为突变 原始说明 Write high-quality agent skills (SKILL.md files) for ClawdHub/MoltHub. Use when creating a new skill from scratch, structuring skill content, writing effective frontmatter and descriptions, choosing section patterns, or following best practices for agent-consumable technical documentation.