萬字干貨！Agent Skills從入門到精通

大家好，我是冷逸。

如果你要問我，2026年最值得學習的AI技能是什么？我會毫不猶豫地推薦Skills。

無論是Claude Code，還是龍蝦、愛馬仕，幾乎所有的Agent，如果想把事情干得又快又好，都越來越依賴Skills。

沒有Skills的Agent，就像一位剛入職的新同事，你得培訓，反復教他。而有了Skills的Agent，則更像是一位老同事，開箱即用，配合默契，非常靠譜。

“同事.skill”可能只是個玩笑，但“work.skill”一定是剛需，是生產力。甚至在我看來，Skills很可能是今年Agent領域最重要的創新之一。

簡單理解：模型是大腦，Agent是軀體，而Skills就是雙手。

現在，只是學會怎么“問”AI，其實已經有點不夠了。更重要的一件事是，學會怎么“教”AI。把你重復做的工作、團隊里的隱性知識、那些“只有老員工才知道”的操作細節，封裝成一個又一個的.skill文件。

它們會成為你最好的數字同事。不摸魚，不抱怨，隨叫隨到，而且越用越順手。

今天這篇文章，我會試著帶大家從入門到精通，徹底搞懂Skills——理解skill，成為skill，超越skill。

如果你是新手，相信一定會大有收獲；如果你是老司機，也會看到一些新的啟發。

如果覺得有用，歡迎點贊、在看、分享三連。一起學習，一起成長。

1、Skills是什么？——給AI發一本“員工手冊”

2025年10月16日，Anthropic首次發布Agent Skills。最初，Skills只能在Claude Code里使用，而且還必須是Claude的Pro付費用戶。

Anthropic發布Agent Skills

12月18日，Anthropic把Agent Skills作為統一標準，對外開放，不論你是不是Claude的付費用戶，都可以使用。

之后，很快像Codex、Cursor、Antigravity、OpenCode、Trae、Qoder、CodeBuddy等Coding Agent以及Claude Cowork、Skywork、MiniMax Agent、扣子等桌面Agent都陸續支持了Skills。

也包括，2026年春節后爆火的OpenClaw（中文名“龍蝦”）和最近大熱的Hermes Agent（中文名“愛馬仕”），也都支持Skills。

Skills，簡單翻譯過來就是“技能包”的意思。就像我們人一樣，有很多的技能，比如騎車、游泳、開車、烹飪、攝影等。Skills，就是我們人類專門給AI準備的技能包。

Anthropic官方定義：Skills是一套模塊化能力，允許開發者通過結構化的文件夾來增強Claude Code的能力。每個Skill都包含一個核心的SKILL.md文件以及相關的輔助資源文件。當用戶提出請求Claude Code時，它會根據請求內容和Skill的描述自動判斷何時調用相應的Skill來處理這個請求。

用一句話大白話來解釋：Skills就是我們專門給AI定制的“標準操作手冊（SOP）”。

每個Skill都有一個專門的文件夾（核心文檔 SKILL.md），用來放執行指令、資源文件和參考資料等。但千萬別小看這個文件夾，它能讓AI瞬間從“職場小白”變成“職場老司機”。

為了方便大家理解，我們不妨拿“開一家漢堡店”來打個比方：

• Prompt就像顧客的點單：“老板，給我做一個牛肉漢堡，不要洋蔥！”（指令很明確，但怎么做全看廚師心情）。

• MCP就像廚房里的工具和食材：它給了AI鏟子、平底鍋、牛肉餅和面包（AI終于不用空手套白狼了）。

• Skills是這家店的秘制菜譜+員工守則：“第一步，肉餅必須煎 3分半鐘；第二步，醬汁只能擠兩圈半；做完后，必須清理灶臺！”

Skills規定了動作的先后順序、質量底線和執行標準。有了它，AI就不再瞎猜你的心思，而是按部就班地干活。

2、拆解Skills的核心架構

簡單理解Skills后，我們從文件夾層面來對Skills的架構做一個剖析。

