Create Clear Skill Files（YYH211）— SKILL.md 模板与审查清单

技能简介

Create Clear Skill Files 是 YYH211 开源的技能编写助手，专门解决"Agent Skill 写出来了但触发不准、结构混乱、示例缺失"的常见问题。它提供一整套 SKILL.md 编写模板与质量审查清单，覆盖基础型技能模板和工作流型技能模板两类骨架，并附上强设计与弱设计的对照示例，帮助作者一眼看出自己技能的问题所在。该技能已通过 Skillstore 完整审计，风险等级为 safe，适合任何需要编写、改造或评审 Claude / Codex / Claude Code 技能文件的个人与团队。

核心能力

• frontmatter 规范讲解：逐项说明 SKILL.md 头部必填字段的含义与填写方式，避免 Agent 因元数据缺失而加载失败。
• 命名与描述规则：给出技能名称和 description 的具体写法，让触发词能真正匹配用户的真实请求。
• 双模板骨架：提供基础技能模板与工作流技能模板，作者可按"单点能力"或"多阶段流程"两种形态直接套用。
• 强弱设计对照：用正面与反面示例展示什么才是合格的技能设计，比纯理论文档更直观。
• 质量检查清单：从结构完整性、示例可用性、边界清晰度、文档可维护性四个维度给出发布前自检项。

安装配置

• Skillstore CLI 一键安装：终端运行 npx skillstore add yyh211/create-skill-file 即可拉取已审计的最新版本。
• 手动克隆安装：从 GitHub 仓库 YYH211/Claude-meta-skill 的 create-skill-file 目录复制到目标 Agent 的技能目录。
• 多工具适配：技能面向 Claude、Codex、Claude Code 三类工具设计，安装后按各自技能路径（如 ~/.claude/skills/）加载即可。
• 依赖说明：技能本体为纯 Markdown 指导型，无强制外部依赖；技能标记了 external_commands、env_access、network 风险因素，建议人工确认后再允许执行类操作。

使用步骤

1. 明确技能任务：先确定这个技能要解决哪个重复性任务，以及用户会用什么自然语言请求它。
2. 套用模板起草：选择基础模板或工作流模板，填写 frontmatter、触发场景、工作流步骤与至少两个示例。
3. 对照强弱示例自检：把初稿与技能包内的强/弱设计范例比对，修正模糊描述与缺失示例。
4. 改写名称与描述：用具体触发短语替换泛泛措辞（如 helper、utility），确保 Agent 能在正确时机激活。
5. 跑质量检查清单：逐条核对结构、示例、边界、维护性四个维度，补齐脚本与外部命令的边界声明。
6. 安装验证：在 Claude Code 或 Codex 中实际发起触发请求，确认技能按预期激活后再分享给团队。

适用场景

• 从零新建技能：第一次给 Agent 写 SKILL.md，需要现成骨架避免漏字段。
• 提升技能可发现性：技能已存在但经常不触发，用命名与描述规则重写激活文案。
• 技能质量评审：团队内互相评审技能时，用统一清单检查结构与示例是否达标。
• 技能库体检：批量比对多个技能的重叠、命名冲突与触发歧义，决定合并或拆分。
• 工作流型技能设计：把多阶段流程（含决策点、成功标准、失败处理）封装成可复用技能。

适用人群

• Agent 技能作者：正在为 Claude / Codex 编写第一批技能的开发者。
• 团队技术负责人：需要统一团队技能规范、建立评审标准的管理者。
• 内部工具维护者：维护公司技能库、需要定期体检存量技能的工程师。
• AI 工作流爱好者：希望把个人重复任务沉淀成技能的效率型用户。

工作原理

该技能采用"模板 + 清单 + 对照示例"三段式方法：首先用结构化模板保证 SKILL.md 的骨架完整（frontmatter、触发场景、步骤、示例一个不少）；其次用质量清单把"结构、示例、边界、维护性"这类人工容易漏检的项目变成可逐条核对的检查项；最后用强弱设计对照让作者建立直觉判断。它本质上是把成熟技能作者的评审经验固化成可执行的写作流程，因此产出的技能在触发准确度和可维护性上明显优于随手编写。需要注意它只提供指导，不自动执行校验，也不代为创建文件，最终产物仍需作者在真实 Agent 中激活测试。

官方链接

• Skillstore 页面：https://skillstore.io/skills/yyh211-create-skill-file
• GitHub 仓库：https://github.com/YYH211/Claude-meta-skill/tree/main/create-skill-file
• Manifest：https://skillstore.io/api/skills/yyh211-create-skill-file/manifest
• 安装命令：npx skillstore add yyh211/create-skill-file