skill-writer

skill-writer 是專為設計給自主代理使用的技術文檔而開發的核心工具。它標準化了 SKILL.md 文件的創建過程，確保內容能被 ClawdHub 或 MoltHub 等註冊表正確索引，並能被基於 LLM 的代理輕鬆解析。透過強制執行一致的結構模式，該工具協助開發者定義明確的觸發場景、元數據和以任務為中心的內容區域，從而顯著提升代理的激活率與執行表現。

• 標準化 YAML 前端元數據，包括名稱、描述及 clawdbot 元數據模式。

• 提供「何時使用 (When to Use)」模板，以明確代理的激活觸發條件。

• 推動以任務為導向的內容結構，取代過於抽象的概念解釋。

• 強制執行包含語言標識符與真實數據範例的可運行代碼塊。

• 定義跨平台支援 (linux, darwin, win32) 及相依性管理 (requires.anyBins)。

• 在創建新技能時使用此工具，以確保其具備機器可讀性並針對向量搜索進行語義優化。

• 極適合作為 CLI 包裝器、自動化腳本及項目級任務運行器的文檔編寫標準。

• 描述建議採用「做什麼。適用於 [觸發場景]。」的格式，以優化搜索索引。

• 確保代碼塊包含輸出註解與具體的技術實現，以避免代理執行時的模糊性。

• 在最終發布前，務必使用註冊表查詢工具驗證技能別名 (slug) 是否衝突。

• 務必加入「提示 (Tips)」章節，提供經淬煉的專家建議，讓代理在執行過程中能優先參考。