打開Claude Code的安裝文件夾（默認是在C盤，文件名.Claude），找到Skills文件目錄，通常你會看到這樣的文件架構。

「skill-creator」skill的文件夾架構

• SKILL. md：這是skill的核心指令，包括skill名稱、觸發條件、任務流程、執行指引等。

• scripts：用于存放可執行代碼（如Python、Bash腳本等）。

• references：用于存放按需加載的參考文檔，比如技術規范、API文檔、代碼片段、設計指南等，主要是給AI看的。

• assets：用于存放素材資源，比如模板、字體、圖片、logo、背景資料等。

通常，一份標準的Skill結構如下。

    └── assets/           - 資源文件

這里面，除了SKILL.md是必選項以外，其他都是可選項，可根據自己的skill需要進行靈活配置。

當Claude Code、OpenClaw這些Agent運行skill時，它會：

1. 以SKILL.md為第一指引，了解該skill對大模型的要求。

2. 結合當前的任務情況，判斷是否需要調用scripts（代碼腳本）、references（參考文檔）和assets（素材資源）。

3. 最后通過“規劃-執行-觀察”的交錯式反饋循環，來完成用戶制定的任務要求。

在整個架構中，SKILL.md最為關鍵，其內部架構如下：

SKILL.md內部剖析（圖by蒼何）

首先是skill的name，一般用英文和連字符“-”組成，比如一個前端設計skill，其name可以命名為「frontend-design」。

然后是description（描述），這是skill的YAML元數據非常重要的一環。其質量決定了該skill能否被Claude Code準確觸發。

比如，Anthropic官方的frontend-design skill，它的description字段內容如下。

「frontend-design.skill」的description字段

翻譯成中文，就是：

“創建具有高級設計感的獨特的、專業的、可用于實際生產的前端界面。當用戶需要開發網頁組件、頁面或應用程序時，可運用此skill。生成的代碼富有創意且精致，避免出現千篇一律的AI風格。”

因此，寫好SKILL.md中的description字段非常重要，因為它直接決定了Claude Code會在何種情況下自動觸發并加載該skill。如果description寫得不清晰或不準確，即使你的skill再強大，AI也可能在需要時“想不起來”使用它。

根據最新的Agent Skills最佳實踐和官方指南，以下是寫好description 的核心策略和模板：

1）核心原則：觸發即正義

Description的首要任務不是給人看的，而是給AI的路由機制看的。它需要明確回答兩個問題：

• 這個skill是做什么的？(功能定義)

• 用戶在什么場景/說什么話時應該使用它？(觸發條件)

2）“黃金結構”公式

一個高質量的description通常遵循這個結構：[一句話核心功能] + [具體執行動作] + [明確的觸發關鍵詞/場景]。

優秀寫法示例：

案例A：代碼審查技能

description: Reviews code for security vulnerabilities and best practices. Use when the user asks to "review code", "check for bugs", "analyze security", or mentions specific issues like SQL injection, XSS, or performance bottlenecks.

案例B：PDF 處理技能

description: Extracts text, tables, and metadata from PDF files; merges or splits documents. Use when working with PDF files, converting PDFs to text, filling forms, or when the user uploads a PDF and asks for summary/extraction.

簡單理解就是，寫好description的秘訣在于模擬用戶的提問方式。想象一下你會怎么向AI提出請求，然后就把這些請求中的關鍵詞都塞進description里。

通常，一個標準的SKILL.md，其Markdown格式大致是這樣：

展示使用該技能的具體代碼或操作案例。

比如，我們隨手創建一個「PDF分析」skill，它的SKILL.md設計如下。

2.提取后，請以結構化格式總結要點。

3、Skills的三個“魔法機關”

Skills的核心架構，藏著3個“魔法機關”，彼此協同工作。

比如，這是專門制作視頻的Remotion skill的SKILL.md設置：

Read individual rule files for detailed explanations and code examples:

它主要靠三個聰明的“機關”來約束AI：

