Standard Skill Maker

标准 Skill 制作器

把一个模糊需求，变成窄场景、可触发、可扩展、可验证的高质量 Codex / Agent Skill。

安装 · 触发方式 · 它会交付什么 · 文件结构 · 验证 · English

---

这是什么

Standard Skill Maker 是一个帮助 Agent 制作 Skill 的 Skill。

它不是让 Agent 写一段更长的提示词，而是强制回到标准 Skill 的基本方法：

窄任务 + 清晰触发条件 + 可执行流程 + 按需资源 + 验证闭环

当用户说“帮我做一个 Skill”“把这个流程沉淀成 Skill”“帮我写 SKILL.md”“做一个扩展性好的 Skill”时，它会先判断需求是否过宽，再用少量关键问题收窄范围，最后生成可维护的 Skill 文件夹。

它解决什么问题

很多 Skill 做坏，不是因为内容少，而是因为一开始就把它写成了“万能助手”：

• description 触发条件不清楚，Agent 不知道什么时候该用；
• SKILL.md 堆了太多背景材料，真正流程反而不明显；
• 脚本、参考资料、模板混在一起，没有 progressive disclosure；
• 没有验证方式，做完以后不知道是否真的可用；
• 没有说明什么情况不该触发，导致误触发。

这个 Skill 专门解决这些问题。

安装

如果你的 Agent 支持从 GitHub 安装 Skills，可以使用：

npx skills add GZ-L/standard-skill-maker -s standard-skill-maker -g

也可以手动复制：

skills/standard-skill-maker/

到你的本地 Skills 目录。

安装后第一句话

请使用 standard-skill-maker，帮我把这个需求做成一个标准、扩展性好、可验证的 Skill。先判断范围是否太大，如果需要请先问我关键问题，再生成 SKILL.md、必要 references/scripts，以及验证方式。

触发方式

这些话都适合触发它：

• “帮我做一个 Skill”
• “创建一个 Codex Skill”
• “帮我写 SKILL.md”
• “把这个工作流沉淀成 Skill”
• “做一个标准 Skill”
• “这个 Skill 怎么设计得更扩展”
• “检查这个 Skill 是否符合规范”

不适合触发它的情况：

• 普通一次性提示词优化；
• 不需要复用的单次任务；
• 和 Skill 无关的应用功能开发；
• 用户只是想让 Agent 直接完成任务，而不是把任务包装成 Skill。

它会交付什么

一个标准 Skill 文件夹，通常包括：

• SKILL.md：必需，包含 frontmatter 和核心执行流程；
• agents/openai.yaml：推荐，包含展示名、短描述和默认提示；
• references/：可选，放问题库、质量标准、长文档、示例；
• scripts/：可选，放确定性检查或重复执行脚本；
• assets/：可选，放模板、图片、示例文件或样板项目。

它会避免把所有东西塞进 SKILL.md，而是按 progressive disclosure 组织内容。

文件结构

standard-skill-maker/
├── README.md
├── LICENSE
├── .claude-plugin/
│   └── marketplace.json
└── skills/
    └── standard-skill-maker/
        ├── SKILL.md
        ├── README.md
        ├── agents/
        │   └── openai.yaml
        ├── references/
        │   ├── question-bank.md
        │   ├── quality-rubric.md
        │   └── skill-blueprint.md
        └── scripts/
            └── validate_skill.py

设计原则

• 先定义窄任务，不做“万能 AI 助手 Skill”。
• 把触发条件写进 frontmatter description，因为这是 Agent 决定是否加载 Skill 的入口。
• SKILL.md 只放核心流程和资源路由。
• 长文档、示例、问题库、质量标准拆到 references/。
• 只有在需要确定性、可重复、格式转换或校验时才写 scripts/。
• 每个 Skill 都必须有验证方式。

验证

验证 Skill 本体：

python3 skills/standard-skill-maker/scripts/validate_skill.py skills/standard-skill-maker

如果你本地有 Codex 的 skill-creator 校验器，也可以运行：

python3 "${CODEX_HOME:-$HOME/.codex}/skills/.system/skill-creator/scripts/quick_validate.py" skills/standard-skill-maker

English

Standard Skill Maker helps agents turn vague requirements into focused, triggerable, extensible, and verifiable Codex / Agent Skills.

Install:

npx skills add GZ-L/standard-skill-maker -s standard-skill-maker -g

Then ask:

Use standard-skill-maker to turn this workflow into a focused, standards-aligned Skill. Ask only the key questions needed, then create SKILL.md, optional references/scripts, and validation steps.