Skills 简介

Claude Code Skills 是一种将专业知识、工作流程和最佳实践打包成"可复用技能包"的功能。

想象一下，Skills 就像是给 Claude 配备的"技能书"——当你需要它完成特定任务时，它不再需要你一遍遍地解释要求，而是直接按照预先定义好的技能标准来执行工作。

为什么需要 Skills？

在没有 Skills 之前，使用 Claude Code 存在一些问题：

• 重复指令：每次都要解释"代码要符合什么风格"、"提交信息要怎么写"
• 知识无法沉淀：团队成员各自的使用经验无法共享
• 标准不统一：不同的人用 Claude，结果可能完全不同
• 效率低下：常见的任务每次都要从头解释

Skills主要优势：

• 专业化 Claude：为特定领域任务定制能力
• 减少重复：一次创建，自动使用
• 组合能力：结合多个 Skills 构建复杂工作流程

官方Skill库：https://github.com/anthropics/skills

Skill大全：https://skills.sh/

https://platform.claude.com/docs/zh-CN/agents-and-tools/agent-skills/overview

Skills 的工作原理
Skills 利用 Claude 的虚拟机环境提供仅靠提示词无法实现的能力。Claude 在具有文件系统访问权限的虚拟机中运行，允许 Skills 以包含指令、可执行代码和参考材料的目录形式存在，其组织方式类似于您为新团队成员创建的入职指南。

这种基于文件系统的架构实现了渐进式披露：Claude 按需分阶段加载信息，而不是预先消耗上下文。

三种类型的 Skill 内容，三个加载级别
Skills 可以包含三种类型的内容，每种内容在不同时间加载：

第一级：元数据（始终加载）
内容类型：指令。Skill 的 YAML 前置内容提供发现信息：

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---
Claude 在启动时加载此元数据并将其包含在系统提示中。这种轻量级方法意味着您可以安装许多 Skills 而不会产生上下文损耗；Claude 只知道每个 Skill 的存在以及何时使用它。

第二级：指令（触发时加载）
内容类型：指令。SKILL.md 的主体包含程序性知识：工作流程、最佳实践和指导：

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).
当您的请求与 Skill 的描述匹配时，Claude 通过 bash 从文件系统读取 SKILL.md。只有在那时，这些内容才会进入上下文窗口。

第三级：资源和代码（按需加载）
内容类型：指令、代码和资源。Skills 可以捆绑额外的材料：

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)
指令：包含专业指导和工作流程的额外 markdown 文件（FORMS.md、REFERENCE.md）

代码：Claude 通过 bash 运行的可执行脚本（fill_form.py、validate.py）；脚本提供确定性操作而不消耗上下文

资源：参考材料，如数据库模式、API 文档、模板或示例

Claude 仅在被引用时才访问这些文件。文件系统模型意味着每种内容类型都有不同的优势：指令用于灵活指导，代码用于可靠性，资源用于事实查询。

级别	加载时机	Token 成本	内容
第一级：元数据	始终（启动时）	每个 Skill 约 100 个 token	YAML 前置内容中的 name 和 description
第二级：指令	触发 Skill 时	不超过 5k token	包含指令和指导的 SKILL.md 主体
第三级+：资源	按需	实际上无限制	通过 bash 执行的捆绑文件，不将内容加载到上下文中
渐进式披露确保在任何给定时间，只有相关的 Skill 内容占用上下文窗口。

快速开始

使用API获取Skills

https://platform.claude.com/docs/zh-CN/agents-and-tools/agent-skills/quickstart

Skills 解决了这些问题，让 Claude 变成一个"有经验的团队成员"——它知道你的项目规范、工作流程和最佳实践。

my-skill/
├── SKILL.md          # Required: instructions + metadata
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
└── assets/           # Optional: templates, resources

企业级技能

https://platform.claude.com/docs/zh-CN/agents-and-tools/agent-skills/enterprise

在企业规模部署 Agent Skills 的治理、安全审查、评估和组织指南。

本指南面向需要在组织范围内治理 Agent Skills 的企业管理员和架构师。它涵盖了如何大规模审查、评估、部署和管理 Skills。有关编写指南，请参阅最佳实践。有关架构详情，请参阅 Skills 概述。