官方Skill编写规范指南

ClawdHub官方出品的Skill编写指南，提供标准化SKILL.md格式规范与最佳实践，帮助开发者创建高质量、可被Agent正确解析的技能文档。

基本信息

• 技能名称?skill-writer
• 中文名称?官方Skill编写规范指南
• 作者?gitgoodordietrying
• 分类?专业技能
• 版本?v1.0.0
• 标签?docs, development-engineering, productivity, automation

使用方法

使用说明
核心用法
skill-writer 是一个纯文档型技能，旨在指导开发者编写符合 ClawdHub/MoltHub 注册表标准的高质量 SKILL.md 文件。该技能系统性地覆盖了从基础格式到高级模式的完整技能开发流程。
主要功能模块包括：

1. 格式规范 ：详细定义了 SKILL.md 的 YAML frontmatter 结构，包括 name （技能标识符）、 description （触发场景描述）、 metadata （执行环境要求）三个核心字段的编写规则。
2. 内容组织模式 ：提供三种典型技能模板——CLI工具参考型、语言/框架参考型、工作流/流程指南型，每种模板都有明确的章节结构和示例。
3. 质量检查清单 ：包含发布前的8项验证要点，涵盖 frontmatter 有效性、描述质量、代码块完整性、命令可执行性等关键维度。
4. 反模式警示 ：列举了"过于抽象"、"范围过窄"、"文本墙"、"缺少交叉引用"、"过时命令"等常见错误，帮助开发者规避陷阱。
   显著优点
   权威性 ：来自 ClawdHub 官方维护团队，内容直接反映注册表的索引和解析逻辑，确保技能能被 Agent 正确识别和调用
   实用性 ：提供大量可直接套用的模板和代码示例，降低技能编写门槛
   系统性 ：从命名规范到发布流程的全链路覆盖，形成闭环方法论
   量化标准 ：明确给出技能规模的参考指标（300-550行、5-10个章节、15-40个代码块），避免过度设计或内容不足
   潜在缺点与局限性
   生态绑定 ：规范专为 ClawdHub/MoltHub 设计，迁移到其他 Agent 平台需要适配
   动态性不足 ：作为文档型技能，无法根据用户输入动态生成内容，需要人工阅读理解后应用
   版本滞后风险 ：随着注册表功能迭代，部分规范可能过时，需关注官方更新
   学习成本 ：对于不熟悉 YAML frontmatter 或 Markdown 结构化写作的开发者，仍需一定学习时间
   适合的目标群体
   计划向 ClawdHub 注册表贡献技能的开发者
   需要为团队内部构建标准化 Agent 技能库的技术负责人
   希望提升技能文档质量、提高 Agent 调用成功率的技能作者
   从事技术写作、开发者体验（DX）相关工作的专业人员
   使用风险
   依赖项风险 ：技能发布依赖 npx molthub@latest 工具，需确保 Node.js 环境可用
   规范变更风险 ：注册表 frontmatter schema 可能演进，旧版技能可能需要更新
   示例代码风险 ：文档中的 bash/JavaScript/Python 示例虽为教育目的，但直接复制到生产环境前仍需验证
   平台兼容性 ： metadata.os 字段声明的跨平台支持（linux/darwin/win32）需作者自行测试验证，技能本身不保证命令在各平台的实际可用性