爆款Skill的五个写法配方

概述：热闹之下的分水岭

刚过去这一周，Skill 生态的热度还在陡峭爬升：近两周新上架的仓库里，破千星的已有七座——anatomy 一座就冲到 16000+ 星，huashu-art-motion 拿下 4399 星，CCBaga 2662 星，new-term-radar、Tracely-ai、founder-skill 也在千星线上站稳。加上此前 anatomy 登顶与艺术动画 Skill 的爆发，技能榜已经进入批量产爆款的时代。

但热闹是作者的，大多数读者自己动手写 Skill 时，仍然按写 README 的思路来：一段简介、几条用法、结束。这次我把官方四份最具代表性的 SKILL.md 原文——pdf、brand-guidelines、frontend-design、webapp-testing——逐行拆开，得到的结论是：爆款与陪跑的分野不在功能多少，而在五个写法配方——路由怎么写、脚本怎么写、红线怎么写、负面清单怎么写、品味怎么数值化。文中所有引文均出自原文，文末附一具可照抄的骨架模板。

本周新面孔速览

在进入拆解前，先记下几个值得观望的新仓库（数据来自 GitHub API，星数为抓取当日快照）：

这批新仓库的共同点很说明问题：没有一个是在“介绍功能”，全都在 prescribing（规定）Agent 的行为。这正是下面五个配方的主题。

拆解对象与评分

*上手难度分越高代表越容易上手。

四份原文有一个共同的气质：它们不是文档，是岗位说明书。Agent 读完后不需要“理解”什么，只需要照着执行。下面逐条拆配方。

配方一：开头十行决定生死——描述是路由，不是简介

SKILL.md 的 frontmatter 描述是 Agent 判断“要不要唤起我”的唯一依据，相当于函数签名。四份原文给了三种流派的示范：

pdf 用场景句，开头一节就叫 When to use，三条全是动词开头的使用场景："Read or review PDF content where layout and visuals matter"、"Create PDFs programmatically with reliable formatting"、"Validate final rendering before delivery"。读、造、验，三个触发面一次铺满。

brand-guidelines 堆关键词，Overview 里直接一行 **Keywords**: branding, corporate identity, visual identity, post-processing, styling, brand colors, typography...，十个词全是用户可能说出口的原话。这是最古老也最有效的词面匹配路由。

webapp-testing 用一句话论点，正文第一行就是全文纲领："To test local web applications, write native Python Playwright scripts."——做什么、用什么做，一句说完，连章节都省了。

三种流派的共同点：写“何时用我”，不写“我是什么”。新手最常见的错误是把描述写成产品故事（“本 Skill 是一个强大的工具……”），而路由匹配发生在用户说“帮我把这个报告转成 PDF”的瞬间，描述里必须有这句问话的影子。

配方二：能写脚本的别写散文——把确定性装进黑盒

webapp-testing 里最值得抄的一段，是它对辅助脚本的“禁读令”：

Always run scripts with --help first... DO NOT read the source until you try running the script first and find that a customized solution is absolutely necessary. These scripts can be very large and thus pollute your context window. They exist to be called directly as black-box scripts rather than ingested into your context window.

这一段在教一件反直觉的事：Skill 作者要替 Agent 管理上下文预算。服务器启停、端口等待这类确定性杂务，全部塞进 scripts/with_server.py，SKILL.md 只给一条调用命令：

python scripts/with_server.py --server "npm run dev" --port 5173 -- python your_automation.py

pdf 同样是脚本优先：正文 Workflow 只有四步，第二步直接指定“用 reportlab 生成、用 pdfplumber 抽文本”，并且写明了依赖自举的降级链——优先 uv pip install reportlab pdfplumber pypdf，uv 不在就退回 python3 -m pip install，系统级工具（poppler）则按 macOS/Homebrew 与 Ubuntu/apt 分别给命令。最后还补了一句体面的兜底："If installation isn't possible in this environment, tell the user which dependency is missing and how to install it locally."

配方要点：概率性的判断留给文字，确定性的步骤交给脚本；每个依赖给主选和降级两条路；把“装不了就报告缺什么”写成显式指令。这三句话能消灭你 Skill 里 80% 的翻车。

配方三：把判断写成决策树，把验收写成红线

webapp-testing 的正文里嵌着一棵完整的 ASCII 决策树：静态 HTML？→ 直接读文件找 selector；动态应用？→ 服务起没起？→ 没起就跑 with_server.py……Agent 按图索骥，不需要临场发挥。树下面还压了一对红绿反例：

❌ Don't inspect the DOM before waiting for networkidle on dynamic apps ✅ Do wait for page.wait_for_load_state('networkidle') before inspection

pdf 则把功夫花在验收端。它的 Workflow 第一步就是“把 PDF 页面渲染成 PNG 逐张目检”，第四步要求"After each meaningful update, re-render pages"，而 Final checks 一节更是把交付标准钉死：

Do not deliver until the latest PNG inspection shows zero visual or formatting defects.

更有意思的是它的缺陷清单："clipped text, overlapping elements, broken tables, black squares, or unreadable glyphs"——黑方块、裁切文字、重叠元素，每一条都是真实翻车现场留下的化石。最能体现“从战场学来的规则”气质的是这条：

Use ASCII hyphens only. Avoid U+2011 (non-breaking hyphen) and other Unicode dashes.

一个不起眼的 Unicode 连字符能把排版打穿，于是作者把它写成了铁律。好的红线从来不是设计出来的，是你被同一块石头绊倒两次之后刻下的。

配方四：负面清单是品味的护城河

frontend-design 是四份原文里唯一一份通篇在“管审美”的 Skill，它的核心武器是负面清单。先给正面方向——列出 brutally minimal、maximalist chaos、retro-futuristic、brutalist 等十来种极端风格供选择，然后一笔兜底：

