Claude Skills 深度解析：概念、创建与多工具使用指南

一、引言

• Skills 近期火爆全网，作者几个月前的分享当时不温不火，如今已广泛关注。
• 本文基于最新信息，讲解 Skills 的概念，以及如何在 Claude Code、CodeX、OpenCode 中创建和使用 Skills。
• 全文干货，建议收藏。

---

二、Skills 是什么？

• 本质：一个文件夹，包含以下目录结构

  my-skill/
  ├── SKILL.md       # 必选：指令、元数据
  ├── scripts/       # 可选：执行脚本
  ├── references/    # 可选：参考文档
  └── assets/        # 可选：模板、资源
  

• 工作方式：按需加载，只有当任务与 Skill 相关时才启用，提升性能、节省 tokens。
• 开放标准：Anthropic 已将其推动为 Agent Skills 开放标准（https://agentskills.io/），支持跨 AI 平台通用。
• 行业支持：OpenAI、Google、Cursor 等主流厂商已跟进，Skills 可无缝在不同工具间迁移。

---

三、Skills 的架构

• 运行在代码执行环境中，具备文件系统访问、bash 命令和代码执行能力。
• 相当于虚拟机上的一个目录，Claude 可通过 bash 命令与之交互。

---

四、Skills 的工作原理

• 核心机制：渐进式披露，高效管理上下文。

工作流程

步骤	名称	加载时机	令牌成本
1	发现 Skills	始终加载	每个 Skill 约 100 tokens（仅元数据）
2	激活 Skills	触发时加载	不到 5k tokens（完整 SKILL.md）
3	执行 Skills	按需加载	实际上无限制（可引用脚本/资源）

• 元数据示例：

  name: pdf-processing
  description: 从 PDF 文件中提取文本和表格、填充表单、合并文档...
  

---

五、SKILL.md 的文件结构

• 必填字段（YAML 前置元数据）
  • name：最多64字符，小写字母+数字+连字符
  • description：最多1024字符，不能为空
• 可选字段
  • license、compatibility、metadata、allowed-tools
• Markdown 指令：无固定格式，包含工作流、最佳实践、示例等。
• 优势：清晰易懂、扩展性好、轻松迁移。

---

六、Skills 仓库推荐

• 官方仓库：https://github.com/anthropics/skills
  • 包含图片、文档等基础技能，以及 skill-creator（引导式创建技能）
• 第三方仓库：https://github.com/ComposioHQ/awesome-claude-skills
• 更多大厂/第三方 skills 将在后续文章中分享。

---

七、Claude Code 使用 Skills 指南

1. Skills 分类

类型	生效范围	目录位置
Personal Skills	全局（所有项目）	~/.claude/skills/
Project Skills	单个项目	.claude/skills/
Plugin Skills	取决于插件	由插件定义

2. 安装 Skills

• 将技能目录复制到 ~/.claude/skills 即可。
• 使用 /skills 命令列出所有已安装的技能。

3. 使用 Skills

• 自动引用：Claude 根据任务自动加载相关 Skill。
• 手动引用：输入 /skill-name 主动调用（适合有明确偏好的场景）。

4. 创建自定义 Skills

• 方法一：手动创建目录 + SKILL.md 文件。
• 方法二：使用官方 skill-creator 引导式创建（推荐）。
• 实操示例：创建“自媒体助手 Skill”，实现“中文转英文URL”和“内容转小红书风格”两个功能。
• 验证：/skills 列出新技能，/my-zmt-tool 使用。
• 优势对比：相比 ChatGPT 需要切换 GPT，Skills 使用更快捷。

---

八、CodeX 使用 Skills 指南

• Agent Skills 为开放标准，Claude 中创建的 Skills 可直接复制到 CodeX 使用。
• 安装：将技能目录复制到 ~/.codex/skills。
• 列出技能：/skills。
• 调用方式：
  • 自动调用
  • 手动指定：使用 $ skill-name（与 Claude Code 的 / 不同，CodeX 中将 Skills 与自身命令分开）。
• CodeX 额外提供 skill-creator 和 skill-installer 命令。

---

九、OpenCode 使用 Skills 指南

• 适用场景：需要多模型混用（国外、国内、本地模型），OpenCode 为开源版 Claude Code。
• Skills 搜索路径（自动兼容 Claude Skills，无需复制）：
  • 项目配置：.opencode/skills/<name>/SKILL.md
  • 全局配置：~/.config/opencode/skills/<name>/SKILL.md
  • 兼容 Claude 项目：.claude/skills/<name>/SKILL.md
  • 兼容全局 Claude：~/.claude/skills/<name>/SKILL.md
• 列出 Skills：目前无内置 /skills 命令，可通过对话询问 AI 列出。
• 使用方式：自动或手动引用，与 Claude Code 类似。

---

十、常见问题

1. 有了 MCP，为什么还要 Skills？

• MCP：提供调用外部工具的能力（API、脚本、服务），解决“能做什么”。
• MCP 局限：需在上下文中携带大量信息，消耗 token；不自动知晓公司/项目流程规范。
• Skills：教模型如何使用工具、遵循流程，解决“怎么做”。
• 协同工作：MCP 负责访问工具/数据，Skills 负责引导执行流程。
• 代码执行稳定性：MCP 执行固定代码更稳定，Skills 受本地环境影响（如 Python 版本）。

2. Skills 和 Slash Commands 有什么区别？

对比项	Skills	Slash Commands
触发方式	模型自动（也可手动 /）	完全由用户手动 /command
元数据	有 name/description，支持自动匹配	无元数据，无法自动触发
额外能力	支持目录、资源、脚本	仅斜杠命令本身

• 注：最新 Claude 已允许 Slash Commands 合并在用户 Skills 中，但 Slash Commands 仍不能自动加载。

---

十一、总结

• Skills 本质是 Agent 能力组织方式的升级：将提示词、工具、脚本、资源收敛到标准化目录，通过渐进式披露按需加载。
• 三大价值：
  • 可复用：一次编写，反复使用。
  • 低心智成本：沉淀个人/团队能力。
  • 易迁移：开放标准，多平台通用（Claude、Google、OpenAI、Cursor 等）。
• 作者体验：以前频繁切换 GPT，现在一个 Skill 即可搞定。
• 未来展望：Agent Skills 生态将更加完善，建议尽早沉淀自己的常用能力。

---