最近網路上超級多 AI 使用 skill 的教學和資源, 大致上來說, 使用或參考別人寫好的的 skill, 有可能可以省下一些摸索,調教或試錯的時間.
但也有可能你誤以為使用了 skill 可以省時間, 反而花了更多時間, skill 類似別人用 prompt 與 script / template 先寫好了參考用的範本, 例如: 大家都是在做製件出甜的豆漿, 套用了別人的skill 一定是做出甜豆漿, 如果你又想省時間拿別人造好的輪子(skill) 來用, 又想要最後做出的是鹹豆漿, 你那就要有辧法看的懂和去修改別人的 skill.
要怎麼學習和使用 ai 的 skill, antigravity 的說明:
https://antigravity.google/docs/skills
Extend Claude with skills 說明:
https://code.claude.com/docs/en/skills
Agent Skills Marketplace, for the open SKILL.md ecosystem
https://skillsmp.com/
YouTube 教學影片:
- A man installed 300 agent skills. This Is What Happened To His Brain.
https://www.youtube.com/watch?v=0HIlhRl38QA - 爆火的Skills怎么用？数据分析，内容创作，编程实战Agent Skills
https://www.youtube.com/watch?v=3nm_hDALBmY - Understand what a large model is in 10 minutes.
https://www.youtube.com/watch?v=lnneAfJqd9M - 别再手写提示词了！用谷歌 antigravity “Skills” 技术解锁 AI 视频极致动态|提示词的进化：从“提示词工程”到“智能体技能”
https://www.youtube.com/watch?v=ey0WbwPEurk - Antigravity 新手入門｜為什麼這個 AI 工具讓我放棄 Gemini、ChatGPT
https://www.youtube.com/watch?v=lHkz99ohnQE - AI 编程工具都在用 Agent Skills：一键安装 + 推荐清单 + 编写最佳实践（Claude/Codex/OpenCode/Antigravity）
https://www.youtube.com/watch?v=nZW5xzVz9O0 - AI 秒变靠谱老员工！2026 最实用 AI 技能：Agent Skills 深度解析！原理+创建+使用！
https://www.youtube.com/watch?v=M4XIEjja1zI
Antigravity IDE 技能教學筆記
Antigravity IDE 是一個讓人工智慧幫你寫程式的平台。技能是給人工智慧用的工具包。它不是普通的對話紀錄。它像是一本說明書。告訴人工智慧在特定情況下該怎麼做。當你遇到重複的任務時。技能就能派上用場。這讓開發過程變得更像在指揮團隊。
檔案放在哪裡
技能是存在資料夾裡的檔案。你有兩種選擇。如果你只想讓某個專案使用。就放在專案根目錄下的 .agent/skills/ 資料夾。如果你希望所有專案都能用。就放在電腦個人設定夾裡的 ~/.gemini/antigravity/skills/ 底下。每個技能都要有自己的資料夾。資料夾的名字最好簡單易懂。
如何撰寫技能檔案
每個技能資料夾裡。一定要有一個名為 SKILL.md 的檔案。這個檔案的最上方要用 YAML 格式寫說明。裡面包含名稱和描述。這部分非常關鍵。因為人工智慧是靠描述來決定要不要使用這個技能。描述寫得越清楚。人工智慧就越聰明。
技能的內容重點
在 SKILL.md 的正文裡。你要寫下具體的指引。通常包含目標和執行步驟。你可以提供一些範例。讓人工智慧模仿。也要寫下限制條件。例如禁止刪除某些資料庫。這就像在教導新進員工。規則講得越細。出錯的機會就越小。
腳本與自動化
技能不只是文字說明。它還可以搭配腳本。你可以寫 Python 或 Bash 腳本放在同一個資料夾。在 SKILL.md 裡告訴人工智慧怎麼執行這些程式碼。人工智慧會自動幫你填入參數。這樣就能完成自動化測試或部署。這讓原本複雜的命令變得一鍵完成。
實際使用的感覺
寫技能的過程很像在整理筆記。這強迫你思考工作流程。當你寫好一個技能。下次遇到同樣問題時。人工智慧會自動偵測並套用。不需要你重複下指令。這種感覺非常神奇。它讓開發者從繁瑣的細節中解脫。把精力放在更有創意的事情上。
範例檔案內容
Markdown
---
name: my-python-tester
description: 當需要對 Python 檔案執行單元測試時使用此技能。
---
# 目標
自動執行專案中的單元測試並回報結果。
# 指引
1. 檢查目前目錄下的測試檔案。
2. 使用 pytest 執行所有測試案例。
3. 如果測試失敗，分析錯誤原因並提出修改建議。
# 限制
不要修改現有的原始碼檔案。
Claude Code Skill 的基本概念
Claude Code 的 Skill 就像是教 AI 學會新的工具。平常它只能做內建的事，但你可以給它專屬的指令。這讓 AI 能夠執行你專案中特定的任務。就像是幫 AI 裝上新的外掛工具。你可以讓它去操作你公司內部的腳本，或是執行複雜的打包指令。
建立 Skill 的設定檔
你需要在專案根目錄建立一個資料夾與檔案。路徑是 .claude/skills.json。這個檔案用來存放所有的自定義指令。AI 會在啟動時自動讀取這些設定。如果資料夾不存在就手動建立一個。這是讓 Claude 認識新技能的唯一地方。
檔案內容與格式
檔案內容必須符合 JSON 規範。每個項目需要有名稱、描述與指令。最核心的部分是描述文字。你要用白話文告訴 AI 這個指令在做什麼。當 AI 覺得你的需求跟描述相符，它就會主動執行該指令。
JSON
{
"skills": [
{
"name": "run_tests",
"description": "執行專案的單元測試並顯示結果",
"command": "npm test"
}
]
}
描述文字的重要性
描述是 AI 判斷時機的依據。寫得越直覺越好。例如你可以寫 檢查程式碼風格。當你對 Claude 說 幫我看看程式碼有沒有寫歪，它就會聯想到這個 Skill。描述不需要專業術語，只要能讓 AI 理解用途即可。
實際應用範例
假設你有一個清理快取的腳本。你可以定義一個名為 clean_cache 的項。描述寫成 清除專案的暫存檔案以解決建置問題。指令寫成 ./scripts/clean.sh。之後你只要對 Claude 說 幫我清理環境，它就會自動幫你跑腳本。這種自動化流程能省下很多打字時間。
注意事項與建議
描述寫得越清楚越好。指令必須在你的終端機環境中本來就可以執行。不要給 AI 太過危險的權限。確保你在執行 Claude Code 的環境已經安裝了必要的工具。這樣 AI 就能順利幫你處理各種瑣碎的雜事。
什麼是 Agent Skills？
Agent Skills 是一種創新的技術架構，它的核心概念是將專業知識、工作流程（Workflows）和最佳實踐（Best Practices）封裝成「可重複使用的檔案系統資源」。
你可以把它想像成一份給新進員工的「入職指南」。 過去，我們可能需要透過一次性、冗長的對話指令來教導 AI 完成任務；而現在，透過 Agent Skills，AI Agent 可以根據當下的需求，自動探索並載入這份「指南」，瞬間從通才變身為能處理特定任務的專家。
Skills 架構具備三大核心優勢：
- 專業化（Specialization）：能針對特定領域量身打造功能，例如法律文件審查、財務報表分析，或是符合特定品牌調性的內容創作。
- 重複使用性（Reusability）：一旦建立完成，就能自動應用在不同的對話、專案中，甚至可以跨越不同的相容 AI Agent 產品使用。
- 可組合性（Composability）：可以將多個獨立的技能（Skills）組合起來，構建出強大的工作流，用來處理複雜且多步驟的任務。
對使用者的核心價值
整合 Agent Skills 並非只是技術規格的升級，它對實際應用帶來了兩個實質的改變：
固化個人最佳實踐，提升工作效率
在日常工作中，你可能曾經引導 AI 非常完美地完成了一項複雜任務。過去，這個成功的互動可能就留在那次對話紀錄裡。現在，你可以一鍵將這個成功的流程封裝成個人的「Skill」。這等同於將你對特定任務的 Know-how（專業訣竅）和最佳實踐固定下來。未來遇到相同任務時，只需直接調用這個 Skill，就能穩定複製之前的成功流程，不需要重新下指令或試錯，大幅提升個人生產力。
降低進入門檻，複用團隊專業知識
對於團隊來說，成員的經驗與知識是最寶貴的資產。Manus AI 即將推出「團隊技能庫」（Team Skill Library），讓成員分享經過驗證的高效 Skill。這代表，新進成員或經驗較資淺的同事可以「站在巨人的肩膀上」，直接使用資深成員建立的 Skill 來執行任務。這不僅降低了操作門檻，更加速了團隊內部的知識累積與流動。
核心設計：漸進式揭露（Progressive Disclosure）
在技術實作上，Agent Skills 採用了一種極具效率的設計機制，稱為「漸進式揭露」。這個設計是為了確保 AI Agent 在處理任務時，能最有效地利用寶貴的上下文視窗（Context Window），避免資源浪費。
Skill 的內容被精細地劃分為三個層級，系統只會在必要時才將內容載入上下文：
- 第 1 層：元數據（Metadata）
- 內容：包含 Skill 的名稱與描述。
- 載入時機：系統啟動時載入。
- 成本：極低（每個 Skill 僅約 100 tokens）。
- 第 2 層：指令（Instructions）
- 內容：SKILL.md 檔案的主要操作指引。
- 載入時機：當該 Skill 被觸發時才載入。
- 成本：中等（通常小於 5,000 tokens）。
- 第 3 層：資源（Resources）
- 內容：相關的程式腳本、參考檔案、資產素材。
- 載入時機：依需求動態載入。
- 成本：僅在被引用時才會消耗運算資源。
