Skill 小白完整入门教程(做出你的第一个skill)

每个用 AI 工作的人都遇到过这个问题:

你教会它一件事,隔天开新对话,一切归零。

你花三天调好一套工作流程,跟 Claude 来回对话搞定了,隔天又要从头解释。

你把 prompt 存在笔记里每次贴,但一段 500 字的指令,每天贴一次,贴一个月,你开始怀疑,这真的是 AI 该有的用法吗?

Skill就是为了专门解决该问题而诞生的。

它在 2025 年 10 月由 Anthropic 推出,12 月成为开放标准。

如今全网都在喊”Skill 改变生产力”,但大多数人只是听说过,没真正搞懂它跟提示词、跟知识库、跟 MCP、跟智能体到底有什么区别,更没动手做一个出来。

本文一次讲透。

先理解一件事: Skill 不绑定任何 AI

很多人听到 Claude Skills 就以为这是 Claude 专属功能,其实完全不是。

Agent Skills 是 Anthropic 推出的开放标准,Claude 只是带头实现者。

同一个 Skill 文件夹,既可以放在 ~/.claude/skills/ 给 Claude Code 用,也可以放在 ~/.cursor/skills/ 给 Cursor 用,还能给 OpenAI Codex、Gemini CLI、VS Code Copilot、JetBrains Junie 用。

你今天写的 Skill,明天可以无缝搬到另一个 Agent 上,投入不会被锁死在一家。

文章下面会以 Claude Code 为主举例(因为它是标准制定者,生态最全),但所有原理、写法、避坑经验,对所有支持 Agent Skills 的 AI 工具都通用。

看到 “Claude Skill” 时,你心里要等同于 “Agent Skill”。

一、Skill 到底是什么

一句话定义

Skill 就是一个文件夹,核心是一个叫 `SKILL.md` 的 Markdown 文件,告诉 AI 按你定义的 SOP 稳定执行某类专业工作。

它把”某类事情应该怎么做”封装成可复用、可自动触发的能力模块。

它的本质是给通用 AI 装上的”扩展包”。

通用 AI 像出厂的裸机,智力够但不懂你的领域。Skill 是即插即用的功能模块——装上一个”小红书风格 Skill”,AI 立刻变成懂你品牌的小编;

装上一个”周报 Skill”,AI 立刻按你公司格式出周报。

而且这个”扩展包”不挑 AI:Claude Code、Codex、Cursor、Gemini CLI、Junie 都认得同一种格式。

你做的是 Agent Skill,不是 Claude 专属脚本。

和四个东西的边界

很多人把 Skill 和提示词、知识库、MCP、智能体混着说,其实分得很清:

通俗类比:

• 提示词 = 你给员工发了一条微信,说完就忘
• Skill = 你给员工写了一本工作手册放他桌上,还附带工具箱
• 知识库 = 图书馆,告诉你世界上有什么
• MCP = 厨房里的各种厨具,解决”能不能做”
• 智能体 = 整个员工系统,有记忆能决策,Skill 只是它身上的一个零件

这四件事不是互斥的。

实际工作里经常组合用:

MCP 让 Claude 连到 Reddit 抓数据,Skill 教它抓到数据后怎么筛选/分类/推荐,知识库 提供品牌资料库,智能体 是整个跑通的系统。

二、架构与运作机制

文件结构

skill-name/
├── SKILL.md          (必需:YAML 元数据 + Markdown 指令)
├── scripts/          (可选:可执行代码,确定性任务)
├── references/       (可选:按需加载的参考文档)
└── assets/           (可选:输出用的模板/素材)

每个子目录解决的是不同问题,但服务于同一件事——省 context、稳品质:

• scripts/ 不占 context 又算得准
• references/ 按需载入不浪费空间
• assets/ 让输出格式标准化

三层渐进式披露(Progressive Disclosure)——Skill 设计的灵魂

Skill 的核心机制是三层加载,这是它能在十几个并存却不爆 context 的根本原因:

打个比方:

Claude 启动时只翻所有 Skill 的”封面”,决定该用哪一本;

真要做事了才打开正文;

遇到需要查附录时才翻附录。

这套机制让你同时挂 17 个 Skill 也不会塞爆 200K 的 context 窗口。

YAML 元数据

---
name: your-skill-name
description: 这个技能做什么以及何时使用。包括触发上下文、文件类型、
  任务类型和用户可能提及的关键词。
license: MIT
allowed-tools: Bash, Read, Grep
trigger_keywords:
  - 关键词1
  - keyword2
version: 1.0
---

字段说明:

Description 决定生死

三层架构里,L1 的 description 是最关键的——它决定你的 Skill 会不会被触发。

几个核心事实:

1. Claude 启动时只读所有 Skill 的 description
2. 根据 description 做语义判断,不是关键字匹配
3. Claude 倾向保守:不确定就不触发,实测描述模糊时触发准确率只有 55%

反例(永远不会被触发):

description: 帮助处理日常工作。

正例(Anthropic 官方推荐”pushy”风格):

description: 每日工作规划流程。当用户说"规划今天""daily planning"
  "今日规划""开工"时使用。即使用户没明确说"规划"二字,
  只要在早晨问"今天做什么",也务必触发此 skill。

写好 description 的三条铁律:

1. WHAT + WHEN 一起写:既说做什么,又说什么时候用
2. 触发词中英文双语都列:用户怎么说就匹配什么
3. 宁可 pushy 不要保守:Anthropic 官方明确说,主流问题是欠触发