# Skill Creator

> 创建、翻译、重构、评审、封装、评测和优化技能时使用。只要用户提到 create skill、build skill、new skill、write SKILL.md、improve skill、refactor skill、package skill、benchmark skill、trigger tuning、description optimization、run skill evals、skill workflow 或要把现有经验沉淀为技能，都应优先使用本技能。它同时负责技能设计流程、长文本拆分策略、评测工具链与触发优化。

- Skill: `caomeiyouren/skill-creator` (Agent Skill, multi-file: 26 files)
- Install (CLI): `npx skillmds@latest add caomeiyouren/skill-creator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/caomeiyouren/skill-creator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: caomeiyouren (https://skillmd.com/u/caomeiyouren)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/caomeiyouren/skill-creator

---


# Skill Creator

铁律：不要再维护第二套技能创建规范。skill-creator 就是唯一的技能设计、重构、评测与打包入口。

## 工作流

- [ ] Step 1: 明确技能目标 ⚠️ REQUIRED
  - [ ] 1.1 提炼用户真正要沉淀的能力边界、触发语句和输出类型。
  - [ ] 1.2 至少收集 3 个真实使用场景，优先从当前对话、历史技能或 git diff 中提取。
  - [ ] 1.3 如果需求本质上是在创建角色、上下文隔离流程或治理型编排者，转交 agent-creator，而不是继续创建 skill。
- [ ] Step 2: 审计现状与文本资产 ⚠️ REQUIRED
  - [ ] 2.1 如果是改造现有技能，先比对 git diff 或提交历史，找出被删掉但仍有价值的规则、示例、术语和资源引用。
  - [ ] 2.2 决定哪些内容保留在主 SKILL.md，哪些拆进 references/，哪些下沉到 scripts/。
- [ ] Step 3: 设计技能架构 ⚠️ REQUIRED
  - [ ] 3.1 先决定 description、铁律、工作流、确认门、反模式和交付前检查。
  - [ ] 3.2 再决定是否需要参数系统、eval、benchmark 和 viewer。
- [ ] Step 4: 编写触发面
  - [ ] 4.1 先写 description，覆盖真实触发语句和近义表达。
  - [ ] 4.2 所有 when-to-use 信息都放在 description，不放在正文。
- [ ] Step 5: 编写 SKILL.md 主体 ⚠️ REQUIRED
  - [ ] 5.1 保持正文精炼，只保留骨架与关键约束。
  - [ ] 5.2 长清单、案例、技巧说明和 schema 拆到 references/。
- [ ] Step 6: 构建资源
  - [ ] 6.1 确定性、可复用操作写入 scripts/。
  - [ ] 6.2 设计方法、长清单和格式定义写入 references/。
  - [ ] 6.3 模板或评审页面等输出资源写入 assets/ 或 eval-viewer/。
- [ ] Step 7: 选择评测模式 (conditional)
  - [ ] 7.1 简单改动可只做人工 review。
  - [ ] 7.2 复杂技能用 references/schemas.md、scripts/run_eval.mjs、scripts/aggregate_benchmark.mjs、scripts/run_loop.mjs 和 eval-viewer/generate_review.mjs 做评测与触发优化。
- [ ] Step 8: 打包与收口 ⚠️ REQUIRED
  - [ ] 8.1 使用 scripts/quick_validate.mjs 做快速结构检查。
  - [ ] 8.2 需要新建技能时，使用 scripts/init_skill.mjs 初始化骨架。
  - [ ] 8.3 需要交付时，使用 scripts/package_skill.mjs 打包。
  - [ ] 8.4 总结保留、迁移、删除和兼容策略。

## 本目录资源

- references/skill-design-overview.md：快速理解技能设计的 12 个核心技巧。
- references/description-guide.md：写 description 前加载。
- references/workflow-patterns.md：设计工作流、确认门和交付检查时加载。
- references/writing-techniques.md：写铁律、问题式指令和反模式时加载。
- references/output-patterns.md：设计输出模板与交付清单时加载。
- references/parameter-system.md：需要参数系统时加载。
- references/architecture-guide.md：规划 references/、scripts/、assets/ 分层时加载。
- references/schemas.md：编写 evals、grading 和 benchmark 数据时加载。
- scripts/init_skill.mjs：初始化技能骨架。
- scripts/quick_validate.mjs：快速校验 frontmatter 与目录结构。
- scripts/package_skill.mjs：打包技能。
- scripts/run_eval.mjs、scripts/aggregate_benchmark.mjs、scripts/run_loop.mjs：评测、聚合和触发优化。
- agents/analyzer.md、agents/grader.md、agents/comparator.md：做 benchmark 分析、断言评分和盲测时加载。

## 正文与 references 的拆分原则

- 放在 SKILL.md：铁律、工作流主干、确认门、反模式、交付前检查。
- 放在 references/：长清单、案例、设计理论、schema、评测说明。
- 放在 scripts/：确定性、重复性高且值得节省 token 的操作。

## 设计原则

- 不要让正文变成第二份 README。
- 不要为了追求完整度把所有内容塞回 SKILL.md。
- 不要只做骨架改写而丢掉原技能里的项目特化规则。
- 不要把 benchmark 当成所有技能的必选项。
- 当需求本质是 agent 时，不要硬塞进 skill-creator 处理。

## 反模式

- 不比对旧版本文本，直接用新模板覆盖一切。
- 同时保留两个 canonical skill，造成职责分叉。
- 只保留抽象流程，不保留有价值的具体规则和术语。
- 只看 benchmark 分数，不看真实输出和用户反馈。

## 交付前检查

- [ ] 已通过 git diff 或历史版本比对回收有价值的旧文本。
- [ ] description 已覆盖触发场景和真实语句。
- [ ] 正文只保留骨架，长文本已合理拆入 references/。
- [ ] 如运行 eval，JSON schema 与目录结构已对齐。
- [ ] benchmark 结果已和真实输出一起分析，而不是只看分数。
- [ ] 当前目录就是唯一 canonical skill 入口。