Bold maximalism and refined minimalism both work - the key is intentionality, not intensity.

紧接着是那条著名的 NEVER 段：

NEVER use generic AI-generated aesthetics like overused font families (Inter, Roboto, Arial, system fonts), cliched color schemes (particularly purple gradients on white backgrounds), predictable layouts and component patterns...

还有一句更狠的："NEVER converge on common choices (Space Grotesk, for example) across generations"——连模型自己用顺手的“安全牌”字体都被点名封印，因为它观察到：不加约束的 Agent 会在一次次生成里收敛到同一套平庸。

这背后的原理值得每个 Skill 作者记住：模型的默认输出就是概率意义上的最大公约数，也就是平庸本身。正面清单告诉它“可以做什么”，负面清单直接压掉“最可能做的那些坑”。pdf 的黑方块清单、webapp-testing 的 ❌ 反例，本质上都是同一配方在不同领域的变体。

配方五：把品味翻译成数字与降级路径

brand-guidelines 是四份里功能面最窄的，但它在教学意义上无可替代：它示范了怎么把“品牌感觉”这种玄学数值化成 Agent 可执行的 token。颜色不是“克制的暖色调”，而是精确到：

• Dark: #141413（正文与深底）
• Light: #faf9f5（浅底与反白）
• Orange: #d97757（主强调）、Blue: #6a9bcc、Green: #788c5d

字体不是“有品质感的衬线”，而是"Headings: Poppins (with Arial fallback)、Body Text: Lora (with Georgia fallback)"——每一项都自带降级路径，并明确写了"Automatically falls back to Arial/Georgia if custom fonts unavailable"、"No font installation required"。甚至强调色的使用顺序都被规定为“非文字形状在橙、蓝、绿间循环，保持视觉趣味的同时留在品牌内”。

frontend-design 的"Use CSS variables for consistency"、pdf 的目录卫生规范（中间产物进 tmp/pdfs/，完事删除；成品进 output/pdf/），都是同一路配方的变体：凡是能变成数字、路径、变量、色号的，就不要留在形容词里。形容词会被重新随机解释，数字不会。

一枚 Skill 的完整生命周期

把五个配方串起来，就是一枚设计良好的 Skill 在 Agent 里的完整一生：

flowchart TD
    A[用户请求进来] --> B{frontmatter 描述命中?}
    B -->|命中| C[载入 SKILL.md 正文]
    B -->|不命中| D[Skill 保持沉默]
    C --> E{任务类型?}
    E -->|确定性步骤| F[调 scripts 黑盒脚本]
    E -->|品味决策| G[查负面清单与数值token]
    F --> H[产出初稿]
    G --> H
    H --> I{红线验收清单}
    I -->|有缺陷| H
    I -->|全绿| J[交付]

注意回边：初稿到验收之间那条“有缺陷→回炉”的循环，正是 pdf 用"re-render after each meaningful update"和"Do not deliver until zero defects"硬造出来的。没有这条回边的 Skill，只算了一段提示词；有这条回边的，才算一个闭环系统。

手把手：照抄这具骨架

综合五个配方，你的第一枚 Skill 可以直接从这个骨架开始填：

---
name: 动宾结构命名（如 invoice-checker）
description: 一句话写清做什么 + 何时唤起（写触发场景，别写背景故事）
---

# 技能名

## When to use
- 场景一（动词开头）
- 场景二
- 场景三

## Workflow
1. 判断分支（复杂时画成显式决策树）
2. 确定性步骤 → 调 scripts/ 下的脚本（正文只给调用命令）
3. 产出前过一遍 Final checks

## NEVER（红线，3-5 条）
- 预判最容易翻车的事，逐条封死

## Dependencies
- 主选命令 + 降级命令 + 装不上时告知用户缺什么

上架前过一遍这六问：描述里有没有用户会说出口的触发词？确定性工作是否都进了脚本？有没有 ❌/✅ 反例对？红线是不是从真实翻车长出来的？品味是否都变成了数字？每个依赖有没有降级路径？六问全绿再发布。安装上，个人级丢进 ~/.claude/skills/，项目级放进仓库的 .claude/skills/，或直接从官方仓库克隆后按目录拷贝，例如：

git clone --depth 1 https://github.com/anthropics/skills.git

对照仓库内目录结构，把对应 Skill 文件夹整体拷入上述位置即可被识别。

推荐排行榜

• 最值得整篇精读：webapp-testing——决策树、黑盒脚本、禁读令、❌/✅ 反例，密度最高的一篇微型课程
• 最值得抄一句：pdf 的 "Do not deliver until... zero visual or formatting defects"——一行字立起交付纪律
• 最值得抄一段：frontend-design 的 NEVER 清单——所有“产出容易平庸”的领域都能移植
• 最适合新手第一篇仿写：brand-guidelines——没有依赖、没有脚本，纯规范也成Skill，门槛最低
• 本周最值得观望的新仓库：founder-skill（11 个 Skill 组团做创业体检，是“Skill 套件”设计思路的好样本）与 new-term-radar（把“追新词”做成每日雷达，自动化选题的雏形）

参考来源

1. anthropics/skills — Anthropic 官方 Skills 仓库，本文拆解的 pdf、brand-guidelines、frontend-design、webapp-testing 四份 SKILL.md 原文的官方出处
2. wheresryan22/anatomy — 本周新星榜第一，可交互等距插画 Skill
3. alchaincyf/huashu-art-motion — 35 种艺术风格的艺术动画 Skill
4. zhuyansen/new-term-radar — 每日新术语雷达 Skill
5. Jakeschincariol/founder-skill — 11 个创业前体检 Skill 组成的套件

[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。