本文详细介绍了Claude的Agent Skills功能这是一种模块化能力可扩展Claude的功能。Skills包含指令、元数据和可选资源采用渐进式披露机制按需加载内容减少上下文消耗。文章探讨了Skills的优势专业化、减少重复、组合功能、使用方法、工作原理、在不同平台的应用、结构要求和安全考虑。Skills通过基于文件系统的架构使Claude能够访问特定领域的专业知识将通用代理转变为专家。前排提示文末有大模型AGI-CSDN独家资料包哦点击下方“JavaEdge”选择“设为星标”第一时间关注技术干货本文已收录在Github关注我紧跟本系列专栏文章咱们下篇再续 魔都架构师 | 全网30W技术追随者 大厂分布式系统/数据中台实战专家 主导交易系统百万级流量调优 车联网平台架构 AIGC应用开发先行者 | 区块链落地实践者 以技术驱动创新我们的征途是改变世界 实战干货编程严选网0 前言Agent Skills 是扩展 Claude 功能的模块化能力。每个 Skill 包含指令instructions、元数据metadata和可选资源scripts脚本、templates模板Claude 在相关时会自动使用这些资源。1 为啥用 SkillsSkills 是可重用的、基于文件系统的资源为 Claude 提供特定领域的专业知识工作流、上下文和最佳实践将通用代理转变为专家。与提示不同提示是对话级别的一次性任务指令Skills 按需加载无需在多个对话中重复提供相同的指导。1.1 优势专业化 Claude为特定领域的任务定制功能减少重复创建一次自动使用组合功能结合 Skills 构建复杂工作流Agent Skills 的架构和实际应用的深入讨论使用 Agent Skills 为真实世界装备代理。2 使用 SkillsAnthropic 为常见文档任务PPT、Excel、Word、PDF提供:预构建的 Agent Skills也可创建自定义 Skills二者工作方式相同。Claude 在与你的请求相关时会自动使用它们。2.1 预构建的 Agent Skills可供 claude.ai 上的所有用户和通过 Claude API 使用。请参阅下面的可用 Skills 部分了解完整列表。2.2 自定义 Skills让你打包领域专业知识和组织知识。它们在 Claude 的所有产品中都可用在 Claude Code 中创建它们、通过 API 上传它们或在 claude.ai 设置中添加它们。2.3 开始使用预构建的 Agent Skills快速入门教程开始在 API 中使用 PowerPoint、Excel、Word 和 PDF skills自定义 SkillsAgent Skills 食谱了解如何创建你自己的 Skills3 Skills 如何工作Skills 利用 Claude 的虚拟机环境提供超越仅使用提示可能实现的功能。Claude 在具有文件系统访问权限的虚拟机中运行允许 Skills 作为包含指令、可执行代码和参考资料的目录存在组织方式就像你为新团队成员创建的入职指南。这种基于文件系统的架构支持渐进式披露Claude 按需分阶段加载信息而不是预先消耗上下文。3.1 Skill内容类型及其加载级别Skills 可包含三种类型的内容每种在不同时间加载1级元数据始终加载内容类型指令。Skill 的 YAML 前置数据提供发现信息---name: pdf-processingdescription: 从 PDF 文件中提取文本和表格、填充表单、合并文档。在处理 PDF 文件或用户提及 PDF、表单或文档提取时使用。---Claude 在启动时加载此元数据并将其包含在系统提示中。这种轻量级方法意味着你可以安装许多 Skills 而不会产生上下文成本Claude 只知道每个 Skill 的存在以及何时使用它。2级指令触发时加载内容类型指令。SKILL.md 的主体包含程序知识工作流、最佳实践和指导# PDF 处理## 快速入门使用 pdfplumber 从 PDF 中提取文本pythonimport pdfplumberwith pdfplumber.open(document.pdf) as pdf: text pdf.pages[0].extract_text()有关高级表单填充请参阅 [FORMS.md](FORMS.md)。当你请求与 Skill 描述匹配的内容时Claude 通过 bash 从文件系统读取 SKILL.md。只有这样此内容才会进入上下文窗口。3级资源和代码按需加载内容类型指令、代码和资源。Skills 可捆绑其他材料pdf-skill/├── SKILL.md (主要指令)├── FORMS.md (表单填充指南)├── REFERENCE.md (详细 API 参考)└── scripts/ └── fill_form.py (实用脚本)指令包含专业指导和工作流的其他 markdown 文件FORMS.md、REFERENCE.md代码Claude 通过 bash 运行的可执行脚本fill_form.py、validate.py脚本提供确定性操作而不消耗上下文资源参考资料如数据库架构、API 文档、模板或示例Claude 仅在引用时访问这些文件。文件系统模型意味着每种内容类型都有不同的优势指令用于灵活指导代码用于可靠性资源用于事实查询。级别加载时间令牌成本内容1级元数据始终启动时每个 Skill 约 100 个令牌YAML 前置数据中的name和description2级指令触发 Skill 时不到 5k 个令牌包含指令和指导的 SKILL.md 主体3级资源按需实际上无限制通过 bash 执行的捆绑文件不将内容加载到上下文中渐进式披露确保任何给定时间只有相关内容占据上下文窗口。3.2 Skills 架构Skills 在代码执行环境中运行Claude 具有文件系统访问、bash 命令和代码执行功能。可想象成Skills 作为虚拟机上的目录存在Claude 使用与你在计算机上导航文件相同的 bash 命令与它们交互。① Agent Skills 架构显示 Skills 如何与代理的配置和虚拟机集成② Claude 如何访问 Skill 内容触发 Skill 时Claude 用 bash 从文件系统读取 SKILL.md将其指令带入上下文窗口。若这些指令引用其他文件如 FORMS.md 或数据库架构Claude 也会用其他 bash 命令读取这些文件。当指令提及可执行脚本时Claude 通过 bash 运行它们并仅接收输出脚本代码本身永远不会进入上下文。③ 此架构支持的功能按需文件访问Claude 仅读取每个特定任务所需的文件。Skill 可以包含数十个参考文件但如果你的任务只需要销售架构Claude 仅加载该文件。其余文件保留在文件系统上消耗零令牌。高效的脚本执行当 Claude 运行validate_form.py时脚本的代码永远不会加载到上下文窗口中。仅脚本的输出如验证通过或特定错误消息消耗令牌。这使脚本比让 Claude 即时生成等效代码要高效得多。捆绑内容没有实际限制因为文件在访问前不消耗上下文Skills 可包含全面的 API 文档、大型数据集、广泛的示例或任何你需要的参考资料。对于未使用的捆绑内容没有上下文成本。这种基于文件系统的模型是使渐进式披露工作的原因。Claude 导航你的 Skill 就像你参考入职指南的特定部分一样访问每个任务所需的确切内容。3.3 示例加载 PDF 处理 skillClaude加载和使用 PDF 处理 skill 的方式启动System prompt包括PDF Processing - Extract text and tables from PDF files, fill forms, merge documents用户请求「从此 PDF 中提取文本并总结」Claude 调用bash: read pdf-skill/SKILL.md→ 指令加载到上下文中Claude 确定不需要表单填充因此不读取 FORMS.mdClaude 执行使用 SKILL.md 中的指令完成任务Skills 加载到上下文窗口 - 显示 skill 元数据和内容的渐进式加载该图表显示预加载系统提示和 skill 元数据的默认状态Claude 通过 bash 读取 SKILL.md 触发 skillClaude 根据需要可选地读取其他捆绑文件如 FORMS.mdClaude 继续执行任务这种动态加载确保只有相关的 skill 内容占据上下文窗口。4 Skills 工作的地方Skills 在 Claude 的代理产品中可用4.1 Claude APIClaude API 支持预构建的 Agent Skills 和自定义 Skills。两者的工作方式相同在container参数中指定相关的skill_id以及代码执行工具。前提条件通过 API 使用 Skills 需要三个 beta 标头code-execution-2025-08-25- Skills 在代码执行容器中运行skills-2025-10-02- 启用 Skills 功能files-api-2025-04-14- 上传/下载文件到/从容器所需通过引用其skill_id例如pptx、xlsx使用预构建的 Agent Skills或通过 Skills API/v1/skills端点创建和上传你自己的。自定义 Skills 在组织范围内共享。要了解更多信息请参阅使用 Claude API 的 Skills。4.2 Claude CodeClaude Code 仅支持自定义 Skills。自定义 Skills创建包含 SKILL.md 文件的目录形式的 Skills。Claude 自动发现并使用它们。Claude Code 中的自定义 Skills 基于文件系统不需要 API 上传。要了解更多信息请参阅在 Claude Code 中使用 Skills。4.3 Claude Agent SDKClaude Agent SDK 通过基于文件系统的配置支持自定义 Skills。自定义 Skills在.claude/skills/中创建包含 SKILL.md 文件的目录形式的 Skills。通过在allowed_tools配置中包含Skill来启用 Skills。SDK 运行时会自动发现 Skills 中的 Skills。要了解更多信息请参阅 SDK 中的 Agent Skills。4.4 Claude.aiClaude.ai 支持预构建的 Agent Skills 和自定义 Skills。预构建的 Agent Skills这些 Skills 在你创建文档时已在后台工作。Claude 使用它们而不需要任何设置。自定义 Skills通过设置 功能将你自己的 Skills 作为 zip 文件上传。在启用代码执行的 Pro、Max、Team 和 Enterprise 计划上可用。自定义 Skills 对每个用户是个人的它们不在组织范围内共享管理员无法集中管理。要了解更多关于在 Claude.ai 中使用 Skills 的信息请参阅 Claude 帮助中心中的以下资源什么是 Skills在 Claude 中使用 Skills如何创建自定义 Skills使用 Skills 教 Claude 你的工作方式5 Skill 结构每个 Skill 都需要一个带有 YAML 前置数据的SKILL.md文件---name: your-skill-namedescription: Brief description of what this Skill does and when to use it---# Your Skill Name## Instructions[Clear, step-by-step guidance for Claude to follow]## Examples[Concrete examples of using this Skill]必需字段name和description字段要求name最多 64 个字符只能包含小写字母、数字和连字符不能包含 XML 标签不能包含保留字「anthropic」、「claude」description必须非空最多 1024 个字符不能包含 XML 标签description应包括 Skill 的功能以及 Claude 何时应使用它。有关完整的创作指导请参阅最佳实践。6 安全考虑我们强烈建议仅从受信任的来源使用 Skills你自己创建的或从 Anthropic 获得的。Skills 通过指令和代码为 Claude 提供新功能虽然这使它们功能强大但也意味着恶意 Skill 可以指导 Claude 以与 Skill 声称的目的不匹配的方式调用工具或执行代码。如果你必须使用来自不受信任或未知来源的 Skill请格外谨慎并在使用前彻底审计它。根据 Claude 在执行 Skill 时拥有的访问权限恶意 Skills 可能导致数据泄露、未授权系统访问或其他安全风险。关键安全考虑彻底审计查看 Skill 中捆绑的所有文件SKILL.md、脚本、图像和其他资源。寻找异常模式如意外的网络调用、文件访问模式或与 Skill 声称的目的不匹配的操作外部来源有风险从外部 URL 获取数据的 Skills 特别有风险因为获取的内容可能包含恶意指令。即使是可信的 Skills 如果其外部依赖项随时间变化也可能被破坏工具滥用恶意 Skills 可以以有害方式调用工具文件操作、bash 命令、代码执行数据泄露具有敏感数据访问权限的 Skills 可能被设计为向外部系统泄露信息像安装软件一样对待仅从受信任的来源使用 Skills。在将 Skills 集成到具有敏感数据或关键操作访问权限的生产系统时要特别小心7 可用 Skills预构建的 Agent Skills以下预构建的 Agent Skills 可立即使用**PowerPoint (pptx)**创建演示文稿、编辑幻灯片、分析演示文稿内容**Excel (xlsx)**创建电子表格、分析数据、生成带图表的报告**Word (docx)**创建文档、编辑内容、格式化文本**PDF (pdf)**生成格式化的 PDF 文档和报告这些 Skills 在 Claude API 和 claude.ai 上可用。请参阅快速入门教程开始在 API 中使用它们。自定义 Skills 示例有关自定义 Skills 的完整示例请参阅 Skills 食谱。8 限制和约束了解这些限制有助于你有效规划 Skills 部署。跨平台可用性自定义 Skills 不会跨平台同步。上传到一个平台的 Skills 不会自动在其他平台上可用上传到 Claude.ai 的 Skills 必须单独上传到 API通过 API 上传的 Skills 在 Claude.ai 上不可用Claude Code Skills 基于文件系统与 Claude.ai 和 API 分离你需要为要使用 Skills 的每个平台单独管理和上传 Skills。共享范围Skills 根据使用位置有不同的共享模型Claude.ai仅限个人用户每个团队成员必须单独上传Claude API工作区范围所有工作区成员可以访问上传的 SkillsClaude Code个人~/.claude/skills/或基于项目.claude/skills/Claude.ai 目前不支持自定义 Skills 的集中管理员管理或组织范围分发。运行时环境约束Skills 在代码执行容器中运行具有以下限制无网络访问Skills 无法进行外部 API 调用或访问互联网无运行时包安装仅预安装的包可用。你无法在执行期间安装新包。仅预配置的依赖项检查代码执行工具文档了解可用包的列表规划你的 Skills 在这些约束范围内工作。读者福利倘若大家对大模型感兴趣那么这套大模型学习资料一定对你有用。针对0基础小白如果你是零基础小白快速入门大模型是可行的。大模型学习流程较短学习内容全面需要理论与实践结合学习计划和方向能根据资料进行归纳总结包括大模型学习线路汇总、学习阶段大模型实战案例大模型学习视频人工智能、机器学习、大模型书籍PDF。带你从零基础系统性的学好大模型有需要的小伙伴可以保存图片到wx扫描二v码免费领取【保证100%免费】AI大模型学习路线汇总大模型学习路线图整体分为7个大的阶段全套教程文末领取哈第一阶段从大模型系统设计入手讲解大模型的主要方法第二阶段在通过大模型提示词工程从Prompts角度入手更好发挥模型的作用第三阶段大模型平台应用开发借助阿里云PAI平台构建电商领域虚拟试衣系统第四阶段大模型知识库应用开发以LangChain框架为例构建物流行业咨询智能问答系统第五阶段大模型微调开发借助以大健康、新零售、新媒体领域构建适合当前领域大模型第六阶段以SD多模态大模型为主搭建了文生图小程序案例第七阶段以大模型平台应用与开发为主通过星火大模型文心大模型等成熟大模型构建大模型行业应用。大模型实战案例光学理论是没用的要学会跟着一起做要动手实操才能将自己的所学运用到实际当中去这时候可以搞点实战案例来学习。大模型视频和PDF合集这里我们能提供零基础学习书籍和视频。作为最快捷也是最有效的方式之一跟着老师的思路由浅入深从理论到实操其实大模型并不难。学会后的收获• 基于大模型全栈工程实现前端、后端、产品经理、设计、数据分析等通过这门课可获得不同能力• 能够利用大模型解决相关实际项目需求大数据时代越来越多的企业和机构需要处理海量数据利用大模型技术可以更好地处理这些数据提高数据分析和决策的准确性。因此掌握大模型应用开发技能可以让程序员更好地应对实际项目需求• 基于大模型和企业数据AI应用开发实现大模型理论、掌握GPU算力、硬件、LangChain开发框架和项目实战技能学会Fine-tuning垂直训练大模型数据准备、数据蒸馏、大模型部署一站式掌握• 能够完成时下热门大模型垂直领域模型训练能力提高程序员的编码能力大模型应用开发需要掌握机器学习算法、深度学习框架等技术这些技术的掌握可以提高程序员的编码能力和分析能力让程序员更加熟练地编写高质量的代码。获取方式有需要的小伙伴可以保存图片到wx扫描二v码免费领取【保证100%免费】