更新日期:2026年6月19日
先講結論
剛開始不要到處下載 Skill。比較穩的做法是:
- 看官方文件,理解 Skill 的結構與用途。
- 先精讀 Anthropic 官方
skill-creator,把它當成「如何寫 Skill」的主範例。 - 其他官方 Skills 先用清單快速掃過用途,不要一口氣全部安裝。
- 確認內容合理後,再複製到自己的本機 agent 資料夾。
Skill 是什麼?
一般聊天 AI 主要靠你這次貼上的內容回答。Skill 則把一套常用流程寫下來,讓 agent 遇到特定任務時,有固定的啟動條件、步驟與限制。
工作說明書
通常是 SKILL.md,寫清楚什麼時候啟動、要照哪些步驟做、哪些事情不能做。
輔助檔案
可能包含 prompt、範本、腳本、參考資料,讓 agent 不用每次重新摸索。
安全邊界
好的 Skill 會寫清楚能讀寫哪裡、不能碰什麼資料、遇到刪除或覆寫時要先問你。
如果想看 Antigravity 裡 SKILL.md、description 觸發與資料夾結構如何實作,可以接著讀 Ep.2 Agent Skills 實戰攻略。
Skill 安裝位置懶人表
先記兩個原則:新專案優先用 .agents/skills,而且先放專案內,不要一開始就放全域。專案內 Skill 只影響目前這個資料夾;全域 Skill 會影響你之後打開的很多專案,熟悉後再用比較穩。
| 情境 | 優先記 | 例外或全域位置 | 判斷方式 |
|---|---|---|---|
| Codex 專案 Skill | .agents/skills/<skill-name>/SKILL.md |
~/.agents/skills/<skill-name>/SKILL.md |
這是目前最適合先記的共通寫法;放專案內確認常用後,再考慮全域。 |
| Antigravity 2.0 專案 Skill | .agents/skills/<skill-name>/SKILL.md |
Antigravity CLI 或版本差異可能有專用全域資料夾,操作前看官方文件或工具提示。 | 如果是 PRD、會議摘要、轉錄整理這種專案流程,先放專案內。 |
| Claude Code | .claude/skills/<skill-name>/SKILL.md |
~/.claude/skills/<skill-name>/SKILL.md |
Claude Code 目前仍照 Claude 官方路徑;不要硬改成 .agents/skills。 |
| Claude.ai / Anthropic 官方預建 Skills | 通常在 Claude 產品介面內使用 | 不等於本機資料夾安裝 | 用官方內建能力學概念即可,不要把網頁版 Skill 和本機資料夾 Skill 混在一起。 |
路徑提醒:看到舊教學或舊截圖寫 .agent/skills 時,不用緊張。它通常是舊版或相容寫法;新專案建議優先使用 .agents/skills。但 Claude Code 是例外,仍照 Claude 官方使用 .claude/skills。
每個 Skill 都應該是一個獨立資料夾,而且資料夾裡一定要有 SKILL.md。
新手先精讀 Anthropic skill-creator
為什麼先看它?
skill-creator 是 Anthropic 官方 repo 裡專門用來建立、修改與改進 Skills 的 Skill。它不只是展示一個完成品,而是把「做出一個好 Skill」拆成可重複的流程。
- 它會先釐清 Skill 要解決什麼問題,而不是一開始就堆 prompt。
- 它重視測試 prompts、執行結果檢查與反覆改版,適合學「怎麼驗證 Skill 有沒有真的變好」。
- 它會碰到
description觸發條件、輔助 scripts、評估流程與輸出檢查,是理解 Skill 架構最完整的官方範例之一。
建議讀法:先讀 SKILL.md 的 frontmatter 與開頭流程,再看它如何把評估、比較與迭代拆到 scripts 或附加檔案。第一次不用直接安裝到重要專案,先把它當成設計模板來拆解就好。
其他 Anthropic 官方 Skills 快速看
下面這些先當用途索引,不需要每個都下載。真的遇到對應任務時,再打開該資料夾讀 SKILL.md 與 scripts。
docx/pdf/pptx/xlsx:文件、PDF、簡報與試算表處理,適合看複雜工具型 Skill 怎麼組織。claude-api:Anthropic API 開發參考,有做 API 或 SDK 專案時再看。frontend-design/webapp-testing/web-artifacts-builder:前端設計、網頁測試與 web artifact 建立,適合網站或互動介面任務。mcp-builder:建立 MCP server 的範例,偏進階,等理解基本 Skill 結構後再讀。brand-guidelines/internal-comms/doc-coauthoring:品牌、內部溝通與共同寫作流程,適合看業務情境如何變成可重複指令。algorithmic-art/canvas-design/theme-factory/slack-gif-creator:創意與視覺類範例,適合學資源、範本與輸出格式怎麼搭配。
推薦來源
Luke:從零建立本機 Vibe 轉錄 Agent Skill
這篇會真的建一個 Skill,不只講概念:從資料夾、SKILL.md、腳本、摘要到 HTML 輸出一路跑完。
Karpathy 相關資源怎麼看?
Andrej Karpathy 的內容很適合作為「AI agent 怎麼可靠做事」的思維來源,但我不會把它包裝成「Karpathy 官方 Skill 下載頁」。比較準確的標示方式如下:
| 來源 | 適合怎麼用 | 提醒 |
|---|---|---|
| karpathy/autoresearch | 看 AI agent 如何在明確目標、固定時間、可驗證指標下做研究實驗。 | 這是官方 repo,但不是新手可直接安裝的 Skill 包。 |
| Karpathy LLM Wiki gist | 當作建立個人知識庫與 AI 工作流的靈感。 | 這是想法文件,不是下載後就能跑的工具。 |
| andrej-karpathy-skills 社群 repo | 可以參考它如何把 Karpathy 的 AI coding 觀察整理成 CLAUDE.md 行為規則。 |
這不是 Karpathy 官方 repo。可以閱讀,不要盲目安裝。 |
下載 Skill 前的安全檢查
- 看來源:官方文件、官方 GitHub、你信任作者的 repo,優先級最高。
- 讀
SKILL.md:它要做什麼、會讀哪些資料夾、會不會執行腳本。 - 看 scripts:如果 Skill 裡有
.ps1、.sh、.py,不要沒看就執行。 - 不要放秘密:API key、token、公司文件、客戶資料,不要拿來測陌生 Skill。
- 用測試資料夾:第一次跑 Skill 時,用空資料夾或假資料測試,不要直接丟到重要專案。
建議學習順序
1. 看官方 Skills
不用急著安裝。先看 Anthropic 官方文件,再精讀 skill-creator,理解一個 Skill 如何從目的、流程、測試到迭代串起來。
2. 快速掃過其他官方 Skills
把其他 Skills 先當用途清單:知道它們解決什麼問題就好。遇到文件、前端、MCP 或品牌溝通任務時,再打開對應資料夾細讀。
3. 跑一篇站內實作教學
接著看 從零建立本機 Vibe 轉錄 Agent Skill,學會從資料夾、SKILL.md 到腳本如何串起來;如果你主要用 Antigravity,則搭配 Ep.2 Agent Skills 實戰攻略 看安裝位置與觸發方式。
4. 改成自己的 Skill
例如把「轉錄 Skill」改成「會議摘要 Skill」、「Excel 清理 Skill」、「週報整理 Skill」。不要一開始就下載一堆陌生 Skill。
5. 串成可重複 Workflow
當你已經有幾個穩定 Skills,再看 Ep.3 Agentic Workflows & Synergy,學會把多個專家能力串成可呼叫、可審核的流程。
參考來源
- Anthropic Agent Skills overview
- Anthropic official skills GitHub repository
- Anthropic official skill-creator Skill
- Claude Code Docs: Extend Claude with skills
- karpathy/autoresearch
- Karpathy LLM Wiki gist
- Community repo: andrej-karpathy-skills
- 站內教學:從零建立本機 Vibe 轉錄 Agent Skill
- 站內教學:Google Antigravity IDE 教學(二)Agent Skills 實戰
- 站內教學:Google Antigravity IDE 教學(三)Agentic Workflows & Synergy