A. 定位与元信息（Header 层）

name 是具体的动宾结构（ processing-pdfs / mcp-builder / algorithmic-art ）。description 说清楚三件事：

它做什么（帮模型⼲成哪⼀类真实⼯作）。

何时使⽤ / 如何触发（典型场景 / ⽂件类型 / 关键词）。不做什么（边界、排除项，⽽不是泛泛地“什么都能做ˮ）。

 B. 结构与信息架构（Pattern 层）

skill 明确采⽤了⼀个主结构模式：

流程型： Overview  Workflow / Phases  Step 1,2,3…

菜单型： Overview  Quick Start / Common Tasks  Task groups规范型： Core Principles  Guidelines  Specific Rules  Examples

能⼒清单型： Role / Goals  Capability Map  Capability Items  Combos标题层级清晰，主⼲ 12 层就可以跑通任务。

SKILL.md 只放⾻⼲信息（流程/规范/决策规则/⽰范样例），⼤块细节放在 references/ ，⽤⼀句话 + 链接引⽤。

禁⽌套娃，避免 SKILL.md → advanced.md → details.md 的结构。

 

00 的 Skill Checklist

C. 思维模型与内容质量（How to think）

skill 不是只告诉“要做什么ˮ，⽽是教模型“先怎么想，再怎么做ˮ。

在开头给出⾼级的 framing，把任务从“具体操作ˮ提升到“⽅法论 / 流派ˮ层，⽐如把设计变成“visual movementsˮ，把 server 变成“让 LLM 真正完成任务的⼯程系统ˮ。

在动⼿之前要求模型先思考/规划，⽐如先写哲学/设计论再写代码，先做需求分析 /约束分析 / tradeoff 决策再实现。

对关键决策写出可复⽤维度：

例如算法类：噪声函数、粒⼦⾏为、场、时间、参数、涌现；设计类：排版、⾊彩、动效、留⽩、信息密度；

⼯程类：覆盖率、错误处理、分⻚、可复现、性能。skill 中同时包含：

正向指导（应该怎么做）；

负向禁忌（绝不要怎样，⽐如紫渐变 + Inter + 全居中式 AI slop）。

D. 资源与模板组织（Scripts / References / Assets）

可重复使⽤的代码逻辑放在 scripts/ 。

⼤块的规范 / API / schema / ⽂档放在 references/ 。

模板 / wireframe / HTML / PPT / JSON 样例等放在 assets/ 。

SKILL.md ⾥清楚说明哪些是固定模板 / UI 框架，哪些是可⾃由发挥的变量。

对于前端 / artifact 类 skill，清楚写出初始化脚本（如 init-artifact.sh ）、打包脚本（如bundle-artifact.sh ）、输出⽂件名（如 bundle.html ）。

E. ⼯程性与⼯具设计

00 的 Skill Checklist

⼯具 / 接⼝都有结构化输⼊/输出 schema（Zod / Pydantic / JSON schema），字段有类型、约束 / 枚举、说明、⽰例等。

⼯具命名清晰 ( domain_action_object )，⽅便模型通过名称猜⽤途。

有合理的注解： readOnly / destructive / idempotent / openWorld 等（按具体框架）。错误信息写明发⽣了什么，给出下⼀步建议（重试条件、改参数、换⼯具或找⼈类）。

有针对上下⽂窗⼝的设计：⼤结果分⻚ / 限制条数；

优先返回结构化数据 + 必要⽂本解释。

对 determinism / reproducibility 有要求，例如使⽤ seed / 固定参数（在需要可复现的任务中，尤其是⽣成类）。

F. 审美与创意质量

skill 区分哲学/设计理念和具体实现两个层次：

先写流派/哲学/设计哲学（46 段，覆盖关键维度）；再输出成图⽚/代码/⽂档/布局。

要求概念是“深埋在结构⾥的种⼦ˮ，⽽不是直接写在画⾯上，例如把主题抽象成⾊彩⽐例、动线、参数范围。

有反 AI-slop 的强约束：

禁⽌默认字体组合（Inter/Roboto/Arial 滥⽤）；禁⽌默认紫渐变、全居中卡⽚墙；

禁⽌所有元素统⼀圆⾓、⼀⼑切阴影。

明确要求精修阶段不新增、只“打磨ˮ，例如对⻬、排布、层次、⾊彩细节；对视觉/交互有可检查项：

不 overlap、不出界、有安全边距；动效少⽽精；

00 的 Skill Checklist

⾊板有限且有主副⾊之分。

 G. ⽰例 / ⽤例 / 反例（Few-shot & Anti-shot）

有 25 个⾼质量“⽰范条⽬ˮ：

创意类：每条是 “哲学描述 + 算法/视觉结构翻译ˮ。

⼯程类：每条是 “⽤户⽬标 → 调⽤序列 / ⼯具设计范例ˮ。

有明确的反例（bad patterns），说明反例是什么样的，为什么不接受它。

⽰例中覆盖标准场景、边界场景、带冲突/权衡的场景（⽐如：优先安全 vs 优先效果）。

H. ⾃检与评估（Evaluation & Second Pass）

skill 明确写了“成功的定义ˮ：

对创意类：外观质感、概念是否嵌⼊、可复现性。

对⼯程类：能否完成任务、错误处理是否合理、性能与可维护性。skill 设计了⼀些评测任务 / 测试集：

复杂真实、可验证、有唯⼀答案或明确判定标准。记录⽅式结构化（⽐如 XML / JSON 测试描述）。在输出前，有⼀⼩节“⾃检 checklistˮ：

是否遵守核⼼原则 / 规范？

是否踩到任何禁区（审美/安全/上下⽂浪费）？是否还有可以删减 / 合并 / 精简的部分？