機關一：智能開關（YAML元數據）

每個Skill文件的開頭（就是用---包裹的那塊），都有一個小小的控制面板，這是Skills的元數據，會始終加載到Claude Code的系統提示中。這就好比技能的“開關”和“權限卡”。

機關二：隨用隨取的“小抄”（漸進式披露）

過去的AI有個毛病：記性不好。如果我們把公司的所有開發規范都塞給它，它的“短期記憶（上下文窗口）”瞬間就被撐爆了，導致它開始胡言亂語（AI幻覺）。

Skills的設計非常聰明：平時絕不占用腦容量，只在需要時占用。

你寫好的幾十個Skills，就像存放在書架上的工具書。Claude Code平時不去翻它們，只有當你觸發了“測試代碼”的技能時，Claude Code才會翻出小抄，只把關于“如何測試”的那張紙加載進大腦。內存省了，思路也無比清晰。

機關三：呼叫外援與影分身（行動導向與子代理）

Skills可不只是讓AI讀說明書，它還能讓AI“動起手來”。

在Skill的指導下，Claude Code可以像人類一樣敲擊命令行、搜索文件、運行測試。更有趣的是，如果它碰到了一個極其復雜的巨無霸任務，它可以召喚一個“子代理”（Subagent）——就像是它召喚了一個自己的“影分身”，讓分身專門去隔壁房間解決那個大難題，搞定后再把結果匯報給自己。

這里面，漸進式披露（Progressive Disclosure）是Skills最牛的的設計哲學。

它讓Skills的所有信息不是一次性塞給Claude Code，而是分三層加載，根據需要逐步展示。

層級

內容

加載時機

Token配額

作用

第一層

元數據（name + description）

始終在上下文中

約100詞

決定skill何時觸發

第二層

SKILL.md 主體

技能觸發后

＜5000詞

核心工作流程

第三層

配套資源（ scripts/references/assets ）

按需加載

無限

詳細參考和可執行代碼

這種設計有什么好處？

想象一下，你有一個包含數百頁技術文檔的Skill。如果每次對話都把這些文檔加載進去，對話上下文（Context）很快就會被撐爆。但通過漸進式披露，Claude Code只在需要時才加載相關文檔——就像一本組織良好的指南書，你只看需要的章節，而不是從頭讀到尾。

4、Skills與Prompt、MCP、Agent、Projects的區別

簡單認識Skills后，相信你心中一定會有一個疑問：Skills和Prompt、MCP以及Agent、Projects他們之間到底有什么區別？

這里，我簡單做了張表，幫助大家理解。

簡單來說就是，Skills你可以理解為是預制菜，Prompt是現炒菜，Project是食材，MCP則是物流和外賣系統。通過Skills，做法早就“預設”好了，你只需要點菜名，AI馬上就能干活，又快又準，還省錢（Token成本）。

在Claude Code中，一個SKILL.md文件：

• 包含了超級精細的Prompt（告訴AI目標是什么，怎么做，做到什么效果）；

• 規定了AI可以且只能使用哪些工具、可執行代碼（給AI發放特定的武器）；

• 指揮Agent按照1-2-3-4的嚴格順序執行，絕不偏離軌道。

5、如何找到好用的Skills？

看到這里，你可能已經按捺不住激動的心情，想要立刻給自己的電腦裝上幾十個Skills。

這里有3個渠道，供大家獲取優質Skills。

1）官方推薦

如果你不想折騰代碼，只想開箱即用，這是最好的入口。

在Github上，Anthropic官方已經為你預置了一批極其強大的“基礎Skills”。比如專門用來處理幾百頁復雜數據的xlsx skill，或是能自動排版輸出商業演示文稿的pptx skill。你只需要輸入一句話，AI就能瞬間掌握了這些高級手藝。

Anthropic Skills：

https://github.com/anthropics/skills

Anthropic官方Skills

