用途:在 Skill Steward 市场的 skills/ 目录下添加、评审并校验可安装的技能包。触发场景包括用户希望在此仓库新增技能、评审某个技能、询问 SKILL.md 是否有效、为兼容 npx skills 而引导生成 SKILL.md,或 PR 触及 skills/*/SKILL.md。
创建流程:先核实意图是否与现有技能重叠(同一高层目标或同一生命周期的两半应合并);收集 2–3 条应触发该技能的用户提示及 1 条不应触发的提示;规划所需资源(仅说明、scripts/、references/、assets/);选择 kebab-case 名称(1–64 字符);创建 skills/{name}/ 目录(目录名须与 frontmatter 中 name 一致);从模板 templates/skill/SKILL.md 复制并替换占位符;编写简明的 description(what 与 when);从模板建立 references/sources.md 并登记所用规范、仓库、论文;正文采用编号步骤、示例与输出格式,控制在 500 行内;行为关键型 T1 技能需 references/evals.md 与至少 2 个 evals/cases/*.yaml;仅在需要时添加 agents/openai.yaml 及 scripts/、references/、assets/,并删除占位资源;随后在 skills.sh.json 添加技能 id、在根 README.md 技能表添加一行;对复杂或易碎流程用全新子代理进行前向测试,验证提示中不得泄露预期答案。
评审清单:检查技能完整性(覆盖完整流程、机制与规则并置)、结构(目录名与 name 一致、文件名为 SKILL.md、技能文件夹内不放 README.md)、frontmatter(name 规则、description 1–1024 字符、license、metadata.version 与 author、必要时填写 compatibility)、正文(编号工作流、约 500 行内、相对链接一层深、references/sources.md 提供 URL、记录安装命令 npx skills add arenukvern/skill_steward --skill <name>)、脚本规范(shebang、bash 用 set -euo pipefail、日志走 stderr 输出走 stdout、代表性脚本已实际运行或记录跳过原因)、注册表(skills.sh.json 含 id、README 表含行、pnpm run validate 通过)、T1 行为关键型需 evals 与 pnpm run eval。
弃用与重命名:不保留永久墓碑技能,重命名或合并视为破坏性变更,用 Changesets 沟通。流程为 rm -rf 旧技能目录、从 skills.sh.json 与 README.md 移除旧项、用 pnpm changeset 生成变更集或手动创建 .changeset/skill-consolidation.md 说明移除原因与替代技能。评审输出格式为 Summary(pass 或 needs changes)、Errors(blocking)、Warnings。安装命令:npx skills add arenukvern/skill_steward --skill skill-authoring-lifecycle。研究时遵循 skill-source-citations。