用途：Skill Builder 是一份写作规范，指导如何为 dogfooded-skills 库编写新的智能体技能（skill）。技能是位于 .claude/skills/<skill-name>/SKILL.md 的 Markdown 文件，被调用或项目指令引用时加载进智能体上下文。它不是提示词，而是可执行的操作手册：具体命令、决策表和明确陷阱。技能不是 README、示例合集或配置文件。
目录结构：skills/<skill-name>/SKILL.md 为必需，支持文件（脚本、模板、参考数据）可选。技能名用小写 kebab-case，取最短且无歧义的名字。*-runner 后缀专用于操作侧调度器，在 devbox 外驱动 worker，不内联执行引擎，其引擎名不带后缀。
Frontmatter：必须以 YAML 开头，含 name（与目录名一致）、description（一行、供智能体判断相关性，须以可操作触发语开头，如 “Use when …”“Use to …”“Use as …”）。可选 allowed-tools 白名单，省略则允许全部；requires_worker_skills 仅限 runner，须为内联扁平列表，Pylot 会解析并安装，否则启动失败。
章节顺序：H1 标题为一句话用途；When to Use 触发条件；Prerequisites 前置条件与验证命令；Core Workflow 编号步骤与真实命令、突出决策点；Decision Tables 用表格呈现多路径与风险分级；Error Handling 列出非显而易见故障模式；Critical Rules 可选，列出绝对必须遵守的规则。
质量标准：命令须从真实终端复制，无伪代码，错误处理覆盖三大常见失败，决策点用表格或明确条件，正文面向智能体而非用户，且已对真实工作负载运行至少 5 次。
常见反模式：过于含糊、指示用户而非智能体、缺少“何时不用”场景、把陷阱藏在段落中（应使用 Warning 或加粗）。资料还提供模板，可作为起点。限制：未提供具体价格、平台或效果信息。