（14750期）skill-writer – 官方Skill编写规范指南

官方Skill编写规范指南 ClawdHub官方出品的Skill编写指南，提供标准化SKILL.md格式规范与最佳实践，帮助开发者创建高质量、可被Agent正确解析的技能文档。 使用说明 核心用法 skill-writer 是一个纯文档型技能，旨在指导开发者编写符合 ClawdHub/MoltHub 注册表标准的高质量 SKILL.md 文件。该技能系统性地覆盖了从基础格式到高级模式的完整技能开发流程。 主要功能模块包括： 格式规范：详细定义了 SKILL.md 的 YAML frontmatter 结构，包括 name（技能标识符）、description（触发场景描述）、metadata（执行环境要求）三个核心字段的编写规则。 内容组织模式：提供三种典型技能模板——CLI工具参考型、语言/框架参考型、工作流/流程指南型，每种模板都有明确的章节结构和示例。 质量检查清单：包含发布前的8项验证要点，涵盖 frontmatter 有效性、描述质量、代码块完整性、命令可执行性等关键维度。 反模式警示：列举了"过于抽象"、"范围过窄"、"文本墙"、"缺少交叉引用"、"过时命令"等常见错误，帮助开发者规避陷阱。 显著优点 权威性：来自 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）需作者自行测试验证，技能本身不保证命令在各平台的实际可用性 原始说明 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.