ClawdHub 官方技能编写规范与模板库

ClawdHub 官方技能编写指南，提供结构化 SKILL.md 模板与最佳实践，涵盖 frontmatter 规范、内容组织模式、反模式规避及发布清单，适合开发者创建高质量 Agent 可用技能。

基本信息

• 技能名称?Skill Writer
• 中文名称?ClawdHub 官方技能编写规范与模板库
• 作者?gitgoodordietrying
• 分类?专业技能
• 版本?1.0.0
• 标签?documentation, agent-skills, markdown, templates, best-practices, clawdhub, molthub, publishing, yaml-frontmatter

使用方法

使用说明
核心用法
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 行为突变