Pulser — SKILL.md 诊断器
针对 Claude Code 的 SKILL.md 检查器，依据 Anthropic 的 7 项原则自动诊断、分级并给出可执行的修复处方。
该技能以本地 CLI 扫描 SKILL.md 为主，输出 JSON 后由 Claude 汇总；修复流程要求先展示 diff 并逐项征得用户确认、通过 Edit 工具修改（避免 CLI --fix），CLI 侧有备份与 pulser undo 回滚，权限声明明确（Bash(pulser *), npx, Read, Edit）。扣分点：未验证 publisher；postinstall 脚本与 npx pulser-cli 意味着运行外部 npm 代码，依赖供应链透明度仅靠 SECURITY.md 声明，未展示依赖锁定或审计。
SKILL.md 流程自洽，含失败场景提示（pulser 未安装时建议全局安装；eval 仅适用于文本型技能、需 claude -p）。扣分点：静态审阅无法复现关键路径；CI 仅做 lint+build，仓库内未提交覆盖诊断/eval 规则的测试套件；JSON 输出结构无样例 schema，异常输入的报错质量不可证。
触发条件写得较精确（check skills / audit skills / pulser 等），对 eval 的适用边界（仅文本型技能、需 Claude Code CLI）有明示。扣分点：示例输出与触发词偏韩语，中英文触发仅部分覆盖；核心分发依赖 npm registry 与 npmjs 包下载，对中国大陆网络可达性存在不确定性，未提供镜像或离线方案。
文档分层清晰：SKILL.md 简洁、README 详细含规则表、安装、退出码、回滚说明；MIT 许可、版本 0.4.0、SECURITY.md、仓库/主页/issue 链接齐全。扣分点：未见 CHANGELOG 与明确维护者响应承诺（仅安全报告 SLA）；'Anthropic Plugin Directory 审核中' 属未证实声明。
核心任务（诊断 8 规则、分类、处方、对话式修复）路径完整且带示例输出，相对手工检查有明显效率增益，备份与回滚降低成本。扣分点：静态审阅无法验证实际输出的正确性与可直接使用性；eval 依赖 claude -p 的成本与稳定性未量化；多处演示输出属营销性截图式内容。
有可审计一手材料：SKILL.md、README、package.、SECURITY.md、CI 工作流，且 CI 覆盖 node 18/20/22 并锁定安装。扣分点：CI 不含测试步骤，诊断规则与 eval 断言无提交的测试或第三方独立复现，评分、处方质量等关键主张仅由作者自述支撑，静态审阅覆盖有限。
- postinstall 脚本与 npx pulser-cli 会执行外部 npm 代码，安装前请自行审查 scripts/postinstall.cjs 与依赖。
- 核心分发依赖 npm registry，中国大陆用户可能遇到下载缓慢或不可达，未提供镜像方案。
- 静态审阅未执行任何代码：诊断评分与 eval 结果的真实质量未经独立复现。
- 修复通过 Edit 工具修改用户技能文件，虽有确认与回滚，仍建议先手动备份 ~/.claude/skills/。
- 发布者未经 FollowSkills 注册表验证，身份不可确认。
这个 Skill 能做什么，适合哪些场景？
Pulser 是一个开源的 SKILL.md 静态检查工具，用于诊断和测试 Claude Code 技能。它扫描技能目录，按 8 条规则（frontmatter、描述、gotchas、allowed-tools、文件大小、结构、触发词冲突、usage-hooks）逐项检查，自动按类型分类每个技能并生成针对性的修复处方。v0.4.0 起还支持 pulser eval，通过 claude -p 对带 eval.yaml 的技能做回归测试。安装时它会把自己注册为 Claude Code 技能，可用自然语言或 /pulser 触发。仓库采用 MIT 许可，提供 npm 包、GitHub Action，并被 Awesome Claude Code Toolkit 收录。
扫描 ~/.claude/skills/（或指定目录）中的 SKILL.md；依据源自 Anthropic 技能最佳实践的 8 条规则逐项诊断；自动分类技能类型（分析、研究、生成、执行、参考）并给出带置信度的评分；输出健康分（如 89/100）、healthy/warning/error 统计和 Top issues；为每条问题生成含模板的修复处方，支持 --fix 自动修复与 pulser undo 回滚；pulser eval 读取技能旁的 eval.yaml，将测试输入经 claude -p 运行并校验断言（contains、starts-with、min-length、matches 等），追踪回归并以退出码区分结果；支持 --format /md 供 CI 使用。
- 维护大量 Claude Code 技能的开发者，想在发布前快速审计技能质量并拿到优先级排序的修复清单
- 团队想把技能质量检查纳入 CI/CD，用 --format 和 --strict 让告警阻断流水线
- 经常改写 SKILL.md 提示词的工程师，想用 eval.yaml 做真实输入的回归测试，防止改坏 formerly-passing 的用例
- 开源技能作者想在 GitHub Marketplace 上提供 linter Action 供用户自查仓库
- 新手写 SKILL.md 时缺少 Gotchas、allowed-tools 等结构，想让工具按 Anthropic 最佳实践给出模板补齐
这个 Skill 有哪些优点和局限？
- 规则直接源自 Anthropic 官方发布的技能最佳实践，处方附模板和理由
- 修复有备份且可一键 undo 回滚，Claude 对话内修复还支持 diff 确认
- eval 功能提供 7 种断言类型和回归追踪，配独立退出码便于 CI 集成
- MIT 开源，提供 npm 包、GitHub Action，并被 Awesome Claude Code Toolkit 收录
- eval 仅适用于文本输出型技能，执行型技能无法测试；且要求本机安装 claude CLI
- allowed-tools 使用 Bash(...) 等 Claude Code 专有 frontmatter 语法，移植到其他平台需改写
- SKILL.md 本身依赖 Edit/Bash 等工具权限，在不具备这些工具的客户端不可用
- README 未提供测试套件、issue 数等质量证据，Anthropic Plugin Directory 收录仍显示 under review
如何安装这个 Skill？
运行 npm install -g pulser-cli。安装时 pulser 会自动把自己注册为 Claude Code 技能。也可通过 GitHub Marketplace 安装 Pulser Action 用于 CI（仓库给出了 marketplace 地址，具体 workflow 写法未在源材料中说明）。
如何使用这个 Skill？
在 Claude Code 中直接说 'check my skills' 或输入 /pulser，即可在对话中查看诊断摘要并确认是否逐条修复。终端中运行：pulser 扫描默认目录；pulser ./my-skills/ 扫描指定目录；pulser --skill reasoning-tracer 检查单个技能；pulser --fix 自动修复（带备份），pulser undo 回滚；pulser --format 或 md 输出报告；pulser eval 运行 eval.yaml 测试。技能注册文件夹遵循 SKILL.md 位于 skill/SKILL.md 的仓库结构。