SKILL 13 / DOCS · ROUNDUP

办公产出类 Skills 榜单:十个真能装的

四件套的两个版本 · 为什么这类最快变现 · 模板型 Skill 的共同结构

2026-09-14 · BigCat

这份榜单第一句就得泼盆冷水:你在 claude.ai 上用得很爽的那四个文档 skill,在 Claude Code 里装不到——官方文档白纸黑字写着不提供。你能装的是 GitHub 上那份同名但另一码事的开源版。

前置 → Skill 01 AI 编码 Skills 榜单(三种形态别混着比)

// WHY THIS MATTERS

前十二期讲的东西,收益都要过几天才看得出来。办公产出类不一样:它交付的是一个文件,能不能打开是客观的、当场的、不用你信任何人。这也是它成为整个 skill 生态里最容易变现的一类的原因——有 oracle,模型就能自己纠错。下面十个条目全部能点开,装法抄自各自官方页面;第 02 节讲这十个为什么分属三种完全不同的东西,第 04 节把代价摊开。本表不按星数排——办公类的头部就那么几个,星数排出来只会让你误以为最热的就该先装。

// 01

先给清单:十个条目,装法都在下面

论断:这张表最该先看的是最后一列。办公类 skill 的失败几乎全发生在「装重了」和「装错版本」上,不是「装少了」。
条目 出处 替你干掉的那件事 什么时候别装 ────────────────────────────────────────────────────────────────────────────────────────── ① skills/docx anthropics/skills Word 新建 / 改 XML / 追踪修订 你在 claude.ai 或 API 上(已预置) ② skills/pptx anthropics/skills 幻灯片生成 + 缩略图 + 校验 机器上没有 LibreOffice ③ skills/xlsx anthropics/skills 公式 / 重算 / 脏表格清洗 你只要一张 CSV ④ skills/pdf anthropics/skills 合并拆分 / 表单填写 / OCR 只是读一页文字,markitdown 更快 ⑤ 预置四件套(skill_id) Claude API 同上,但零安装、官方维护 你在 Claude Code 里(官方不提供) ⑥ skills/doc-coauthoring anthropics/skills 长文档的三段式共写流程 你要的是格式,不是内容 ⑦ skills/internal-comms anthropics/skills 周报 / 简报 / FAQ 的公司体例 你公司体例和它给的四份不一样 ⑧ skills/theme-factory anthropics/skills 十套配色字体,一句话套到产出上 你已有品牌规范文件 ⑨ skills/brand-guidelines anthropics/skills 把风格指南变成可执行约束 它装的是 Anthropic 自家的色卡 ⑩ microsoft/markitdown microsoft 把 Office / PDF 读成 Markdown 你只写不读 ────────────────────────────────────────────────────────────────────────────────────────── ①②③④⑥⑦⑧⑨ 同在 anthropics/skills 一个仓库,分属两个插件(见下)。⑤ 和①②③④同名不同物。

怎么装(命令抄自各自官方页面)

# ①②③④ Claude Code:一条命令拿到四件套(marketplace 名是 anthropic-agent-skills)
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

# ⑥⑦⑧⑨ 在另一个插件里,一起装(还捎带 skill-creator、mcp-builder 等)
/plugin install example-skills@anthropic-agent-skills

# ⑤ Claude API:不是「装」,是在 container 里点名,且必须开 code execution 工具
container: { skills: [ { type: "anthropic", skill_id: "pptx" } ] }
# skill_id 只有四个:pptx / xlsx / docx / pdf

# ⑩ markitdown:读的那一半,pip 装
pip install 'markitdown[all]'
# 只要三种格式就别装全:
pip install 'markitdown[pdf, docx, pptx]'
# 它还有个 MCP 版,只暴露一个工具 convert_to_markdown(uri)
pip install markitdown-mcp

# 装完立刻做这两件事
/skills          # 看清单,关掉这次用不上的
/skill-doctor    # 看每个 skill 的 token 成本与调用频次(v2.1.252+)

逐条说人话

进阶资源 · Agent Skills · Overview(⑤的两条硬限制、三层渐进披露、以及「Claude Code 不提供预置文档 skill」的原文出处)
// 02

为什么这十个不能混着比:三种东西挤在一张表里

论断:①和⑥的差别,比①和 markitdown 的差别还大。一个给模型脚本,一个给模型流程,一个压根不是 skill。

三种形态

  1. 带脚本的确定性型(①②③④)——共同结构是:SKILL.md 放决策树,scripts/ 放确定性操作,再挂一个校验脚本当反馈闭环。这类的判据是「它的脚本替我兜住了哪个具体的坑」,不是「它文档写得好不好」。代价是环境依赖:②的校验链要 LibreOffice,④的 OCR 要 tesseract。
  2. 纯流程型(⑥⑦⑧⑨)——一行代码都没有,全是文字与样例。这类的判据是「它的样例是不是我要的那种」。⑦⑨尤其明显地是模板而不是成品:一个装的是别人公司的周报体例,一个装的是别人公司的色卡。
  3. 底层工具(⑩)——它不参与 skill 的触发机制,是被 skill 调用的。把它和①②③④放一张表,只是因为你实际干活时它们总是一起出现。
那个陷阱:①②③④ 和 ⑤ 同名同能力,但是两个东西。⑤ 是 Anthropic 托管的闭源预置版,在 claude.ai / API 上开着;①②③④ 是开源仓库里的同名实现,license 写的是 Proprietary(详见各自 LICENSE.txt),且仓库 README 明写「仅供演示与教学用途」。在 claude.ai 上再手动传一份开源版,等于给同一件事挂两份描述,白交触发冲突的税。