這里面，特別是「Skill-creator」，強烈建議你一定要安裝一下。這是一個安裝skill的skill，在Github上已經超過80k star了。有了它后，今后自己創建任意skill都變得極其簡單。

Skill-creator：

https://github.com/anthropics/skills/tree/main/skills/skill-creator

Skill-creator.skill

安裝命令超級簡單，打開你的Claude Code，在里面輸入這句話就可以了。

幫我安裝這個skill，倉庫地址是： https://github.com/anthropics/skills/tree/main/skills/skill-creator

skill-creator安裝命令

2）開源Skills市場

既然Agent Skills是開放標準，全世界最聰明的開發者自然都在為它添磚加瓦。

agentskills.io：它們就像是AI時代的“應用寶”或“npm軟件源”。作為官方推薦的全球技能注冊表（Registry），在這里你可以搜到各行各業專家的“心血之作”。

GitHub開源寶藏庫：程序員對開源的熱情永遠最高。你可以直接去GitHub上搜索官方的anthropics/skills倉庫，或者社區維護的awesome-agent-skills列表。看到大牛寫的優質SKILL.md，直接下載到你的本地文件夾里就能用。

這里，特別推薦一下Github上的「OpenSkills」，這個開源倉庫兼容了多個平臺，可以自動創建項目規則Markdown文件，“教會”其他AI Agent使用Skills。

OpenSkills項目地址：

https://github.com/numman-ali/openskills

其他skills市場。隨著生態的爆發，現在甚至出現了專門針對Skills的商業大賣場，比如skillsmp.com和skillsdirectory.com，也可以找到一些不錯的skills。

另外，x上也有很多開發者分享自己的開源skills，可以通過關鍵詞搜索查找。

3）終極來源：自己創建

不要光顧著去外面“淘寶”，全網最好用的Skill，往往是你自己寫出來的。

外部下載的技能再好，也是通用的常識；而真正能為你建立商業護城河的，是你自己那些“不外傳的業務秘密”：

• 你們公司特有的代碼命名規范；

• 你們金牌銷售應對客戶退款的私域話術；

• 你們財務部處理復雜報銷的發票合規底線。

6、手把手教你制作Skills：信息圖生成器

日常工作中，我們想要把干巴巴的文字做成精美的可視化信息圖，不妨參考這段提示詞來生成。

提煉下面文字內容的核心關鍵點，創建一個HTML網頁。 文字內容： {這里是一段文字} 網頁的設計要求如下： 1.視覺設計：采用{Magazine Layout}風格布局，{深色}主題色，營造現代高端氛圍。 2.字體與排版： ·使用超大字體或數字突出核心要點，中文采用大號粗體，強調視覺沖擊力。 ·英文使用小號字體作為點綴，與中文形成比例反差，提升設計層次感。 3視覺元素： ·融入超大視覺元素（如標題、背景圖或裝飾）以突出重點，與小型元素形成強烈對比。 ·使用簡潔的勾線風格圖形作為數據可視化或配圖元素，保持現代感和清晰度。 4.色彩與效果：運用高亮色（單色透明度漸變）營造科技感，每種高亮色獨立使用，避免不同高亮色之間的漸變混雜。 5.技術要求：引入專業圖標庫（如Font Awesome或Material Icons，通過CDN加載），避免使用emoji作為主要圖標。 6.內容要求：提煉內容關鍵要點，不忽略重要細節。

比如，我用這段提示詞整理一個模型信息，AI能夠給到我一個非常直觀的信息圖。

Qwen3.6-Plus模型信息圖

但如果每次我們都自己去復制提示詞，再去AI Chat網站生成，再下載、截圖，就很麻煩。

現在，我們不妨用這段提示詞來制作一個叫「HTML信息圖生成器」的skill，安裝到我們的Claude Code或龍蝦（OpenClaw）里。以后需要使用時，直接告訴它「調用“HTML信息圖生成器.skill”生成xxx」就行。

