跳到主要内容

Skills 笔记

由旧稿重新整理版本,补全了 Skills 核心特征、与 Tool/Subagent/MCP 的关系、典型结构、构建工具、资源平台。旧稿目录已清理,当前以本文为准。

一、Skills 的核心定义​

Skills(技能) 是 Anthropic 提出的 Agent 扩展机制,其关键特征是:

AI 会自己判断什么时候该用这个技能,主动触发,而不是你手动去点选。

这是它和"菜单 / 按钮 / 工作流节点"最大的区别 —— Skills 是由模型在合适的时机自动调用的。


二、Skills 与周边概念的关系​

概念触发方式适合场景与 Skills 的区别
ToolLLM 在对话中按需调用单次原子操作(读文件、调 API)Tool 是细粒度能力,Skill 是一组 Tool + 指引 + 工作流的封装
Subagent由主 Agent 委派子任务子任务隔离、上下文分离Subagent 是 Agent 级拆分,Skill 是能力级封装
MCPLLM 通过 MCP Client 调用 MCP Server跨进程 / 跨服务的工具接入MCP 解决"工具如何接入",Skill 解决"能力如何组织"
Workflow预定义流程强规则、可重复Workflow 是显式编排,Skill 是隐式触发

一句话总结:Tool 是能力原语,MCP 是接入协议,Skill 是能力的有命名、可触发、可渐进披露的封装。


三、Skills 的典型结构​

一个 Skill 通常由以下部分组成:

my-skill/
├── SKILL.md # 必需:Skill 的元信息 + 使用说明
├── scripts/ # 可选:可执行脚本
├── references/ # 可选:参考文档(按需加载)
└── assets/ # 可选:模板、图片等资源

SKILL.md 顶部通常带 YAML frontmatter:

---
name: my-skill # 必填:Skill 名称
description: 简短描述... # 必填:模型据此判断何时调用
---

关键设计:description 字段就是 Skills "主动触发"的依据 —— 模型读到这个字段后,会在合适的对话情境下自动加载并启用该 Skill。


四、构建工具​

  • skill-creator:Anthropic 官方提供的 Skills 构建工具,可以帮助你从一个想法出发,逐步生成符合规范的 Skill 包。
  • 渐进式披露(Progressive Disclosure):构建 Skill 时的核心原则 —— 默认只暴露 Skill 元信息(name + description),模型决定调用时才加载详细内容,控制上下文占用。

五、资源平台​

官方​

社区​

国内生态​

资源地址说明
扣子技能商店coze.cn/skills国内生态最完整的 Skills 平台
小龙虾 Skills 中文官方库awesome-openclaw-skills-zh国内最重要的开源 Skills 资源库,按场景分类
腾讯 Skills Hubskillhub.tencent.com收录 1.3 万个 Skills,精选 Top 50 榜单
Skill 导航网站skillsmp.com/zhSkill 聚合站,可下载压缩包一键安装到扣子

六、使用经验小结​

  • description 写好很关键:模型靠它判断何时触发,写得不准会"该用不用"或"乱触发"。
  • Skill 内引用保持轻量:详细内容放 references/,按需加载,避免一次性占用过多上下文。
  • Skill 是组织能力,不是堆功能:一个 Skill 应聚焦一个完整场景,而非多个无关能力的合并。
  • 渐进披露是核心:把"必要信息 / 可选细节 / 资源文件"分三层,控制上下文膨胀。