如何创建并使用 Claude Skills？ 3 种方法的详细指南！

Claude 的新功能 Skills——由 Anthropic 近期推出——让团队与开发者为 Claude 教授可重复、可共享的能力：可以将其视为紧凑且有版本的“工具包”（包含说明、脚本与资源的文件夹），让 Claude 可靠地执行领域特定任务，例如生成符合品牌规范的幻灯片、制作带公式的 Excel 工作簿，或安全地运行小型代码片段。本文先解释什么是 Skills 以及它们的重要性，然后提供在三种路径中使用 Skills 的实践分步指南：在 Claude 的网页应用（零代码路径）、在 Claude Code（开发者 IDE 风格），以及通过 Claude API（编程式集成）。最后我们将介绍安全性、与其他代理模式的对比、最佳实践以及排障建议。

Claude 的 Skills 究竟是什么，它们带来哪些优势？

**简短定义：**一个Skill是一个自包含的文件夹/包，打包了说明、脚本、资源，以及可选的可执行辅助程序；当某项任务匹配该 Skill 的触发条件时，Claude 可动态加载它。实践中，一个 Skill 充当可复用、有版本的“能力”，用来教会 Claude 如何执行某一类具体任务（例如：将电子表格按公司标准格式化、为幻灯片应用品牌规范、生成遵循监管模板的报告）。

Skill 的核心组成（通常包含的内容）

• manifest / metadata — 名称、版本、触发器、权限。
• instructions.md — 高层步骤、护栏、示例。
• handlers 或 scripts — 用于生成文件、调用内部工具或转换数据的实际代码。
• resources/ — 模板、风格指南、示例数据。
• tests/ — 用于验证 Skill 的自动化测试。

Skills 为 Claude 增添了哪些能力？

• **自定义说明与内容包：**Skills 可以包含书面说明、模板与资源文件（风格指南、CSV 等），Claude 会将其作为权威上下文使用。
• **可执行组件（Code Execution Tool）：**Skills 可包含在 Anthropic 代码执行容器中运行的脚本或代码，用于确定性操作（文件解析、数值计算、数据变换）。这能将仅通过令牌生成表达起来代价高或不够可靠的工作下放给代码执行。
• **自动激活与选择性使用：**当用户请求与某个 Skill 的范围匹配时，Claude 可自动选择并调用相关 Skill，并解释它为何选择该 Skill。
• **版本化与编程式控制：**Skills 是一等 API 对象：你可以上传、管理版本，并在 Claude API 中引用 skill_id。这支持类似 CI 的工作流与更新治理。
• **跨端分发：**Skills 可在 Claude 的产品族中使用——网页应用、Claude Code，以及 Anthropic 的 API/Agent SDK——既能提升终端用户生产力，也支持开发者自动化。

我如何在 Claude 网页应用（Claude.ai）中使用 Claude Skills？

我需要的前提条件：(1) 需使用支持 Skills 的付费 Claude 套餐（在发布时为 Pro、Max、Team 或 Enterprise）。可用性与管理员控制因套餐与组织设置而异。(2) 可访问“设置”以及工作区中的“Skills”功能开关（设置 → 功能 → Skills）。管理员可能需要启用 Skill 创建，或将安装限制为已批准的 Skills。

在 Claude Apps Web 中创建与使用 Skills 的分步指南：

Step 1: 浏览内置示例并开启 Skills

打开 Claude.ai → 设置 → 功能 → Skills。开启预览/示例 Skills 以观察结构与激活行为。这是最快了解 Skills 外观与行为的方式。

Step 2: 使用 Skill 创建器 UI（第一个 Skill）

Anthropic 在应用内提供了引导式 Skill 创建器：选择 Create Skill 启动向导，说明你希望 Skill 执行的任务，生成默认的文件夹布局（README、说明文件、示例模板，及可选脚本），并帮助撰写基础说明与触发器。使用内置测试工具，通过示例提示验证行为。

Step 3: 定义 Skill 的意图、示例与资源

• **模板/资源：**添加 Skill 应参照的模板、CSV 示例、设计规范或实体词典。
• **意图/描述：**撰写简短且明确的 Skill 用途描述（有助于 Claude 进行匹配）。
• **激活线索/触发器：**添加关键词或示例提示，以便在符合条件时让 Claude 加载该 Skill。
• **说明文件：**将稳定说明（例如品牌语调、必需章节）放入 Skill 内的单一规范文件中。

Step 4: 下载与上传 Skill

完成后，Claude 会将 Skill 打包为 ZIP 文件。在左侧侧栏点击“Capabilities”。