首先，我們給這個skill取個名字。為了讓不同模型更好地認識我們的skill，我們給skill取名字時盡量使用小寫英文，而且要語法標準。比如我這個skill的name，就叫做「html-infographic-generator」，每個單詞之間用連字符“-”連接。

然后，我們按照前文給大家介紹過的Skills文件結構，給我們的這個skill設計一個架構。信息圖生成器需要的文件架構并不多，一般放個必選的SKILL.md文件就可以了。如果需要，你也可以放一些諸如設計指南之類的資源文件在reference文件夾里，以及放些參考示例在assets文件夾里。

│   └── design-guide.md         # 詳細設計指南

取好名字、設計好文件結構后，接下來是最關鍵的環節，給skill設計SKILL.md文件。“.md”即Markdown格式的意思，是一種非常輕量級的標記語言，旨在用易讀易寫的純文本格式編寫文檔，通常用#、*、-等符號來實現格式化，可以隨時轉換為HTML/PDF。

SKILL.md通常包含這幾個部分。

展示使用該技能的具體代碼或操作案例。

最上面用三個連字符---包裹的區域，叫YAML元數據，包含name和description字段，這是Claude Code或OpenClaw這些Agent用來識別Skill的名片。

比如我們這個「html-infographic-generator」，它的YAML元數據就是：

---

這段YAML元數據的意思是說，這是一個HTML式的信息圖生成器，可以幫助用戶把文字生成信息圖HTML網頁，當用戶需要內容可視化、創建信息圖、生成數據展示頁面或制作圖文混排頁面時，就會加載這個skill。

這里面的description字段是比較關鍵的一環，它決定了Agent會在何時自動調用這個skill。

在設計description字段時，一定要堅持用第三人稱來寫，比如寫成“把用戶上傳的文字生成HTML”，而不是“你幫我把這段文字生成HTML”，這是區別于Prompt一定注意的地方。字數上，一般不超過500字就可以了。不用太多，盡量包含skill觸發的關鍵詞就就夠了。

寫好YAML元數據后，下面是具體的執行指令，一般從Prompt來進行優化，比如我的「html-infographic-generator.skill」，它的執行指令是：

**輸出**：時間線風格的HTML信息圖

這里面有skill的任務目標、設計規范、操作步驟、資源索引、注意事項和使用示例。詳細規范了skill應該如何工作、執行和輸出，全程用Markdown格式來寫。

為了讓Agent更好的理解這個skill，我還建了一個references參考文件夾，里面放了一個信息圖設師指南design-guide.md。

