mobile wallpaper 1
mobile wallpaper 2
mobile wallpaper 3
mobile wallpaper 4
mobile wallpaper 5
mobile wallpaper 6
2412 字
7 分钟
AI学习(四)- Skills
2026-03-10

简介#

介绍#

Skills是Anthropic推出的模块化能力包系统,通过渐进式披露机制实现按需加载,大幅提升Token效率。 skills是模块化的能力包,包含指令、脚本和资源,可以让Claude在需要时自动加载和使用。

Skills是封装了特定技术任务的标准化可复用模块,本质是将技术场景中的最佳实践、工作流、工具调用逻辑,固化为可被AI Agent或开发工具一键加载、调用的配置单元(常见格式如skill.md、YAML配置)。其核心价值在于解决技术场景中的重复开发、流程不规范、Prompt调试繁琐三大痛点——不用你每次处理同类任务,都重复编写脚本、调试参数、梳理流程,加载对应Skill就能直接执行。

模块化:Skills是一个个独立的文件夹,每个Skill做一件事

能力包: 每个Skill文件夹里可以包含:

  • SKILL.md(核心指令文件,必需)
  • scripts/(可执行脚本,可选)
  • references/(参考文档,可选)
  • assets/(模板和资源,可选)

自动加载

Claude会根据你的任务描述,自动判断需要哪个Skill,然后加载

不使用skills时需要审校文章时:

“帮我审校这篇文章。注意检查事实准确性,去掉AI味的表达,比如’不是…而是…'这种套话,
把长句拆成短句,段落不要太长,像手机屏幕3-5行这样,加粗不要太多,每200-300字1-2处就够了,还要检查是否像真人在说话…”

使用skill时,提前把规则写到skill里,会自动识别:

“帮我审校这篇文章”

渐进式披露机制#

渐进式披露机制:(Progressive Disclosure)是 Skills 系统的核心设计思想,简单来说就是: AI Agent 先只看”目录”,确定需要后,再加载完整”章节”。是一种按需加载知识的策略,目的是解决 AI 模型的”上下文窗口有限”这个根本瓶颈。

说白了就是只给 Agent 看 Skills 的名字和简短描述(几十 tokens)上下文清爽;Agent 快速判断需要哪个 Skill;然后 按需加载完整内容

渐进式披露机制分为三级:

  • 第一级别 元数据: 启动时加载,只需要skills名称和一句话描述,消耗几十token,让Claude知道有哪些Skills可用,什么时候该用哪个。 内容:SKILL.md文件开头的YAML部分,就两个字段:name和description。
---
name: ai-proofreading
description: 系统化降低AI检测率,增加人味。使用场景:审校文章、降低AI味、初稿完成后。
---
  • 第二级别 指令:触发时加载,任务匹配该skills时加载,需要 skill.md 完整内容,详细的操作指南,消耗几百至几千token,告诉Claude具体怎么做
  • 第三级别 资源:引用时加载,需要执行具体操作时;需要脚本,资源文件,token消耗数量几乎无限,脚本执行后只有输出进入上下文,代码本身不占Token。提供确定性的执行能力和详细的参考资料

Skills vs MCP vs Subagent#

MCP让Claude能碰到外部系统。Skills告诉Claude碰到之后怎么用。Subagent是派一个人出去干活。

MCP(Model Context Protocol)MCP的核心价值是连接。它解决的问题是”Claude能访问什么数据”。

Skills Skills的核心价值是程序化知识。它解决的问题是”Claude应该怎么做”。

Subagent Subagent的核心价值是并行执行和上下文隔离。它解决的问题是”怎么处理复杂的多步骤任务”。

维度MCPSkillsSubagent
核心作用连接外部系统提供程序化知识并行执行任务
类比发工具使用手册派助手
Token消耗高(预加载能力描述)低(按需加载)高(独立会话)
技术门槛需要写代码、配服务器写Markdown就行需要配置
能访问外部数据
适用场景需要实时数据重复性工作流复杂多步骤任务

使用场景: MCP:查询数据库,调用第三方API,读写Github等 Skills: 代码审查,文章校验,报告生成等重复性流程 Subagent: 任务复杂,需要并行执行

三者可以同时组合使用,三者是互补关系

Skills vs Workflow#

skills(技能)和 workflow(工作流)是两个核心且互补的概念,二者的本质区别在于:skills是AI完成单一任务的能力单元,workflow是多skills按逻辑串联形成的任务执行链路

对比

维度AI SkillsAI Workflow
粒度细粒度,单一能力单元粗粒度,多能力组合的完整流程
独立性可独立调用,不依赖其他skills依赖多个skills,需按规则协同
复用性高,可嵌入不同workflow中重复使用低,通常针对特定复杂任务定制
核心目标解决单一子任务解决复杂完整任务
灵活性能力固定,调整仅需优化自身参数灵活性高,可修改skills组合或执行逻辑

