1. 从一堆重复劳动说起为什么要在 Agent 里装 Skills如果你最近在 Claude Code 或其它 Agent 工具里反复做同一类事——把一份 PDF 里的表单字段抠出来、把几张表合成一个 xlsx、按品牌规范出一版海报、把一堆素材拼成 pptx——你大概已经体会过那种「每次都要重新描述一遍需求」的疲惫。Agent 本身很聪明但它不知道你们团队的文档模板长什么样也不知道你司海报的配色禁区在哪。anthropics/skills这个仓库解决的正是这件事它把某一类任务的执行流程沉淀成可复用的能力包Agent 在遇到对应任务时动态加载而不是每次从零猜。Anthropic Skills 是 Anthropic 官方开源的 Agent Skills 仓库用来展示 Claude Skills 系统的能力与最佳实践。一个 Skill 由指令Instructions、脚本Scripts和资源文件Resources组成核心入口是一个SKILL.md里面用 YAML Frontmatter 定义元数据用 Markdown 写执行规则。仓库覆盖 Creative Design、Development Technical、Enterprise Communication、Document Skills 等多个类别还公开了 Claude 内部用于文档处理的 docx、pdf、pptx、xlsx 参考实现。它适合谁适合需要在 Agent 工作流里批量处理文档与设计产物的开发者尤其是那些已经被「重复描述需求」折磨过的人。这篇会聚焦 skill-creator、canvas-design、xlsx、pdf、pptx 这几个高频技能讲清能力边界、安装配置、调用方式和结果验证并给出可复制的 settings.json / config.toml 骨架以及用 TaoToken 统一 Key 的配置片段。目标很直接让你搭出一个能跑起来的 Skills 示例工程。2. 前置准备TaoToken 统一 Key 与 Skills 仓库的关系在动手装 Skill 之前先把模型调用这一层理顺。Skills 本身是「能力包」它最终还是要通过模型来执行所以你需要一个稳定的 API 入口。我这边习惯用 TaoToken 做统一 Key 管理好处是多个 Agent 工具、多个 Skill 场景共用一个 Key不用在每个工具里重复配。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数。你需要先去控制台创建一个 API Key然后把它写进各个工具的配置里。这里要区分两个概念Skills 仓库anthropics/skills负责定义「怎么做」TaoToken 负责「谁来执行」。两者是配合关系不是替代关系。Skill 里的脚本和指令描述的是任务流程真正跑推理的还是模型。所以配置顺序是先拿到 Key再配工具最后装 Skill。注意不要把 Key 硬编码进 Skill 的 SKILL.md 或脚本里。Skill 是会被分享和复用的Key 应该放在工具层的环境变量或配置文件里。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层一层是工具本身的设置settings.json一层是模型接入的配置config.toml 或环境变量。下面给出一套可以直接抄的骨架你按自己的路径改一下就行。先看 Claude Code 的 settings.json放在~/.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-your-taotoken-key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(python:*), Bash(node:*), Read, Write, Edit ] }, plugins: { marketplaces: [ anthropics/skills ] } }如果你用的是支持 config.toml 的客户端比如某些 CLI 工具骨架长这样[model] provider anthropic base_url https://taotoken.net/api api_key sk-your-taotoken-key model claude-sonnet-4-20250514 [skills] repo anthropics/skills auto_load true skill_dirs [ document-skills/pdf, document-skills/xlsx, document-skills/pptx, example-skills/skill-creator, example-skills/canvas-design ] [permissions] allow_bash true allow_write true两个配置的核心差异在于settings.json 走的是环境变量注入适合 Claude Code 这种已经内置了 Anthropic 客户端的工具config.toml 走的是显式声明适合你自己写的 Agent 框架。不管哪种base_url都指向 TaoToken 的 API 地址api_key填你在控制台生成的那串。配好之后先别急着装 Skill跑一个最小请求验证 Key 是通的curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-your-taotoken-key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: reply with ok}] }返回里能看到content字段带ok说明 Key 和网络都正常。这一步别跳过后面 Skill 报错时你能快速判断是 Key 问题还是 Skill 问题。4. 逐技能安装与调用从 skill-creator 到 pptx4.1 注册 Marketplace 并安装 document-skillsClaude Code 里装 Skill 走的是 Plugin Marketplace 机制。先把anthropics/skills注册进来/plugin marketplace add anthropics/skills然后安装文档技能包/plugin install document-skillsanthropic-agent-skills如果你想连示例技能一起装包含 skill-creator 和 canvas-design/plugin install example-skillsanthropic-agent-skills装完之后可以用/plugin命令进交互界面选 Browse and install plugins再选 anthropic-agent-skills能看到 document-skills 和 example-skills 两个包选 Install now 即可。这一步的本质是把仓库里的 Skill 目录复制到本地插件目录并注册到 Claude Code 的 Skill 索引里。4.2 skill-creator用 Skill 造 Skillskill-creator 是这几个技能里最特殊的一个——它本身是一个 Skill但用途是帮你创建、修改、优化和评估其它 Skill。当你需要从零建一个 Skill、改进已有 Skill 或测试 Skill 效果时它会自动触发。它的工作流程大致是先跟你沟通需求明确目标、触发场景和边界然后写 SKILL.md包含 metadata、说明、示例、规则接着按需增加 scripts、references、assets再设计测试样例和评测集跑评测对比多个版本最后根据结果迭代。一个最小 SKILL.md 长这样--- name: my-skill-name description: A clear description of what this skill does and when to use it --- # My Skill Name [Add your instructions here that Claude will follow when this skill is active] ## Examples - Example usage 1 - Example usage 2 ## Guidelines - Guideline 1 - Guideline 2Frontmatter 里name和description是必填的其余 Markdown 内容定义执行说明、示例和规则。你可以直接让 Claude 用 skill-creator 帮你生成这个骨架比如Use the skill-creator skill to scaffold a new skill called brand-report that generates weekly brand performance reports from xlsx data.它会先反问你几个问题报告包含哪些指标、数据源格式、输出格式然后生成目录结构和 SKILL.md 初稿。实测下来这一步能省掉大量「我该写什么」的纠结。4.3 canvas-design先设计哲学再出图canvas-design 用于创建高质量的静态视觉设计包括海报、艺术作品、视觉设计输出为 .png 或 .pdf。它的核心思路跟一般「直接排版」的工具不一样先创建一套 Design Philosophy设计哲学再把设计理念转化为视觉语言色彩、构图、层次然后生成最终画布最后输出 Markdown 设计说明加 PNG/PDF 成品。调用示例Use the canvas-design skill to create a poster for a developer conference. Theme: Agent Skills in Production. Style: minimal, high contrast, no gradients. Output both PNG and PDF.它会先给你一段设计哲学描述比如「以留白和字重对比构建秩序感」你确认后再出图。这个「先哲学后视觉」的流程好处是避免了一上来就调参数、结果风格飘忽的问题。注意它只生成 .md、.pdf、.png 三类文件不会给你 .psd 或 .ai 源文件。4.4 xlsxExcel 全流程处理xlsx 技能覆盖所有涉及 Excel 文件的任务读取、解析、创建、编辑、更新、合并、拆分、数据处理。它的执行逻辑是先判断任务是读取还是创建/编辑读取就解析工作簿、工作表、单元格内容编辑就改数据、格式或公式创建就生成新工作簿和工作表最后保存。调用示例Use the xlsx skill to read sales_q3.xlsx, merge the three regional sheets into one summary sheet, add a total row with SUM formulas, and save as sales_q3_merged.xlsx.这个技能底层会用到 openpyxl 之类的库所以你的环境里需要有 Python 和对应依赖。如果报ModuleNotFoundError: No module named openpyxl先pip install openpyxl。4.5 pdf读取、提取、生成一条龙pdf 技能处理所有 PDF 相关任务读取、解析、提取内容、创建、编辑、修改、转换、重新生成。判断逻辑是读取就提取文本、图片、表格、页面内容编辑就改页面或内容生成就组织页面结构并输出 PDF最后保存。提取表单字段的典型调用Use the PDF skill to extract the form fields from path/to/some-file.pdf它会返回字段名、类型、当前值。如果是扫描件 PDF提取效果取决于 OCR 质量纯文本 PDF 基本没问题。生成 PDF 时它会用 reportlab 或类似库组织页面结构你可以在指令里指定页边距、字体、页眉页脚。4.6 pptx从模板或从零建演示文稿pptx 技能覆盖所有 PowerPoint 相关任务创建、编辑、读取、解析、更新、模板处理、拆分、合并。读取时可以用 markitdown 提取文本、生成缩略图或解包 XML编辑时分析模板、解包 PPT、修改内容、清理后重新打包无模板时按 pptxgenjs 流程从零创建。设计阶段强调颜色、版式和视觉层级避免单调的幻灯片。调用示例Use the pptx skill to create a 10-slide deck from outline.md. Use the corporate template at templates/brand.pptx. Keep the color scheme, replace content only.有模板时它会解包 pptx本质是个 zip改 XML 里的文本节点再重新打包。这个过程对格式的保留比较好但如果你手动改过模板里的占位符命名可能会对不上需要先检查模板结构。5. 验证请求与成功结果怎么确认 Skill 真的生效了装完 Skill 不代表它会被调用。Claude 是根据任务描述动态加载 Skill 的所以验证分两步先确认 Skill 被索引到再确认任务触发了它。第一步在 Claude Code 里执行/plugin list你应该能看到document-skillsanthropic-agent-skills和example-skillsanthropic-agent-skills处于 enabled 状态。如果没看到说明安装没成功回到第 4.1 步重来。第二步发一个明确指向 Skill 的请求观察返回里有没有 Skill 加载的痕迹。比如Use the xlsx skill to create a new workbook with two sheets: Summary and Details. Summary has headers [Month, Revenue, Cost]. Fill three rows of sample data. Save as demo.xlsx.成功的话你会看到 Claude 先声明「Loading xlsx skill」然后执行 Python 脚本最后告诉你文件已保存。你可以去当前目录确认demo.xlsx存在用python -c import openpyxl; wbopenpyxl.load_workbook(demo.xlsx); print(wb.sheetnames)验证 sheet 名对不对。如果 Claude 没有加载 Skill而是直接用通用能力回答通常是两个原因一是任务描述里没有明确提到 Skill 名二是 Skill 的 description 跟任务匹配度不够。前者靠显式点名解决后者需要你改 SKILL.md 里的 description把触发关键词写得更具体。6. 本篇常见错排查报错一/plugin marketplace add无响应或超时。先确认网络能访问 GitHub再确认 Claude Code 版本支持 plugin 命令较老版本没有这个子命令。如果公司网络有限制可以手动 clone 仓库到本地插件目录再在 settings.json 里用本地路径注册。报错二Skill 装了但调用时报Skill not found。检查/plugin list里的包名和你在指令里写的 Skill 名是否一致。document-skills 包里包含 pdf、xlsx、pptx、docx 四个子技能调用时写Use the PDF skill而不是Use the document-skills skill。报错三xlsx 技能执行时报缺少依赖。这是最常见的坑。xlsx 依赖 openpyxlpdf 依赖 pypdf 或 reportlabpptx 依赖 python-pptx。建议在项目里建一个 requirements.txtopenpyxl3.1.0 pypdf4.0.0 reportlab4.0.0 python-pptx0.6.23 markitdown0.0.1然后pip install -r requirements.txt。注意 Skill 脚本用的是哪个 Python 解释器虚拟环境和系统环境别搞混。报错四API 返回 401 或 403。大概率是 Key 配错了。检查 settings.json 里的ANTHROPIC_API_KEY是不是 TaoToken 控制台生成的那串以及ANTHROPIC_BASE_URL是不是https://taotoken.net/api注意结尾没有斜杠也没有 /v1。有些客户端会自动拼/v1/messages你手动配 base_url 时别重复加。报错五canvas-design 输出风格跟预期差很远。这个技能是先出设计哲学再出图如果你跳过哲学确认直接要成品风格会不可控。建议在指令里明确风格约束比如「no gradients, high contrast, sans-serif only」并在它给出设计哲学后回复确认或修改。报错六pptx 改模板后格式错乱。多半是模板里的占位符命名不规范或者你改的 XML 节点层级不对。建议先用unzip -l template.pptx看内部结构确认 slide 布局和占位符 ID再让 Skill 去改。如果模板复杂先从零创建再套用母版色值比直接改模板更稳。排障时如果怀疑是 Key 或接入层的问题可以去 TaoToken 控制台看 API Keys 页面确认 Key 状态和额度接入细节参考接入文档。如果只是想快速验证某个模型能不能正常对话用模型对话页面发一条消息最直接。长期跑编码和 Agent 任务的话Coding Plan 的额度模型更适合高频调用。7. 把 Skills 接进你的日常工作流装好这几个技能之后我自己的用法是这样的每周的品牌数据报表走 xlsx 技能从原始表合并到汇总表再到图表数据一条指令跑完对外文档走 pdf 技能提取字段、生成摘要、重新排版季度汇报走 pptx 技能套公司模板只换内容偶尔要做活动海报就调 canvas-design先让它出三版设计哲学选一版再出图。skill-creator 则用来把这些流程固化下来——比如我把「品牌周报」的完整流程写成了一个自定义 Skill下次直接说「跑品牌周报」就行。一个实用技巧把常用 Skill 的调用指令写成模板存在项目里比如prompts/weekly-report.md里面写清楚数据源路径、输出格式、命名规则。这样每次不用重新描述Agent 加载 Skill 后直接按模板执行。另一个坑是别把 Skill 当万能药——它擅长的是「流程固定、输入输出明确」的任务开放式创意探索还是直接对话更灵活。如果你还没配 Key先去 https://taotoken.net/api-keys 生成一个然后按第 3 节的骨架把 settings.json 配好再回来装 Skill。整个链路跑通一次之后后面加新 Skill 就是复制目录、改 SKILL.md、重启工具三步的事。
Agent之Skills：anthropics/skills 全解析——skill-creator/canvas-design/xlsx/pdf/pptx 的安装配置与实战案例详细攻略（含 TaoTo
1. 从一堆重复劳动说起为什么要在 Agent 里装 Skills如果你最近在 Claude Code 或其它 Agent 工具里反复做同一类事——把一份 PDF 里的表单字段抠出来、把几张表合成一个 xlsx、按品牌规范出一版海报、把一堆素材拼成 pptx——你大概已经体会过那种「每次都要重新描述一遍需求」的疲惫。Agent 本身很聪明但它不知道你们团队的文档模板长什么样也不知道你司海报的配色禁区在哪。anthropics/skills这个仓库解决的正是这件事它把某一类任务的执行流程沉淀成可复用的能力包Agent 在遇到对应任务时动态加载而不是每次从零猜。Anthropic Skills 是 Anthropic 官方开源的 Agent Skills 仓库用来展示 Claude Skills 系统的能力与最佳实践。一个 Skill 由指令Instructions、脚本Scripts和资源文件Resources组成核心入口是一个SKILL.md里面用 YAML Frontmatter 定义元数据用 Markdown 写执行规则。仓库覆盖 Creative Design、Development Technical、Enterprise Communication、Document Skills 等多个类别还公开了 Claude 内部用于文档处理的 docx、pdf、pptx、xlsx 参考实现。它适合谁适合需要在 Agent 工作流里批量处理文档与设计产物的开发者尤其是那些已经被「重复描述需求」折磨过的人。这篇会聚焦 skill-creator、canvas-design、xlsx、pdf、pptx 这几个高频技能讲清能力边界、安装配置、调用方式和结果验证并给出可复制的 settings.json / config.toml 骨架以及用 TaoToken 统一 Key 的配置片段。目标很直接让你搭出一个能跑起来的 Skills 示例工程。2. 前置准备TaoToken 统一 Key 与 Skills 仓库的关系在动手装 Skill 之前先把模型调用这一层理顺。Skills 本身是「能力包」它最终还是要通过模型来执行所以你需要一个稳定的 API 入口。我这边习惯用 TaoToken 做统一 Key 管理好处是多个 Agent 工具、多个 Skill 场景共用一个 Key不用在每个工具里重复配。TaoToken 的官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 基址是 https://taotoken.net/api 这个地址不加 UTM 参数。你需要先去控制台创建一个 API Key然后把它写进各个工具的配置里。这里要区分两个概念Skills 仓库anthropics/skills负责定义「怎么做」TaoToken 负责「谁来执行」。两者是配合关系不是替代关系。Skill 里的脚本和指令描述的是任务流程真正跑推理的还是模型。所以配置顺序是先拿到 Key再配工具最后装 Skill。注意不要把 Key 硬编码进 Skill 的 SKILL.md 或脚本里。Skill 是会被分享和复用的Key 应该放在工具层的环境变量或配置文件里。3. 可复制配置settings.json 与 config.toml 骨架Claude Code 的配置分两层一层是工具本身的设置settings.json一层是模型接入的配置config.toml 或环境变量。下面给出一套可以直接抄的骨架你按自己的路径改一下就行。先看 Claude Code 的 settings.json放在~/.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-your-taotoken-key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(python:*), Bash(node:*), Read, Write, Edit ] }, plugins: { marketplaces: [ anthropics/skills ] } }如果你用的是支持 config.toml 的客户端比如某些 CLI 工具骨架长这样[model] provider anthropic base_url https://taotoken.net/api api_key sk-your-taotoken-key model claude-sonnet-4-20250514 [skills] repo anthropics/skills auto_load true skill_dirs [ document-skills/pdf, document-skills/xlsx, document-skills/pptx, example-skills/skill-creator, example-skills/canvas-design ] [permissions] allow_bash true allow_write true两个配置的核心差异在于settings.json 走的是环境变量注入适合 Claude Code 这种已经内置了 Anthropic 客户端的工具config.toml 走的是显式声明适合你自己写的 Agent 框架。不管哪种base_url都指向 TaoToken 的 API 地址api_key填你在控制台生成的那串。配好之后先别急着装 Skill跑一个最小请求验证 Key 是通的curl https://taotoken.net/api/v1/messages \ -H x-api-key: sk-your-taotoken-key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: reply with ok}] }返回里能看到content字段带ok说明 Key 和网络都正常。这一步别跳过后面 Skill 报错时你能快速判断是 Key 问题还是 Skill 问题。4. 逐技能安装与调用从 skill-creator 到 pptx4.1 注册 Marketplace 并安装 document-skillsClaude Code 里装 Skill 走的是 Plugin Marketplace 机制。先把anthropics/skills注册进来/plugin marketplace add anthropics/skills然后安装文档技能包/plugin install document-skillsanthropic-agent-skills如果你想连示例技能一起装包含 skill-creator 和 canvas-design/plugin install example-skillsanthropic-agent-skills装完之后可以用/plugin命令进交互界面选 Browse and install plugins再选 anthropic-agent-skills能看到 document-skills 和 example-skills 两个包选 Install now 即可。这一步的本质是把仓库里的 Skill 目录复制到本地插件目录并注册到 Claude Code 的 Skill 索引里。4.2 skill-creator用 Skill 造 Skillskill-creator 是这几个技能里最特殊的一个——它本身是一个 Skill但用途是帮你创建、修改、优化和评估其它 Skill。当你需要从零建一个 Skill、改进已有 Skill 或测试 Skill 效果时它会自动触发。它的工作流程大致是先跟你沟通需求明确目标、触发场景和边界然后写 SKILL.md包含 metadata、说明、示例、规则接着按需增加 scripts、references、assets再设计测试样例和评测集跑评测对比多个版本最后根据结果迭代。一个最小 SKILL.md 长这样--- name: my-skill-name description: A clear description of what this skill does and when to use it --- # My Skill Name [Add your instructions here that Claude will follow when this skill is active] ## Examples - Example usage 1 - Example usage 2 ## Guidelines - Guideline 1 - Guideline 2Frontmatter 里name和description是必填的其余 Markdown 内容定义执行说明、示例和规则。你可以直接让 Claude 用 skill-creator 帮你生成这个骨架比如Use the skill-creator skill to scaffold a new skill called brand-report that generates weekly brand performance reports from xlsx data.它会先反问你几个问题报告包含哪些指标、数据源格式、输出格式然后生成目录结构和 SKILL.md 初稿。实测下来这一步能省掉大量「我该写什么」的纠结。4.3 canvas-design先设计哲学再出图canvas-design 用于创建高质量的静态视觉设计包括海报、艺术作品、视觉设计输出为 .png 或 .pdf。它的核心思路跟一般「直接排版」的工具不一样先创建一套 Design Philosophy设计哲学再把设计理念转化为视觉语言色彩、构图、层次然后生成最终画布最后输出 Markdown 设计说明加 PNG/PDF 成品。调用示例Use the canvas-design skill to create a poster for a developer conference. Theme: Agent Skills in Production. Style: minimal, high contrast, no gradients. Output both PNG and PDF.它会先给你一段设计哲学描述比如「以留白和字重对比构建秩序感」你确认后再出图。这个「先哲学后视觉」的流程好处是避免了一上来就调参数、结果风格飘忽的问题。注意它只生成 .md、.pdf、.png 三类文件不会给你 .psd 或 .ai 源文件。4.4 xlsxExcel 全流程处理xlsx 技能覆盖所有涉及 Excel 文件的任务读取、解析、创建、编辑、更新、合并、拆分、数据处理。它的执行逻辑是先判断任务是读取还是创建/编辑读取就解析工作簿、工作表、单元格内容编辑就改数据、格式或公式创建就生成新工作簿和工作表最后保存。调用示例Use the xlsx skill to read sales_q3.xlsx, merge the three regional sheets into one summary sheet, add a total row with SUM formulas, and save as sales_q3_merged.xlsx.这个技能底层会用到 openpyxl 之类的库所以你的环境里需要有 Python 和对应依赖。如果报ModuleNotFoundError: No module named openpyxl先pip install openpyxl。4.5 pdf读取、提取、生成一条龙pdf 技能处理所有 PDF 相关任务读取、解析、提取内容、创建、编辑、修改、转换、重新生成。判断逻辑是读取就提取文本、图片、表格、页面内容编辑就改页面或内容生成就组织页面结构并输出 PDF最后保存。提取表单字段的典型调用Use the PDF skill to extract the form fields from path/to/some-file.pdf它会返回字段名、类型、当前值。如果是扫描件 PDF提取效果取决于 OCR 质量纯文本 PDF 基本没问题。生成 PDF 时它会用 reportlab 或类似库组织页面结构你可以在指令里指定页边距、字体、页眉页脚。4.6 pptx从模板或从零建演示文稿pptx 技能覆盖所有 PowerPoint 相关任务创建、编辑、读取、解析、更新、模板处理、拆分、合并。读取时可以用 markitdown 提取文本、生成缩略图或解包 XML编辑时分析模板、解包 PPT、修改内容、清理后重新打包无模板时按 pptxgenjs 流程从零创建。设计阶段强调颜色、版式和视觉层级避免单调的幻灯片。调用示例Use the pptx skill to create a 10-slide deck from outline.md. Use the corporate template at templates/brand.pptx. Keep the color scheme, replace content only.有模板时它会解包 pptx本质是个 zip改 XML 里的文本节点再重新打包。这个过程对格式的保留比较好但如果你手动改过模板里的占位符命名可能会对不上需要先检查模板结构。5. 验证请求与成功结果怎么确认 Skill 真的生效了装完 Skill 不代表它会被调用。Claude 是根据任务描述动态加载 Skill 的所以验证分两步先确认 Skill 被索引到再确认任务触发了它。第一步在 Claude Code 里执行/plugin list你应该能看到document-skillsanthropic-agent-skills和example-skillsanthropic-agent-skills处于 enabled 状态。如果没看到说明安装没成功回到第 4.1 步重来。第二步发一个明确指向 Skill 的请求观察返回里有没有 Skill 加载的痕迹。比如Use the xlsx skill to create a new workbook with two sheets: Summary and Details. Summary has headers [Month, Revenue, Cost]. Fill three rows of sample data. Save as demo.xlsx.成功的话你会看到 Claude 先声明「Loading xlsx skill」然后执行 Python 脚本最后告诉你文件已保存。你可以去当前目录确认demo.xlsx存在用python -c import openpyxl; wbopenpyxl.load_workbook(demo.xlsx); print(wb.sheetnames)验证 sheet 名对不对。如果 Claude 没有加载 Skill而是直接用通用能力回答通常是两个原因一是任务描述里没有明确提到 Skill 名二是 Skill 的 description 跟任务匹配度不够。前者靠显式点名解决后者需要你改 SKILL.md 里的 description把触发关键词写得更具体。6. 本篇常见错排查报错一/plugin marketplace add无响应或超时。先确认网络能访问 GitHub再确认 Claude Code 版本支持 plugin 命令较老版本没有这个子命令。如果公司网络有限制可以手动 clone 仓库到本地插件目录再在 settings.json 里用本地路径注册。报错二Skill 装了但调用时报Skill not found。检查/plugin list里的包名和你在指令里写的 Skill 名是否一致。document-skills 包里包含 pdf、xlsx、pptx、docx 四个子技能调用时写Use the PDF skill而不是Use the document-skills skill。报错三xlsx 技能执行时报缺少依赖。这是最常见的坑。xlsx 依赖 openpyxlpdf 依赖 pypdf 或 reportlabpptx 依赖 python-pptx。建议在项目里建一个 requirements.txtopenpyxl3.1.0 pypdf4.0.0 reportlab4.0.0 python-pptx0.6.23 markitdown0.0.1然后pip install -r requirements.txt。注意 Skill 脚本用的是哪个 Python 解释器虚拟环境和系统环境别搞混。报错四API 返回 401 或 403。大概率是 Key 配错了。检查 settings.json 里的ANTHROPIC_API_KEY是不是 TaoToken 控制台生成的那串以及ANTHROPIC_BASE_URL是不是https://taotoken.net/api注意结尾没有斜杠也没有 /v1。有些客户端会自动拼/v1/messages你手动配 base_url 时别重复加。报错五canvas-design 输出风格跟预期差很远。这个技能是先出设计哲学再出图如果你跳过哲学确认直接要成品风格会不可控。建议在指令里明确风格约束比如「no gradients, high contrast, sans-serif only」并在它给出设计哲学后回复确认或修改。报错六pptx 改模板后格式错乱。多半是模板里的占位符命名不规范或者你改的 XML 节点层级不对。建议先用unzip -l template.pptx看内部结构确认 slide 布局和占位符 ID再让 Skill 去改。如果模板复杂先从零创建再套用母版色值比直接改模板更稳。排障时如果怀疑是 Key 或接入层的问题可以去 TaoToken 控制台看 API Keys 页面确认 Key 状态和额度接入细节参考接入文档。如果只是想快速验证某个模型能不能正常对话用模型对话页面发一条消息最直接。长期跑编码和 Agent 任务的话Coding Plan 的额度模型更适合高频调用。7. 把 Skills 接进你的日常工作流装好这几个技能之后我自己的用法是这样的每周的品牌数据报表走 xlsx 技能从原始表合并到汇总表再到图表数据一条指令跑完对外文档走 pdf 技能提取字段、生成摘要、重新排版季度汇报走 pptx 技能套公司模板只换内容偶尔要做活动海报就调 canvas-design先让它出三版设计哲学选一版再出图。skill-creator 则用来把这些流程固化下来——比如我把「品牌周报」的完整流程写成了一个自定义 Skill下次直接说「跑品牌周报」就行。一个实用技巧把常用 Skill 的调用指令写成模板存在项目里比如prompts/weekly-report.md里面写清楚数据源路径、输出格式、命名规则。这样每次不用重新描述Agent 加载 Skill 后直接按模板执行。另一个坑是别把 Skill 当万能药——它擅长的是「流程固定、输入输出明确」的任务开放式创意探索还是直接对话更灵活。如果你还没配 Key先去 https://taotoken.net/api-keys 生成一个然后按第 3 节的骨架把 settings.json 配好再回来装 Skill。整个链路跑通一次之后后面加新 Skill 就是复制目录、改 SKILL.md、重启工具三步的事。
