Skills Guide

Skills Guide 是將可重複使用的專業知識打包為 Claude 可發現功能的基礎規範。它為 SKILL.md 檔案提供了標準化模板，確保自動化代理能在個人和專案層級的環境中一致地詮釋指令。此系統以模組化的檔案指令取代了手動的提示工程，讓 Claude 能根據語境啟動，從而減少重複輸入並提升開發者與專案經理的工作效率。

• 定義了必要的 YAML Frontmatter 要求，包括特定的命名慣例（動名詞形式）與描述性觸發條件。

• 概述了檔案結構模式，包括簡單的單一檔案技能，以及使用漸進式揭露的複雜多檔案模組。

• 提供編寫精簡且高效能指令的最佳實踐，強調使用具體範例與輸入/輸出對，而非解釋基礎概念。

• 標準化相依性管理與本地工具整合，例如整合 Python 指令碼以進行資料驗證或任務自動化。

• 透過 git 儲存庫促進專案特定技能的共享，提升團隊工作流程的一致性。

• 使用此指南來引導新專案功能，或標準化現有零散的提示庫。

• 確保 YAML Frontmatter 中的「description」欄位細緻且聚焦於意圖，因為這是 Claude 自動探索的主要依據。

• 將指令保持在 500 行以內以達到最佳的脈絡管理；對於更深入的說明文件，請使用個別參考檔案 (例如 FORMS.md, REFERENCE.md)。

• 透過迭代持續驗證技能效能；在部署前，使用公用程式指令碼與預定義的輸入/輸出範例來測試代理的可靠性。

• 清楚區分個人全域技能 (~/.claude/skills/) 與專案特定技能 (.claude/skills/)，以維持不同環境間的範圍完整性。