或将 ZIP 拖放到上传区域。Claude 会进行验证并安装，随后确认已激活。

Step 5 : 在真实对话中使用 Skills

保存后，尝试与 Skill 触发器匹配的自然提示（或按名称提及该 Skill）。应用会指示何时加载了某个 Skill，并可能展示所使用的资源；多次迭代并优化说明，直到输出稳定可靠。当用户请求 Claude 执行相关任务时，Claude 可自动检测并加载匹配的 Skill——或者你也可以显式调用它。Skill 的说明、模板与代码将引导 Claude 的输出。

Claude Apps Web 提示

• 系统包含常见任务的内置技能，例如：文档生成；报告创建；PowerPoint 演示；Excel 公式计算。
• 用户可以直接自定义自己的技能。
• Claude 会自动调用相关技能，无需手动选择。
• 在 Claude 的推理过程中，用户可以看到正在调用哪些技能。
• Prefer non-executable tasks at first.** 仅包含说明（无代码）的 Web Skills 更易审计。

我如何在 Claude Code 中使用 Claude Skills？

条件

• 访问 Claude Code：Claude Code 是 Anthropic 的 IDE/终端助手界面——通常包含在开发者套餐中，或可通过插件/市场访问。部分 Skill 功能需要访问 Code Execution Tool 或 ADK（代理开发工具包）。CometAPI 提供对 Claude Code 与 Claude API 的访问。你可以在 CometAPI 的 Claude Code 中使用 Skills，并通过 Claude Code 查阅文档。
• 本地开发环境：如果某个 Skill 包含测试套件或代码，你需要克隆 Skill 仓库并在本地运行测试。

在 Claude Code 中创建与使用 Skills 的分步指南

Step 1 : 创建 Skill 文件夹结构：

在 Claude Code 中，Skills 通常作为包含 manifest（元数据）、说明文件、测试输入、辅助脚本（Python/JS）以及任何二进制或模板的文件夹存在：

1. 定义 Skill manifest：manifest 包含 skill_id、名称、描述、作者、依赖、入口点与安全说明。这告知 Claude Code 何时以及如何加载该 Skill。
2. 实现辅助脚本与测试：如果你的 Skill 使用代码转换或生成文件，添加小巧而明确作用域的脚本与可在代码执行环境中运行的单元测试。

Step 2 : 安装或添加 Skill 包

• 在 Claude Code 中，打开插件/市场面板并添加 add anthropics/skills（或特定 Skill 仓库）。
• 或者将 Skill 仓库克隆到你的工作区。

选择“Anthropic Agent Skills”，

然后在 “document-skills”（用于文件生成）与 “example-skills”（用于演示）之间选择。对于本教程，选用 “document-skills”——它预览了如 Word 文档创建等能力。点击 “Install Now”；Claude Code 将下载并注册这些技能。

Step 3 : 编写高级代码处理器

• 实现操作文件或调用外部工具的处理器（例如使用 python-pptx 生成 .pptx，使用 openpyxl 创建 .xlsx）。
• 若 Skill 需要远程代码执行，确保其符合 Anthropic 的容器模型（API 文档会描述 Skills 如何使用容器进行代码运行）。

Step 4 : 在 Claude Code 中加载与测试

• 启动 Claude Code 会话并让 Claude 运行你的 Skill（例如：“使用 ReportGen Skill 创建 Q3 收入幻灯片”）。
• 在工作区中观察日志、输出与任何生成的工件。

Step 5 : 打包与发布

将 Skill 提交到你组织的 Skill 注册表或推送到批准的 GitHub 仓库。使用版本标签，并包含测试套件以便治理。

Claude Code 提示

• 将 Skills 视为代码项目：当代码或模板更改时，使用 CI 运行 Skill 测试。
• 隔离副作用：如果 Skill 可执行脚本，请在一次性容器或沙箱中运行，避免意外数据泄漏。
• 清晰记录输入/输出，以便非开发同事稍后在网页应用中使用该 Skill。

我如何在 Claude API 中使用 Claude Skills？

条件

可访问 Anthropic 的 Messages API，并启用 code execution tool（Skills 通过容器参数与 Messages API 集成）。你还需要 API 凭据以及在容器中运行 Skill 代码所需的任何运行时权限。

通过 API 创建与使用 Skill 的分步指南：

Step 1 : 在本地准备 Skill 包

创建遵循 API 期望 manifest 格式的 Skill 文件夹（包含名称、版本、说明文件、触发器、可选的资源路径与辅助脚本）。Anthropic 的文档提供了模式与示例。

