# Skill Optimizer

审查和优化已有 Skill。用于检查技能质量、触发边界、冗余指令或重构技能说明；不用于执行该技能的业务任务。

- Repository: https://github.com/chujianyun/skills (750 stars)
- Category: Engineering
- License: see repository
- Last updated: 2026-10-15
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add chujianyun/skills --skill skill-optimizer -g -a claude-code -y`
Codex: `npx skills add chujianyun/skills --skill skill-optimizer -g -a codex -y`
Cursor: `npx skills add chujianyun/skills --skill skill-optimizer -g -a cursor -y`
Gemini CLI: `npx skills add chujianyun/skills --skill skill-optimizer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add chujianyun/skills`

## Description

审查和优化已有 Skill。用于检查技能质量、触发边界、冗余指令或重构技能说明；不用于执行该技能的业务任务。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Skill Optimizer

用尽量少、确实有效的指令，让 Skill 稳定完成任务。既检查缺失的保障，也检查多余的约束；保留原样可以是合理结论。

## 授权与边界

根据完整对话和适用的仓库规则判断授权，不依赖固定确认词：

- 只问“怎么优化”“先看看”，或尚未授权实施：审查并给出方案，停在建议阶段。
- 已明确授权修改或执行方案：先审查、说明改动范围，再连续完成范围内修改和必要验证，不重复请求同一授权。
- “有道理”“我看看”等评价本身不代表授权。只有授权确实影响下一步且无法从上下文判断时，才问一个简短问题。
- 删除、覆盖、重启、部署、外部写入、付费调用、凭据变更等操作，执行前核实对具体对象和影响的授权；缺少授权时说明影响并确认。优化技能的授权不等于执行目标技能中的业务操作。
- 超出已授权范围的改动另列建议。遵守适用的上层安全规则，不因模型能力提升而取消必要边界。

## 工作流

### 1. 确定范围

定位目标 Skill 的来源与适用仓库规则；有源码仓库时优先修改源文件，再按约定安装。只围绕用户指定方向审查；没有指定方向时，先找最影响使用的几个问题。

明确本轮应交付建议还是修改结果。目标缺失且无法定位时，询问目标；缺少可选信息时采用合理假设并说明。复杂任务按需跟踪进度，不强制复制固定清单。

### 2. 审查并选择资料

先读目标 `SKILL.md`，再读取与本轮问题有关的资源。以下资料按条件选择，不要求每次全部加载：

| 当前问题 | 读取资料 |
|---|---|
| 需要逐项检查触发、授权、依赖或验证行为 | [审查清单](references/review-checklist.md) 的相关部分 |
| 需要决定删减哪些指令、调整流程自由度或拆分结构 | [设计评审框架](references/skill-design-review-framework.md) |
| 需要 Claude 平台的技能编写细节 | [Claude 编写参考](references/skill-creation-best-practices-claude-api-docs.md) 的相关部分；平台限制和旧版本建议需按当前环境核实，不直接套为通用硬规则 |

审查围绕三个问题：目标行为是什么、现有指令哪里妨碍或缺少保障、改变后怎样验证。对于重复规则、通用常识、无条件加载和机械步骤，判断其增量价值；对于领域约束、真实故障经验和必要操作顺序，保留保障。

怀疑触发重叠时才看相关相邻技能的名称与描述，兼容分类目录，不全量读取技能库。发现疑似敏感信息时只报告类型和位置，不回显具体值。

### 3. 给出诊断与方案

简单调整用短段落或列表说明：目标与范围、问题及依据、拟改文件与预期行为、验证方式。没有问题就说明保留理由。

复杂重构再按优先级展开，并在有帮助时说明模式、依赖、风险及范围外建议。每项修改都应能解释收益；不为凑齐模板增加问题、文件或操作。依照上面的授权边界决定实施或结束本轮建议。

### 4. 实施

只修改已授权范围。删除或合并重复、失效、无增量价值的说明，保留有效的领域知识和安全边界。将必须遵守的约束、可靠的默认做法与可自主选择的方法区分清楚。

- 根文档保留必要流程、边界、完成条件和资源路由；细节确实能按需加载时才拆分，并从根文档直接链接。
- README、索引、模板、脚本按实际读者需求和仓库要求添加，不作为每个 Skill 的必备附件。
- 需要稳定重复执行的确定性操作可脚本化；依赖应说明安装、校验和缺失时的处理方式。提供安装命令不代表获得安装或付费授权。
- 未知模型保持通用说明；已知多模型使用时按风险选择代表场景，不以某个模型能力作为删除保障的依据。

### 5. 验证与收尾

检查修改涉及的 frontmatter、名称与目录一致性、触发语义、引用路径、规则冲突和仓库要求。检查真实加载路径是否减少无关内容，而非只比较正文长度。

按改动选择代表场景，验证应触发与不应触发、建议与实施授权、完成条件或失败处理；具体方法见按需加载的审查清单。纯静态审查不能证明运行效果，也不为措辞调整搭建复杂评测。

运行必要检查，修复本次引入的问题，再重跑受影响项。通过后进入收尾，不无理由扩大或重复测试。缺少工具、网络、鉴权或测试环境时，说明未验证项与原因；不得伪造结果或在失败后宣称完成。只读诊断不需要安装依赖；必需输入或授权缺失时暂停依赖它的操作。

完成标准：范围内修改已落实，相关验证有结论，适用且已授权的安装、提交和推送等交付步骤已完成。遇到无法自行解决的失败，报告已完成部分及具体阻塞，不把首版修改当作全部完成。

## 输出契约

The rest: https://github.com/chujianyun/skills/blob/HEAD/skills/skill-optimizer/SKILL.md