这份榜单第一句就得泼盆冷水:你在 claude.ai 上用得很爽的那四个文档 skill,在 Claude Code 里装不到——官方文档白纸黑字写着不提供。你能装的是 GitHub 上那份同名但另一码事的开源版。
前十二期讲的东西,收益都要过几天才看得出来。办公产出类不一样:它交付的是一个文件,能不能打开是客观的、当场的、不用你信任何人。这也是它成为整个 skill 生态里最容易变现的一类的原因——有 oracle,模型就能自己纠错。下面十个条目全部能点开,装法抄自各自官方页面;第 02 节讲这十个为什么分属三种完全不同的东西,第 04 节把代价摊开。本表不按星数排——办公类的头部就那么几个,星数排出来只会让你误以为最热的就该先装。
# ①②③④ 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+)
SKILL.md 第一层是决策树——新建就写 Node 脚本用 docx 包;编辑就解包改 word/document.xml 再重打包;只读就一条 pandoc -t markdown。真正值钱的是 scripts/merge_runs.py:Word 会把一句话切成一串 run,不先合并,查找替换十次有九次替换不到。另有 accept_changes.py 处理追踪修订、comment.py 处理批注(要同时改六个互相链接的文件)。pptxgenjs,编辑走解包改 XML,读用 markitdown 或 scripts/thumbnail.py 出缩略图网格。它的坑写得比谁都实在:先设 layout 再加页(默认 10×5.625 英寸不是 13.3)、十六进制色不带 #、阴影配置对象不能跨调用复用。生成完必跑 scripts/office/validate.py,查 schema、关系、图表。openpyxl 写公式、pandas 灌数据、markitdown 快速看一眼,最关键的是写完公式跑 scripts/recalc.py——openpyxl 只写公式不算值,不重算你交出去的是一张全是 = 号没有数的表。它老实交代的限制值得抄下来:不支持会溢出的数组函数(XLOOKUP / FILTER / UNIQUE / SEQUENCE,改用 INDEX+MATCH)、2007 年后的新函数要带 _xlfn. 前缀、data_only=True 读的是缓存值且一存盘就把公式毁了、外部链接重存会被剥掉。pypdf 或 qpdf,抽文字抽表格用 pdfplumber,新建用 reportlab,扫描件 OCR 用 pytesseract+pdf2image,表单填写另开一份 FORMS.md。它是四件套里唯一不靠 OOXML 解包的,所以也是唯一不依赖 LibreOffice 的。skill_id 点名。两条硬限制要记住:必须搭 code execution 工具(skill 就跑在它的容器里),而那个容器没有网络、也不能运行时装包。官方文档明说:Claude Code 不提供预置文档 skill。所以「我在网页版用得好好的,为什么终端里没有」的答案就在这——你要的是①②③④。3p-updates.md(进展/计划/问题)、company-newsletter.md、faq-answers.md、general-comms.md,用哪种读哪份。它的 description 写得极其个人化——「帮我用我公司喜欢的格式写内部沟通」。这句是个信号:这类 skill 的正确用法是 fork 一份塞自己公司的体例,不是原样装。theme-showcase.pdf 让你先看再选,也能现生成新主题。它是「样式与内容分离」的干净样本:主题只是一堆色值与字体配对,套在幻灯片、文档、落地页上都行。#141413、标题 Poppins、正文 Lora,还带按背景自动选色和字体回退(Arial / Georgia)。照装等于把别人家的门头挂到你店上;它的正确用途是当模板,把里面的色卡换成你的。本系列 Skill 15 单独深挖这一类。SKILL.md 放决策树,scripts/ 放确定性操作,再挂一个校验脚本当反馈闭环。这类的判据是「它的脚本替我兜住了哪个具体的坑」,不是「它文档写得好不好」。代价是环境依赖:②的校验链要 LibreOffice,④的 OCR 要 tesseract。「模板型 skill」这个说法容易被当成一类工具,其实它是个结构:一份决策树 + 一批按需读的 reference + 一个能判对错的校验步骤。①②③④是它在文件格式上的实例,⑦⑨是它在文风上的实例。看懂这个结构,你自己公司那套合同模板、报价单模板,做法完全一样。
validate.py、③的 recalc.py、①的 soffice 转换验证是正面样本。没有校验步骤的文档类 skill,本质是让模型盲写二进制格式——这一类最贵的 bug 就是「文件生成了,但打不开」。scripts/,它就是把不该给模型的活给了模型。data_only=True 会毁公式」写进正文,是这十个里最能建立信任的一段。一个只讲能做什么、不讲做不到什么的 skill,你得自己去踩它没写的那些坑。skill_id、插件安装),而且不互通——官方文档专门列了一节说自定义 skill 不跨端同步。装之前先问「我在哪儿用」。官方文档给的数字很明确:每个 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 关掉。
soffice),②看效果还要 pdftoppm,④的 OCR 要 tesseract。在一台干净的 CI 机器上,这四件套有一半功能是哑的。license: Proprietary,仓库 README 还有一句「仅供演示与教学用途」。拿去改造进商业产品前先读 LICENSE.txt——这条本系列以后还会遇到很多次。XLOOKUP,就会一直纳闷为什么表里是 #NAME?。这类 skill 的学习成本不在安装,在它老实写下来的那半页限制。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 字符处截断,装到触发变迟钝时,先怀疑这条而不是怀疑模型。
pptx / xlsx / docx / pdf,且必须搭 code execution 工具。/plugin marketplace add anthropics/skills、两个插件名与「仅供演示与教学用途」免责声明merge_runs.py / accept_changes.py / comment.pythumbnail.py、validate.pyrecalc.py,以及溢出数组函数 / _xlfn. 前缀 / data_only=True 三条限制的原文FORMS.mdtheme-showcase.pdf#141413、Poppins / Lora 与字体回退;本系列 Skill 15 深挖pip install 'markitdown[all]';markitdown-mcp 只暴露 convert_to_markdown(uri) 一个工具skill_id、「Claude Code 不提供预置文档 skill」、API 容器无网络不可装包、三层 token 成本表(2026-09)/skills、/skill-doctor、描述合并在 1,536 字符截断(2026-09)