Step 2 : 上传或注册 Skill

Anthropic 托管的 Skill：在 API 调用中引用 skill_id 与可选版本（无需上传）。使用你的 API 密钥进行认证并调用 Skill 创建端点（例如 POST /v1/skills 或类似端点）。

curl -X POST "https://api.anthropic.com/v1/skills" \  
-H "x-api-key: $ANTHROPIC_API_KEY" \  
-H "anthropic-version: 2023-06-01" \  
-H "anthropic-beta: skills-2025-10-02" \  
-F "display_title=My Excel Skill" \  
-F "files=@excel-skill/process_excel.py;filename=excel-skill/process_excel.py"

上传 Skill 负载，或让 API 指向一个压缩归档。API 会验证并将 Skill 存储到你的工作区。

无论来源如何，Skills 以相同方式集成到消息 API 中。你可以使用 skill_id、type，并可选地使用 skill_version 参数指定 Skill 的版本，Skill 将在代码执行环境中运行：

Step 3: 在 Messages API 调用中包含容器参数

在 Messages API 请求中，加入 container 字段，指定 skill_id、type（anthropic 或 custom），以及可选的 version。Messages 端点会将执行路由到运行该 Skill 的代码环境。

示例（概念性）：

   {
     "model": "claude-sonnet-4-5-20250929",
     "messages": }],
     betas=,
     "container": {"type":"custom","skill_id":"skill_01AbCdEf","version":"latest"}
   }

Step 4:Downloading Generated Files

当某个 Skill 创建文档（Excel、PowerPoint、PDF、Word）时，它会在响应中返回一个 file_id 属性。你需要使用 File API 下载这些文件：

def extract_file_ids(response):
file_ids = []
for item in response.content:
if item.type == 'bash_code_execution_tool_result':
content_item = item.content
if content_item.type == 'bash_code_execution_result':
for file in content_item.content:
if hasattr(file, 'file_id'):
file_ids.append(file.file_id)
return file_ids

for file_id in extract_file_ids(response):
file_metadata = client.beta.files.retrieve_metadata(
file_id=file_id,
betas=
)
file_content = client.beta.files.download(
file_id=file_id,
betas=
)

file_content.write_to_file(file_metadata.filename)
print(f"Downloaded: {file_metadata.filename}")

API 使用提示

• 优先使用 Anthropic 托管的常用格式技能（pptx/xlsx/docx），避免重复造轮子。
• **使用版本字段。**在生产环境中固定到某个 Skill 版本，避免行为意外变更。
• 在系统中实现护栏：清理输入、限制文件大小，并在对外暴露工件前执行生成后的验证。

为什么要使用 Claude Skills——它有哪些收益与权衡？

优势

• **一致性与质量：**Skills 编码了组织的最佳实践（品牌规则、法律措辞），因此输出一致并减少人工返工。
• **生产力：**自动化可重复任务（数据准备、幻灯片创建、模板应用）可缩短周期——早期客户在测试中报告了更快的产出时间。
• **可复用与治理：**Skills 成为可版本的工件，可像软件一样审阅、测试与发布，简化审计与合规。
• **降低复杂流程的令牌/算力成本：**由于 Claude 仅在需要时加载 Skill 的相关部分，你无需总是发送冗长的系统提示，从而降低成本与上下文膨胀。

限制

• **前期投入：**构建健壮的 Skills 需要设计、文档与测试——你在用产品工程替代提示工程。
• **可执行风险：**可运行代码或访问数据的 Skills 增加了安全面；企业必须限制可发布与批准可执行 Skills 的人员范围。
• **套餐与功能可用性：**Skills 在发布时面向 Pro、Max、Team 与 Enterprise 套餐推出；免费用户默认可能无法访问 Skills。请检查你的套餐。

Claude Skills 与其他平台及代理模式的对比

Skills = 更丰富、可版本的工件。它们比一次性工具调用或模板更结构化：Skills 将说明、资产、脚本与清单打包为可复用的包。这使它们更接近可部署的微型代理，而不仅仅是单次工具调用。

Skills vs. 临时系统提示与提示库

系统提示是短暂的，必须在每个会话中提供；Skills 是持久的、有版本且集中管理。因此在企业规模与可复现性方面，Skills 更优。

Skills vs. 基于工具的代理（工具调用/函数调用）

基于工具的代理（例如函数调用模式）侧重赋予模型具体的外部能力（API、工具调用）。Skills 将说明 + 资源 + 可选辅助结合起来，旨在教会模型如何执行任务（包括何时使用工具）。简言之：工具是执行器；Skills 编码的是可能使用工具的流程与策略。