```

design-guide.md全文太長，詳細略（需要全文版可私信我）

這個design-guide.md詳細闡述了設計風格、設計要點、頁面布局模板以及設計檢查清單。你可以理解為，這是skill的注釋文件，它幫助skill理解這個技能任務。

整個就這2層結構、2份文件構成了我們的html-infographic-generator.skill，它可以將任何文字生成頂級審美的信息圖。

無需輸入Prompt，直接給文字就行。可以是鏈接，可以是附件，也可以是一大段文字，Agent會自己總結、提煉，生成頂級審美的信息圖HTML，特別適合做產品介紹、宣傳方案、新媒體素材等可視化內容。

這個skill，我已免費放在了扣子技能商店，輸關鍵詞「HTML信息圖生成器」查找，可以直接調用。

在扣子商店調用

Skill地址：

https://www.coze.cn/?skill_share_pid=7614920172729843731

7、安裝公開的skill

除了自己制作skill外，我們也可以安裝公開的skill。

通常，skill會放在GitHub這個全球最大的代碼開源社區上，比如Anthropic的一些開源skill，它就統一放在這里。

Anthropic的開源skill

倉庫地址：

https://github.com/anthropics/skills/tree/main/skills

除了Github，還有一些專門的skill市場也放了不少skill。

比如：

https://www.skillhub.club

https://agentskills.io

https://skillsmp.com

https://www.skillsdirectory.com

https://skillhub.tencent.com

安裝skill也很簡單，打開你的Claude Code或OpenClaw，在里面輸入這句話就可以了。

幫我安裝這個skill，倉庫地址是： https://github.com/anthropics/skills/tree/main/skills/skill-creator

這個「Skill-creator」，建議每個人都安裝一下，它是一個專門創建skill的Skill，在Github上已經有超過80k star了。

有了它后，今后自己創建Skill變得極其簡單。比如，我們只需要輸入這樣一句話：

用creator skill幫我創建一個word轉PPT的skill。

Agent會自己去設計框架、skill.md和運行腳本，幫你把這個skill創建好。

8、寫在最后

根據Anthropic官方文檔和社區實踐，創建并部署一個skill通常包含四個階段。

階段一：明確需求與邊界

在動手前，先回答清楚這三個問題：

1）這個skill要解決什么具體問題？原則是“單一職責”，每個skill只專注一個能力。例如，“處理PDF”太寬泛，而“從PDF中提取表格并轉換為CSV”就是好的定義。

2）觸發它的關鍵詞/場景是什么？這將決定description字段的寫法，而description是Agent判斷是否調用該skill的唯一依據。不要寫“幫助處理文檔”，而要寫“當用戶提到PDF、表單或文檔提取時，用于從PDF中提取文本和表格”。

3）需要哪些資源？腳本、模板、參考文檔還是示例數據？把這些提前整理好，放入skill文件夾的對應子目錄（如scripts/、references/、assets/）。

階段二：構建skill文件夾

在確定了需求之后，就可以創建skill的文件結構了。根據使用場景，你可以選擇三個存放位置。

類型

路徑

使用場景

個人skill

~/.claude/skills/

個人工作流優化、實驗性功能

項目skill

.claude/skills/

團隊協作、項目特定知識

插件skill

通過插件系統安裝

跨項目共享、公開發布

核心文件SKILL.md的結構如下：

邊界條件、常見陷阱等

命名規范：name字段僅使用小寫字母、數字和連字符，不超過64個字符。文件夾名稱須與name一致。

階段三：編寫核心指令

這是決定skill質量的關鍵步驟。Anthropic內部團隊的經驗表明，最有價值的內容是“常見陷阱”章節——應持續累積Agent的失敗模式，讓后來者可以直接繞坑。

一個高質量的SKILL.md通常包含以下要素：

1）明確的職責邊界：告訴Agent能做什么和絕對不能做什么。例如，一個SQL分析skill應明確限定只能執行SELECT查詢，禁止DROP、DELETE 等危險操作。

2）具體的操作步驟：用編號列表而非段落文字。Agent對結構化內容的遵循度遠高于敘述性文字。

3）輸入輸出規范：給出示例格式和預期輸出，這能顯著降低結果的隨機性。

4）硬性約束：使用“必須”“嚴禁”“總是”等絕對化詞匯。研究發現，包含至少3條明確約束和1個輸出示例的skill，其結果的穩定性可提升60%。

階段四：測試、調試與迭代

創建完成后，按以下清單驗證：

• 路徑檢查：確認SKILL.md位于正確的目錄（.claude/skills/ /）。

• YAML校驗：確保元數據格式正確，---包裹無誤。

• 觸發測試：用自然語言提問，觀察Agent是否識別并請求使用該skill。

• 執行驗證：檢查輸出是否符合預期格式和內容。

如果skill未被觸發，90%的情況是description寫得不夠具體。調試時可運行claude –debug查看詳細加載日志。

希望今天這篇文章，能幫你對Skills建立起一個更系統的認知。

但比“理解”更重要的是親手去做，嘗試去寫出你的第一個.skill，把那些重復的工作、熟悉的流程、甚至是你自己的經驗，慢慢沉淀成可以復用的能力。

當你真正開始制作skill的那一刻，很多關于Agent和Skills的理解，都會變得清晰起來。

如果你覺得這篇內容對你有所啟發，也歡迎點贊+在看+分享三連支持一下。

我是冷逸，努力給大家分享一些有用、有趣的AI干貨，我們下期再見。