Claudeskills

发表于 2025-12-16 更新于 2025-12-17 分类于 ai相关， Claudeskills 阅读次数：

Claudeskills

Claudeskills是一组指令、脚本和资源的文件夹，Claude 会动态加载它们以提升在特定任务上的性能。技能教会 Claude 如何以可重复的方式完成特定任务，无论是创建符合公司品牌指南的文档、使用组织特定的流程分析数据，还是自动化个人任务。

skills的结构

最简单来说，一个技能是一个包含 SKILL.md 文件的目录。这个文件必须以 YAML 前文开始，其中包含一些必需的元数据：name 和 description。启动时，智能体会将所有已安装技能的 name 和 description 预加载到系统提示中。

这是第一级的渐进式披露元数据：它仅提供足够的信息，让 Claude 知道何时应使用每个技能，而无需将所有内容加载到上下文中。该文件的实际主体是第二级的详细程度。如果 Claude 认为该技能与当前任务相关，它将通过读取完整的 SKILL.md 将其加载到上下文中。

随着技能复杂性的增加，它们可能包含过多上下文而无法放入单个 SKILL.md 中，或者只有特定场景下才相关的上下文。在这些情况下，技能可以在技能目录中捆绑额外的文件，并通过 SKILL.md 中的名称引用它们。这些额外的链接文件是第三级 （以及更高级别）的详细程度，Claude 可以根据需要选择导航和发现。

在下面的 PDF 技能中，SKILL.md 指向了两个额外的文件（reference.md 和 forms.md），这些文件由技能作者选择与核心的 SKILL.md 一起打包。通过将填写表单的说明移至单独的文件（forms.md），技能作者能够保持技能的核心部分简洁，并相信 Claude 只有在填写表单时才会读取 forms.md。

三种 Skill 内容类型，三个加载级别

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

第 1 级：元数据（始终加载）

内容类型：指令。Skill 的 YAML 前置数据提供发现信息：

---
name: pdf-processing
description: 从 PDF 文件中提取文本和表格、填充表单、合并文档。在处理 PDF 文件或用户提及 PDF、表单或文档提取时使用。
---

Claude 在启动时加载此元数据并将其包含在系统提示中。这种轻量级方法意味着您可以安装许多 Skills 而不会产生上下文成本；Claude 只知道每个 Skill 的存在以及何时使用它。

第 2 级：指令（触发时加载）

内容类型：指令。SKILL.md 的主体包含程序知识：工作流、最佳实践和指导：

# PDF 处理

## 快速入门

使用 pdfplumber 从 PDF 中提取文本：

```python
import pdfplumber

with 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` 和 `description`
第 2 级：指令	触发 Skill 时	不到 5k 个令牌	包含指令和指导的 SKILL.md 主体
第 3 级+：资源	按需	实际上无限制	通过 bash 执行的捆绑文件，不将内容加载到上下文中

渐进式披露确保任何给定时间只有相关内容占据上下文窗口。

claudecode使用skills

Agent Skills - Claude Code Docs

个人 Skills

个人 Skills 在您的所有项目中都可用。将它们存储在 ~/.claude/skills/ 中：

1	mkdir -p ~/.claude/skills/my-skill-name

使用个人 Skills 的场景：

您的个人工作流和偏好
您正在开发的实验性 Skills
个人生产力工具

项目 Skills

项目 Skills 与您的团队共享。将它们存储在项目中的 .claude/skills/ 中：

1	mkdir -p .claude/skills/my-skill-name

使用项目 Skills 的场景：

团队工作流和约定
项目特定的专业知识
共享的实用程序和脚本

项目 Skills 被检入 git 并自动对团队成员可用。

skills示例代码仓库

anthropics/skills: 技能公共存储库 — anthropics/skills: Public repository for Skills

./skills: 创意与设计、开发与技术、企业与沟通以及文档技能的示例

./spec: Agent Skills 规范

./template: 技能模板

仓库包含以下主要skill类别：

🎨 创意与设计类 (Creative & Design)

algorithmic-art - 使用 p5.js 创建生成艺术，支持种子随机性、流场和粒子系统
canvas-design - 使用设计哲学创建美观的视觉艺术，输出 .png 和 .pdf 格式
slack-gif-creator - 创建针对 Slack 大小限制优化的动画 GIF

💻 开发与技术类 (Development & Technical)

artifacts-builder - 使用 React、Tailwind CSS 和 shadcn/ui 组件构建复杂的 claude.ai HTML artifacts
mcp-builder - 创建高质量 MCP 服务器的指南，用于集成外部 API 和服务
webapp-testing - 使用 Playwright 测试本地 Web 应用程序，进行 UI 验证和调试