Skills vs. OpenAI 的 AgentKit 及类似代理框架

近期发布（例如在 OpenAI DevDay）强调打包代理与开发者工具包，以推动从原型到生产。Claude Skills 扮演类似角色，但更强调文件夹化的说明与资源，并在 Claude 的应用、Code 与 API 之间紧密集成。两种方法正在趋同：都旨在实现生产级代理，但在 SDK API、治理控制、市场模式等实现细节上有所不同。如果你已使用某个代理框架，Skills 通常可以作为你加载到这些代理中的“能力模块”。

何时选择 Skills，何时使用自定义代理？

• **在以下场景选用 Skills：**当你需要跨用户与界面提供标准化、可共享、低摩擦的能力（非开发者也能受益）。
• **在以下场景选用自定义代理：**当你需要复杂的多工具编排与定制控制逻辑，且超出 Claude 的 Skill 执行模型。Skills 擅长整洁打包的领域任务；代理适用于重量级编排。

其他模式仍占优的场景

• **低延迟、轻量任务：**对于小型任务或不需要可复现输出的场景，函数调用或系统提示更为简单。
• **自定义工具生态：**如果你已经拥有庞大的通过 API 暴露的自定义工具基础设施，结合编排层的函数调用/插件可能更适配。

实用的真实案例与配方

示例 1 — 品牌幻灯片格式化器（网页应用 Skill）

• **作用：**将原始幻灯片要点转换为符合公司品牌的幻灯片（字体、语调、幻灯片顺序）。
• **在网页应用中创建：**使用 Skill 创建器 → 添加品牌风格指南、幻灯片模板与输入/输出示例。为设计团队启用。通过提问“使用 Brand Slide Formatter 格式化这些笔记”进行测试。

示例 2 — CSV 数据审计器（Claude Code Skill）

• **作用：**验证 CSV 数据列，运行轻量级 Python 检查（缺失值、类型不匹配），并返回摘要报告。
• **在 Code 中创建：**使用 validators.py 辅助程序、单元测试与示例 CSV 构建 Skill。在 Claude Code 的笔记本中迭代测试，然后打包并发布。

示例 3 — 合同红线助手（API Skill）

• **作用：**将公司法律标准应用到合同文本，并生成红线与理由说明。
• **通过 API 创建：**编写说明文件与条款库，通过 POST /skills 上传，然后在你的合同管理系统中使用 skill_id 调用，以生成标准化的红线输出。

结论

Claude Skills 是临时说明与完全代理工程之间的实用桥梁：它们让团队捕获机构知识、强化风格与安全，并在 UI 与编程接口层面自动化重复任务。无论你是使用网页 Skill 创建器的非技术产品经理、在 Claude Code 中交付可复用开发者工具的工程师，还是在平台团队通过 Messages API 将 Skills 集成到应用中，遵循小而严谨的实践——版本化、测试、最小权限与分阶段发布——都能让你的 Skills 在生产环境中更可靠且可审计。

入门指南

CometAPI 是一个统一的 API 平台，将来自领先提供商的 500+ AI 模型——如 OpenAI 的 GPT 系列、Google 的 Gemini、Anthropic 的 Claude、Midjourney、Suno 等——聚合到一个对开发者友好的接口中。通过提供一致的认证、请求格式与响应处理，CometAPI 显著简化了将 AI 能力集成到你的应用之中。无论你在构建聊天机器人、图像生成器、音乐创作工具，还是数据驱动的分析管线，CometAPI 都能让你更快迭代、控制成本并保持供应商中立，同时获取 AI 生态的最新突破。

CometAPI 提供对 Claude Code 与 Claude API 的访问。你可以在 CometAPI 的 Claude Code 中使用 Skills，并通过 Claude Code 查阅文档。

为什么通过 CometAPI 使用 Claude Code？

顶级人工智能功能：使用专为开发者打造的模型轻松生成、调试与优化代码。

• 灵活的模型选择：我们全面的模型范围让你的开发更为顺畅。
• 无缝集成：API 始终可用。几分钟内将 Claude Code 直接集成到你现有的工作流。
• 通过 CometAPI 使用 Claude Code 将节省更多成本。CometAPI 提供的 Claude API 比官方价格优惠 20%，并由官方更新至最新模型。最新模型为 Claude Haiku 4.5 API。

准备就绪？→ 立即注册 CometAPI！

如果你想获取更多有关 AI 的技巧、指南与资讯，欢迎关注我们的 VK、X 和 Discord!