联系

  • skills是workflow的基础:没有独立可用的skills,workflow就成了“无源之水”,无法完成任何子任务。
  • workflow是skills的价值放大器:单一skills的功能有限,通过workflow编排,可将多个skills的能力叠加,解决更复杂的实际问题。
  • 动态适配关系:同一个skill可以被多个workflow复用;同一个workflow也可以根据需求替换不同的skills(比如将“文本摘要技能”替换为“长文精简技能”)。

skills 基本结构#

一个Skill就是一个文件夹,里面至少有一个SKILL.md文件。
skill.md 示例:

---
name: hello-skill
description: A simple greeting skill. Use when user says hello or asks for a greeting.
---
# Hello Skill
When user greets you, respond with a warm, personalized greeting.
## Guidelines
- Be friendly and natural
- If user mentions their name, use it
- Keep it brief (1-2 sentences)
  1. YAML Frontmatter(必需) 文件必须以YAML frontmatter开头,包含两个必需字段:name 和 description name是skill的唯一标识符

    • 最多64个字符
    • 只能用小写字母、数字、连字符
    • 不能以连字符开头或结尾
    • 不能有连续的连字符 description 告诉Claude什么时候用这个Skill
    • 最多1024个字符
    • 要包含 做什么 和 什么时候用
    • 触发关键词很重要
  2. Markdown主体(可选但建议有) 是skill的详细指令,没有格式限制,但建议包含:核心目标,执行步骤,示例输入输出,注意事项等

官方建议 主体部分控制在500行以内。如果需要更多内容,放到references/目录下

  1. 添加脚本和参考文档(进阶) 完整skill结构:
my-skill/
├── SKILL.md # 核心指令
├── scripts/
│ └── process.py # 可执行脚本
├── references/
│ └── DETAILED_GUIDE.md # 详细参考文档
└── assets/
└── template.md # 模板资源
  • scripts/: 可执行脚本:当SKILL.md中引用脚本时,Claude会执行它。脚本代码不进入上下文,只有执行结果进入
  • references/ :参考文档:当任务需要更多信息时,Claude会读取这些文档。采用渐进式披露,平时不加载
  • assets/ :模板和资源,比如报告模板、配置文件、样例数据

建议避免使用一个大的Skills,而是拆分为多个小的skills 优势:1. 按需加载,节省Token
2. 触发更加精准
3. 可自由组合

Skills的最佳实践

  • Description决定一切:做什么(核心功能)+ 什么时候用(触发场景)+ 触发关键词
  • 单一职责,每个Skill只做一件事
  • 渐进式披露,核心内容放SKILL.md,详细内容放references/SKILL.md应该简洁,包含核心流程和最常用的指令。详细的参考资料、边界情况、深入解释,放到references/目录下。
  • 脚本优于生成代码 如果一个任务可以用脚本完成,就写成脚本。
  • 从简单开始,逐步迭代

Skills使用#

Skills可以在多个平台使用:Claude Code、Claude API、Claude.ai。

这是最方便的平台。

  • 个人级Skills:放在 ~/.claude/skills/ 目录下。所有项目都可以用。适合:通用能力,比如代码审查、文档生成。
  • 项目级Skills:放在项目目录的 .claude/skills/ 下。只有当前项目可以用。适合:项目特定的规则,比如这个项目的代码规范、这个团队的工作流。

安装 从插件市场安装 或 直接下载解压到对应文件夹里

Skills 库和资源#

Karpathy-Inspired Claude Code Guidelines#

仓库地址:github仓库

claude 安装 此 skills : 按照官方仓库教程即可

  1. 启动 claude
  2. 添加市场 /plugin marketplace add forrestchang/andrej-karpathy-skills
  3. 安装插件 /plugin install andrej-karpathy-skills@karpathy-skills
  4. 重启 claude
  5. 运行指令查看结果 /skills 可以看到安装的可用的 skills

codex 安装此 skills 方式:

  1. 启动 codex
  2. 使用命令 $Skill Installer andrej-karpathy-skills@karpathy-skills 安装
  3. 重启 codex
  4. 运行 /skillsList Skills 查看安装的 skills

superpowers#

仓库地址: superpowers 一套完整的开发工作流Skills,包含:TDD、调试、代码审查、计划执行等,社区口碑最好的Skills库,设计理念先进

skills 仓库/资源#

  1. Agent Skills Marketplace
  2. ClawHub
  3. skillstore
  4. skills.sh

参考#

  1. 从 7 个顶级 Skill 中提炼的模式与最佳实践
  2. Qoder Skills 完全指南:从零开始,让 AI 按你的标准执行
  3. Agent Skills:打通可复用专业领域知识的最后一公里
  4. Skills:从编程工具的配角到Agent研发的核心
分享

如果这篇文章对你有帮助,欢迎分享给更多人!

AI学习(四)- Skills
https://niushaoxiong.top/posts/ai学习4-skills/
作者
一只捡星星的熊
发布于
2026-03-10
许可协议
CC BY-NC-SA 4.0

部分信息可能已经过时

目录