跳转到内容
有巢数智

Skills全景介绍

Skills 是 Anthropic 在 2025 年 10 月为 Claude Code 推出的、面向 Agent 的可复用能力包，本质是包含 Prompt、文档、脚本等资源的文件夹，用于把流程性知识固化下来，供 Agent 按需调用。

Skills 是模块化的、自包含的能力包，通过提供专门的知识、工作流和工具来扩展 AI Agent 的能力。它们就像是针对特定领域或任务的“入职指南”，将通用的 AI Agent 转变为具备专业程序性知识的专家。

Skills介绍

Skills 能提供什么

Section titled “Skills 能提供什么”
  1. 专业工作流：针对特定领域的自动多步骤程序。
  2. 工具集成：处理特定文件格式或 API 的指令。
  3. 领域专业知识：公司特定的知识、架构和业务逻辑。
  4. 打包资源：用于复杂和重复任务的脚本、参考资料和资产。

Skills 的结构

Section titled “Skills 的结构”

每个 Skill 由一个必需的 SKILL.md 文件和可选的打包资源组成。

文件规范：文件夹名用小写字母+连字符；SKILL.md 必需，YAML 头部含 name、description（第三人称描述触发场景），正文建议 ≤500 行。

Skills 目录结构
skill-name/
├── SKILL.md (必需)
│   ├── YAML frontmatter 元数据 (必需)
│   │   ├── name: (必需)
│   │   └── description: (必需)
│   └── Markdown 指令 (必需)
└── Bundled Resources (可选)
    ├── scripts/          - 可执行代码 (Python/Bash 等)
    ├── references/       - 旨在根据需要加载到上下文中的文档
    └── assets/           - 用在输出中的文件 (模板、图标、字体等)

SKILL.md (必需)

Section titled “SKILL.md (必需)”

这是 Skill 的核心定义文件。

元数据 (YAML Frontmatter):name 和 description 决定了 AI 何时会使用这个 Skill。描述需具体说明 Skill 的功能和使用场景。

示例：

SKILL.md 示例
---
name: pdf-editor
description: This skill should be used when users ask to modify, rotate, or extract text from PDF files.
allowed-tools: # 可选，指定允许使用的工具
disable: false # 可选，是否禁用
---


# PDF Editor


To rotate a PDF...

打包资源 (可选)

Section titled “打包资源 (可选)”
  1. Scripts (scripts/) 用于需要确定性可靠性或被重复重写的任务的可执行代码。
  • 用途：当代码被重复重写或需要高可靠性时。
  • 示例：scripts/rotate_pdf.py 用于 PDF 旋转。
  1. References (references/) 旨在根据需要加载到上下文中以辅助 AI 思考的文档和参考资料。
  • 用途：数据库架构、API 文档、领域知识、公司政策等。
  • 优势：保持 SKILL.md 精简，仅在 AI 确定需要时才加载。
  1. Assets (assets/) 不打算加载到上下文中，而是用于 AI 生成的输出中的文件。
  • 用途：品牌资产、PPT 模板、HTML/React 样板代码等。

渐进式披露设计原则

Section titled “渐进式披露设计原则”

Skills 不是单一文本，而是文件夹结构，核心是 SKILL.md（含 YAML 头部与指令主体），支持渐进式披露，按需加载以节省 Token。

使用三级加载系统来高效管理上下文：

  1. 元数据 (Metadata)：始终在上下文中 (~ 100 词)。
  2. Skill 主体 (SKILL.md body)：当 Skill 被触发时加载 (< 5000 词)。
  3. 打包资源 (Bundled resources)：按需由 AI 加载 (无限制)。

创建 Skill 的流程

Section titled “创建 Skill 的流程”
  1. 理解需求：明确 Skill 的使用场景和触发条件。
  2. 规划资源：分析是否需要脚本、参考文档或资产模板。
  3. 创建目录：在 /skills/ 下创建新的 Skill 目录。
  4. 编写 SKILL.md：
  • 填写 YAML 元数据。
  • 编写 Markdown 指令。使用指令性语言（如 “To accomplish X, do Y”）。
  • 引用打包的资源。

最佳实践

Section titled “最佳实践”
  • 具体明确的描述：在 description 中清楚地说明 Skill 何时应该被使用。
  • 指令性语言：在 SKILL.md 中使用动词开头的指令，而不是第二人称。
  • 按需加载：将长篇文档放入 references/，避免 SKILL.md 过于臃肿。
  • 避免重复：信息应存在于 SKILL.md 或引用文件中，不要两处都有。

与 Prompt 等概念的区别

Section titled “与 Prompt 等概念的区别”
  • MCP：连接外部系统的“门禁卡”，负责授权调用外部能力，不负责执行流程。
  • Prompt：临时、一次性的自然语言指令，对话结束即失效。
  • Skills：可复用、稳定的“SOP 手册”，适合反复执行的流程。
  • Agents：具有思考能力的自主智能系统，负责理解目标、拆解任务、选择并调用 Skills、处理结果、反思纠错、完成复杂目标。
  • Experts：领域专家，负责执行复杂的任务，如数据库查询、API 调用等。 Skills与Experts的区别

Skills 大合集

Section titled “Skills 大合集”
  • SkillHub：腾讯出品，界面干净，找起来方便

SkillHub：腾讯 Skills 的官方仓库，包含各种开源 Skill。

  • Cocoloop Hub：热门精品更集中

Cocoloop Hub 的特点是把常用、热门的能力放得比较靠前。对刚开始找 Skill 的用户来说，不必先钻进巨大目录里筛半天，先看看大家都在用什么，效率会更高。

  • SkillsMP：技能库大，适合直接搜索

SkillsMP 更像一个面向 Skills 的大搜索库。你可以把它当成“需求驱动型”的入口：先想清楚自己要做什么，再按关键词去找对应能力。

  • Skills.sh：一键安装，跨平台更省事

Skills.sh 的价值在于安装和分发体验。对于经常在不同 Agent、不同工具之间切换的人来说，能把同一套能力更顺畅地带过去，会比反复复制说明和脚本舒服得多。

  • Claude Skills：中文界面，浏览门槛低

Claude Skills 对中文用户会更友好一些。查看介绍、判断用途、下载使用的路径比较直接，适合不想一上来就面对满屏英文文档的人。

参考资源

Section titled “参考资源”