在 Claude Code 中建立可重用的 Agent 技能資料夾，能夠幫助開發者統一工作流，並在多個專案中輕鬆使用相同的技能。本文將指導你如何撰寫 SKILL.md 檔案，並確保這些技能能夠與 Cursor 工具兼容，讓你的開發過程更加高效。
本文目錄：建立技能資料夾、SKILL.md 檔案結構、用途與選擇、實作示例、成本與限制、常見問題、下一步、文章參考資料。
核心解釋
Claude Code Skills 是一種結構化的技能檔案，旨在幫助開發者在不同專案中重用相同的技能。這些技能通常存放在 .claude/skills/ 資料夾中，每個技能都有一個對應的 SKILL.md 檔案。該檔案包含技能的名稱、描述及其他必要的元數據（frontmatter），使其能夠在不同的工具間共用。
為了確保技能的可攜性，建議使用標準的 frontmatter，避免包含特定於 Claude 的鍵，例如 context: fork 或 hooks 等。這樣可以確保技能在使用 Cursor 等其他工具時不會出現兼容性問題。
用途與選擇
使用 Claude Code Skills 的主要好處是能夠在多個專案中重用相同的技能，這對於需要統一工作流的開發者來說尤為重要。這樣不僅可以節省時間，還能減少重複工作，提升開發效率。
當你需要在不同的專案中使用相同的技能時，選擇將這些技能存放在 .claude/skills/ 資料夾中是最佳方案。這樣做可以確保所有專案都能輕鬆訪問這些技能，並且在更新技能時，所有專案都能自動獲得最新版本。
實作示例（教學示例）
以下是如何在 .claude/skills/ 資料夾中建立一個新的技能資料夾及其 SKILL.md 檔案的步驟：
- 步驟 1：在你的工作目錄中創建一個新的資料夾，例如 .claude/skills/my_skill。
- 步驟 2：在該資料夾中創建一個名為 SKILL.md 的檔案。
- 步驟 3：在 SKILL.md 檔案中添加必要的 frontmatter，例如 name 和 description。
- 步驟 4：確保不包含任何特定於 Claude 的鍵，以保持技能的可攜性。
- 步驟 5：完成後你會得到：一個可重用的技能，並能夠在多個專案中使用。驗收：檢查 SKILL.md 檔案是否正確無誤且符合格式要求。
成本與限制
在使用 Claude Code Skills 時，主要的成本來自於開發時間和維護技能的精確性。若技能的 frontmatter 設定不當，可能會導致兼容性問題，進而影響工作流的效率。因此，開發者需謹慎設計每個技能的 SKILL.md 檔案。
此外，雖然 Claude Code 和 Cursor 都支持 .claude/skills/ 資料夾，但並不保證 Claude Code 會讀取 .agents/skills/ 資料夾中的技能。因此，建議將所有共用技能集中在 .claude/skills/ 資料夾中，以避免混淆。
| 項目 | 說明 |
|---|---|
| 資料夾結構 | 技能資料夾名對應 SKILL.md 的 name。 |
| 共用能力 | Cursor 亦可載入 .claude/skills/。 |
| frontmatter 建議 | 只保留標準的 frontmatter，如 name 和 description。 |
| 技能指令 | 技能通常對應斜線指令。 |
| 官方參考 | 以官方文件為準，避免使用不明來源的說明。 |
1. 在你的工作目錄中創建一個新的資料夾，例如 .claude/skills/my_skill。
2. 在該資料夾中創建一個名為 SKILL.md 的檔案。
3. 在 SKILL.md 檔案中添加必要的 frontmatter，例如 name 和 description。
4. 確保不包含任何特定於 Claude 的鍵，以保持技能的可攜性。
5. 完成後你會得到：一個可重用的技能，並能夠在多個專案中使用。常見問題
如何確保我的技能可以在不同工具間共用？
為了確保技能的可攜性，建議只使用標準的 frontmatter，避免包含特定於 Claude 的鍵。
Claude Code 和 Cursor 的技能有什麼不同？
Claude Code 的技能主要存放在 .claude/skills/ 中，而 Cursor 則可以載入這些技能，但不一定支持 Claude 的特定格式。
如何檢查我的 SKILL.md 檔案是否正確？
可以通過檢查 frontmatter 的格式及內容，確保符合標準結構來驗證。
我可以在技能中使用哪些鍵？
建議使用 name 和 description 等標準鍵，避免使用 Claude 專屬鍵。
如果我在使用過程中遇到問題，該如何處理？
可以參考官方文件或尋求社群的幫助，以獲得更詳細的解決方案。
下一步
若想進一步了解 Claude Code 的使用，請參考以下連結：Claude Code Mods 第一個 mod 教學、Cursor Agent Skills 教學（同批），或考慮參加我們的一對一項目指導。
文章參考資料
以上公開資料於 2026 年 10 月 13 日查閱。
學習 AI，保護你的未來。