还有一条不属于任何形态

「模板型 skill」这个说法容易被当成一类工具,其实它是个结构:一份决策树 + 一批按需读的 reference + 一个能判对错的校验步骤。①②③④是它在文件格式上的实例,⑦⑨是它在文风上的实例。看懂这个结构,你自己公司那套合同模板、报价单模板,做法完全一样。

// 03

三分钟验货:六条判据,用上面这十个当量尺

论断:办公类 skill 好不好,不用跑,打开 SKILL.md 翻三分钟就知道。上面十个恰好各自示范了一条。
  1. 有没有一个能判对错的校验步骤。②的 validate.py、③的 recalc.py、①的 soffice 转换验证是正面样本。没有校验步骤的文档类 skill,本质是让模型盲写二进制格式——这一类最贵的 bug 就是「文件生成了,但打不开」。
  2. 确定性操作是脚本还是让模型现编。合并 run、重算公式、接受修订这些事,答案唯一、不需要判断力,写成脚本既省 token 又不会跑偏(脚本代码不进上下文,只有输出进)。SKILL.md 里如果全是「你可以这样写代码……」而没有 scripts/,它就是把不该给模型的活给了模型。
  3. 老实交代限制没有。③把「不支持溢出数组函数」「data_only=True 会毁公式」写进正文,是这十个里最能建立信任的一段。一个只讲能做什么、不讲做不到什么的 skill,你得自己去踩它没写的那些坑。
  4. 装的是流程还是别人的偏好。⑥给的是流程,你拿来即用;⑦⑨给的是 Anthropic 自己的体例和色卡,你该 fork 而不是装。分辨方法很简单:读 description,出现「my company」「Anthropic's official」这类词的,都是模板。
  5. 环境依赖有没有写在明处。②③要 LibreOffice 才能转换与重算,④的 OCR 要 tesseract。装之前先确认你跑 agent 的那台机器有这些——这类失败不报「skill 不好用」,报的是一句你看不懂的命令找不到。
  6. 它在你这个环境里到底存不存在。这是办公类独有的一条:同一个能力在 claude.ai、API、Claude Code 上是三条不同的路(预置、skill_id、插件安装),而且不互通——官方文档专门列了一节说自定义 skill 不跨端同步。装之前先问「我在哪儿用」。
进阶资源 · Claude Code · Skills(五个存放位置、/plugin install、/skills 与 /skill-doctor 的出处)
// 04

诚实的代价:这类 Skill 的账单长什么样

论断:办公类的 context 税很轻——轻到不值得省。真正的代价在别处:环境、版本、和「装了就以为万事大吉」。

先说轻的那部分

官方文档给的数字很明确:每个 skill 常驻上下文的只有 name 和 description,约 100 token;正文触发时才读,通常 5k token 以内;bundled 文件不读就不花钱(据 platform.claude.com «Agent Skills» 文档,2026-09)。Claude Code 侧还有一条更具体的:所有 skill 描述合起来在 1,536 字符处被截断——注意这意味着装得太多时,排在后面的 skill 描述会被切掉,它就再也触发不了了。这比多花几百 token 严重得多。用 /skill-doctor 看每个 skill 的实际 token 成本与调用频次,想不起用途的就 /plugin 关掉。

再说重的那部分

失败模式:让模型「生成一个季度汇报的 xlsx」,它用 openpyxl 老老实实写了一屏公式,文件也生成了,你打开一看全是 0 或空白——因为 openpyxl 不算值,没人跑 recalc.py。这个 bug 最恶心的地方是:文件能打开、格式也对、只有数是错的,而错得很安静。

// 一页选购卡

先装这三个(Claude Code 场景):document-skills@anthropic-agent-skills(一条命令拿到 docx/pptx/xlsx/pdf)+ markitdown(pip install 'markitdown[all]',读的那一半)+ theme-factory(在 example-skills 插件里,十套现成主题,先看 theme-showcase.pdf 再挑)。装完先装 LibreOffice,否则②③的校验链是哑的。

按需再加:doc-coauthoring(要写长文档、且难点在想清楚而不在排版时)· internal-comms(fork 一份换成你公司的体例)· brand-guidelines(当模板读,把 #141413 换成你的主色)· markitdown-mcp(仅当你要让别的 agent 远程转文件)。

明确别装:在 claude.ai 或 API 上再手动传一份开源版四件套(预置的⑤已经开着,重复挂描述只会抢触发)· 在没有 LibreOffice 的机器上指望 pptx 的 validate.py · 原封不动的 brand-guidelines(那是 Anthropic 的色卡,不是你的)。

装完三件事:/skills 看清单 · /skill-doctor 查 token 成本与调用频次 · 记住描述合并后在 1,536 字符处截断,装到触发变迟钝时,先怀疑这条而不是怀疑模型。

// 术语表

OOXML(Office Open XML,办公开放 XML)
.docx / .pptx / .xlsx 的真身:一个 zip 包,里面装着一堆 XML。所谓「编辑文档」就是解包、改 XML、重打包。
progressive disclosure(渐进披露)
skill 分三层加载:name+description 常驻(约 100 token)→ SKILL.md 触发时读 → bundled 文件用到才读。
skill_id
Claude API 里点名预置 skill 的标识,办公类只有四个:pptx / xlsx / docx / pdf,且必须搭 code execution 工具。
recalc(重算)
openpyxl 只把公式文本写进单元格,不计算结果。要靠 LibreOffice 跑一遍才有缓存值,否则别人打开看到的是空的。
merge runs(合并文本片段)
Word 会把一句话切成多个 run 存。不先合并,对 XML 做查找替换就会漏掉被切开的那些。

// 延伸阅读