貼上 SKILL.md 內容即可檢查 YAML frontmatter 格式、字數限制與 Agent Skills 規範。支援匯出 CSV 報告，純瀏覽器本地解析，確保內部工作流隱私。
在開發 AI 代理程式時，SKILL.md 檔案是定義技能的核心。它通常位於專屬資料夾中，頂部包含 YAML frontmatter，下方則是 Markdown 格式的具體指令。代理程式會優先讀取 name 與 description 欄位，以決定是否在當前任務中啟用該技能。為了確保檔案格式正確，開發者可以使用 SKILL.md 驗證器進行檢查。這個工具會在瀏覽器中解析貼上的檔案內容，並對照 agentskills.io 的官方規範進行比對。它主要檢查格式違規與結構建議，但不會驗證連結的檔案是否存在，也不會評斷指令本身的邏輯品質。對於除錯代理程式無法載入技能的問題，這是首要的排查步驟。
Frontmatter 是 SKILL.md 檔案的元數據區塊，必須嚴格遵守格式與字數限制。name 與 description 是必填欄位。name 最多允許 64 個字元，僅能使用小寫字母、數字與單個連字號，且必須與所在的資料夾名稱完全相符。description 的上限為 1,024 個字元，而選填的 compatibility 欄位則限制在 500 個字元以內。如果 YAML 語法出現錯誤，例如冒號後未加空格、使用了 Tab 鍵或縮排不正確，SKILL.md 驗證器會直接回報錯誤。在處理複雜的數據結構時，開發者有時會借助 JSON 轉換為 YAML 或 YAML 轉換為 JSON 工具來確保語法正確性，避免基礎格式問題阻擋技能載入。
description 欄位是代理程式選擇技能的唯一觸發條件，其撰寫品質直接決定了技能是否會被正確呼叫。如果描述過於簡短，少於 60 個字元，SKILL.md 驗證器會發出警告，提示這可能導致代理程式忽略該技能。一個優秀的描述應該清晰說明技能的功能，並明確指出何時使用。若內文缺乏相關的使用時機說明，驗證器會提供相應的提示。許多開發者遇到技能未被觸發的問題，往往是因為描述過於模糊或遺漏了觸發條件。確保描述精煉且具備高度指示性，是提升代理程式工作效率的關鍵所在。
SKILL.md 的內文不能為空，且需要控制在合理的長度範圍內。SKILL.md 驗證器會檢查內文是否少於 20 個單字、超過 500 行，或估計超過 5,000 個 token。此 token 數量是基於每個 token 約 4 個字元的粗略估算，對於中文等非拉丁語系文本，實際 token 消耗可能會有所不同。為了保持檔案精簡，建議將詳細的參考文件移至 references/ 資料夾，並使用相對路徑進行一層深度的連結。避免使用絕對路徑或深層巢狀結構。內文中若殘留 TODO 或 lorem ipsum 等佔位字元，也會觸發警告，提醒開發者在發佈前清理測試內容。
在定義技能時，了解標準規範與特定平台擴充功能的差異非常重要。Agent Skills 規範定義了通用的標準欄位，但 Claude Code 支援額外的專屬欄位，例如 model 與 hooks。當 SKILL.md 驗證器偵測到這些專屬欄位時，會將其標示為提示，提醒開發者這些欄位在其他代理程式中可能會被忽略。為了維持可移植性，未知的自訂欄位應統一放置於 metadata 區塊下。同時，allowed-tools 目前仍屬實驗性功能，規範建議使用空格分隔的字串格式，而非 YAML 清單。遵循這些指引能確保技能在不同 AI 平台間具備良好的相容性。
SKILL.md 驗證器的報告分為三個層級：錯誤、警告與提示。錯誤代表違反規範，會導致檔案無效；警告代表違反最佳實踐建議；提示則提供額外的相容性資訊。只要沒有錯誤，檔案即被判定為有效。報告底部提供檔案統計數據與發現表格，支援匯出為 CSV 格式以便團隊追蹤。在隱私方面，所有解析與驗證過程完全在瀏覽器本地端執行，無需註冊帳號，也不會將任何程式碼上傳至伺服器。這對於包含企業內部工作流程或敏感邏輯的技能至關重要。若您的自動化流程需要額外的驗證金鑰，可搭配 Web Bot Auth Key Generator 使用。
將完整的 SKILL.md 檔案內容貼上至輸入框，若有指定的資料夾名稱也可一併填入，接著點擊執行即可。工具會解析 YAML frontmatter 並輸出驗證結果、檔案統計數據與發現的問題清單。所有運算皆在瀏覽器本地端完成，您可以匯出 CSV 格式的報告以便後續追蹤。
本工具完全免費且無需註冊任何帳號。由於開發者的技能檔案通常包含內部工作流程或敏感資訊，所有的解析與驗證過程均在您的瀏覽器本地端執行，不會將任何程式碼或文字上傳至伺服器，確保資料絕對隱私。
最常見的原因是 description 欄位過於簡短或模糊，缺乏明確的觸發時機描述。Agent 主要依賴這行描述來決定是否載入技能，若字數低於 60 個字元，驗證器會發出警告。其次才是檢查 frontmatter 是否包含格式錯誤或必填欄位缺失。建議在描述中清楚說明技能的用途與使用情境。
name 欄位為必填項目，長度不可超過 64 個字元，且僅能使用小寫字母、數字與單個連字號。為了確保可攜性與正確載入，該名稱必須與您選填的資料夾名稱完全一致。若名稱包含大寫字母或無效字元，驗證器會將其標記為錯誤。
不會報錯，但會顯示為提示。這些屬於 Claude Code 的擴充欄位，在該環境中有效，但其他 Agent 可能會忽略它們。為了保持跨平台的相容性，建議將非標準規範的自訂欄位統一放置於 metadata 區塊中，並留意 allowed-tools 目前仍屬實驗性質且需以空格分隔的字串格式填寫。
這表示 frontmatter 的 YAML 語法有誤，導致解析器無法讀取。常見原因包含冒號後未加空格、使用了 Tab 鍵縮排、或是縮排層級不一致。若您對 YAML 格式不熟悉，可以先使用 YAML 轉 JSON 工具 來檢查語法結構是否正確，確認無誤後再貼回驗證器。
是的。驗證器將結果分為錯誤、警告與提示。只要錯誤數量為零，該檔案即被視為有效。警告通常是針對規範建議的偏離，例如描述字數過少、內文超過 500 行或包含絕對路徑連結，修正這些警告能提升技能的載入效率與可讀性。
驗證器採用每 4 個字元約等於一個 token 的粗略估算方式。這種演算法對於英文等拉丁語系文字具有一定的參考價值，但對於繁體中文等非拉丁語系文字，實際 token 數量可能會有所差異。建議將此數據作為預算上限的參考，若內文過長，可將詳細說明移至 references 資料夾中以保持主檔案精簡。
