add-skill 是 paldom/stealth-browser-skills 仓库中的一个 Agent Skill 编写工作流，目标是在 skills/<name>/ 目录下以“评测优先”（eval-first）的方式构建一个生产级技能。开始前应每个会话阅读一次 docs/skill-authoring.md 与 docs/evals.md，它们是该工作流执行的规则手册。若以 /add-skill <args> 形式调用，则将 $ARGUMENTS 视为第 1 步中要界定的技能名称或想法。
用途
该技能用于创作或改进本仓库内的单个 Agent Skill，强调先写评测再写技能正文，确保技能针对的是具体、可观察的失败，而非泛泛的能力描述。
不适用场景
创建新的技能仓库：这发生在本仓库之上的工作区中。
基础设施类工作（钩子、CI、校验器、文档）：属于普通编辑，按 PR 级别审查。
仅仅重复模型已经做得很好之事的“技能”：不要构建；技能必须修复某个具体观察到的失败。
工作流
-
范围界定。用一句话说明该技能做什么以及它修复的具体失败。如果这句话需要用到“and”，就拆分为多个技能并逐个完成。检查 skills/ 与 README 目录是否存在重叠——相邻描述会互相抢占触发；调整范围或规划互不重叠的措辞。
-
收集资料。递归阅读 .local/——每个子文件夹和文件都是素材（研究、示例、约束）。然后在其之外做研究：对主题进行网络搜索以获取当前事实、官方文档与既有做法；对任何承重信息对照一手来源核实，并对有争议或高风险的事实（外部 API、模式、安全声明）在可用时用 /cross 交叉验证。技能所依赖的已核实事实放入 skills/<name>/references/ 作为清理后的受跟踪文件——绝不要在技能中引用 .local/ 路径。
-
先写评测。按 docs/evals.md 创建 skills/<name>/evals/evals.json：至少 8 条 should_trigger（变化正式程度、拼写错误、简洁度），至少 8 条 should_not_trigger（共享关键词的近似项），3–5 条质量用例，附带用平实语言表述的 expected_behavior 断言。如果写不出这些，说明范围不清晰——回到第 1 步。
-
起草 SKILL.md。Frontmatter：name 与文件夹名一致；description 单行、第三人称，[what] + [use when …] + [not for …]，150–400 字符，触发关键词放在前约 120 字符内。正文按 docs/skill-authoring.md 的结构：purpose → when/when-not → 编号工作流 → 输出规范 → 注意事项 → 指针。不超过 500 行；确定性步骤写成 scripts/（失败时非零退出）；长材料写成带目录的 references/。
-
校验。make check 必须以 0 退出。写入时钩子已校验过文件；修复它打印的每个错误并分诊每个警告。
-
触发自测。对至少 3 条 should-trigger 与 2 条 should-not-trigger 提示，明确推理：仅凭 description（而非正文）是否会把该提示路由到这里，且相对于目录中其他所有技能？修 description，而不是修评测。建议用户对风险最高的用例运行 2–3 次全新会话探测。
-
注册。在 README 目录表中添加/更新该技能的行，添加 CHANGELOG.md 条目，并把该技能放入恰好一个 skills.sh.json 分组（分组描述用一句有吸引力的话——该文件是仓库的 skills.sh 列表文案）。重新检查同级技能的描述是否出现新的重叠。不要提交或推送——把所有改动留给所有者审阅。
输出规范（完成定义）
skills/<name>/ 包含 SKILL.md + evals/evals.json（按需加 scripts/references）；make check → 0 错误；README 目录 + CHANGELOG 已更新；一份 3 行摘要：用途、触发短语示例、已知限制。
注意事项
description 保持在一个物理行——多行值在某些运行时加载失败，且校验器会阻止；绝不要绕过校验器。不要把失败的评测提示原样粘贴进 description（过拟合）；改为泛化缺失的动词/名词。过度触发的修复方式 = 从实际误报重叠中添加有针对性的“Not for …”名词短语；不要删除正向触发词。模型升级会改变路由——在摘要中注明下次模型发布后应重跑评测。
适用场景
在 skills/<name>/ 下新建生产级技能；为已有技能补充评测；调整技能描述以避免触发冲突；按仓库规则完成技能注册与变更记录。
限制
需遵循仓库的文档与校验流程；description 单行且 150–400 字符；正文不超过 500 行；不得引用 .local/ 路径；不得提交或推送。具体安装命令、收费与价格信息暂未提供。