​

Skill 格式

​

磁碟上

• SKILL.md（或 skill.md；也接受舊版的 skills.md）

• 任何支援用的一般檔案（請參閱「Skill 檔案」）
• .clawhubignore（發布時的忽略模式，舊版為 .clawdhubignore）
• .gitignore（也會套用）

​

GitHub 匯入

• <skill>/.clawhub/origin.json（舊版為 .clawdhub）

• <workdir>/.clawhub/lock.json（舊版為 .clawdhub）

​

SKILL.md

• 含選用 YAML frontmatter 的 Markdown。
• 伺服器會在發布期間從 frontmatter 擷取中繼資料。
• description 會用作 UI／搜尋中的 Skill 摘要。

​

Frontmatter 中繼資料

​

基本 frontmatter

---
name: my-skill
description: 此 Skill 功能的簡短摘要。
version: 1.0.0
---

​

執行階段中繼資料（metadata.openclaw）

---
name: my-skill
description: 透過 Todoist API 管理工作。
metadata:
  openclaw:
    requires:
      env:
        - TODOIST_API_KEY
      bins:
        - curl
    primaryEnv: TODOIST_API_KEY
---

​

完整欄位參考

​

安裝規格

metadata:
  openclaw:
    install:
      - kind: brew
        formula: jq
        bins: [jq]
      - kind: node
        package: typescript
        bins: [tsc]

​

選用環境變數

metadata:
  openclaw:
    primaryEnv: TODOIST_API_KEY
    envVars:
      - name: TODOIST_API_KEY
        required: true
        description: 用於已驗證要求的 Todoist API 權杖。
      - name: TODOIST_PROJECT_ID
        required: false
        description: 使用者未指定時採用的選用預設專案 ID。

​

這為何重要

​

範例：完整 frontmatter

---
name: todoist-cli
description: 從命令列管理 Todoist 工作、專案和標籤。
version: 1.2.0
metadata:
  openclaw:
    requires:
      env:
        - TODOIST_API_KEY
      bins:
        - curl
    primaryEnv: TODOIST_API_KEY
    envVars:
      - name: TODOIST_API_KEY
        required: true
        description: Todoist API 權杖。
      - name: TODOIST_PROJECT_ID
        required: false
        description: 選用的預設專案 ID。
    emoji: "\u2705"
    homepage: https://github.com/example/todoist-cli
---

​

Skill 檔案

• 大小受限且包含有效 UTF-8 的檔案，可以逸出的純文字形式預覽，並納入 有限文字分析。
• 其他檔案會保留其確切位元組，並可供下載。
• 安全掃描器會收到完整的已儲存成品；文字偵測是呈現與 分析方面的考量，而不是上傳允許清單。

• 套件組合總大小：50MB。
• 嵌入文字包含 SKILL.md + 最多約 40 個大小受限的 UTF-8 檔案（盡力而為的上限）。

​

Slug

• 預設衍生自資料夾名稱。
• 套件範圍必須與 ClawHub 發布者代號完全相符。發布者代號可使用小寫字母、數字、連字號、句點和底線；開頭與結尾必須是小寫字母或數字。
• 套件 slug 必須為小寫且符合 npm 安全格式，例如 @example.tools/demo-plugin 或 demo-plugin。

​

版本管理與標籤

• 每次發布都會建立新版本（semver）。
• 標籤是指向版本的字串指標；通常使用 latest。

​

授權條款

• 所有發布至 ClawHub 的 Skill 均依 MIT-0 授權。
• 任何人皆可使用、修改及重新散布已發布的 Skill，包括商業用途。
• 不要求標示出處。
• 請勿在 SKILL.md 中新增衝突的授權條款；ClawHub 不支援針對個別 Skill 覆寫授權條款。

​

付費 Skill

• ClawHub 不支援付費 Skill、個別 Skill 定價、付費牆或收益分潤。
• 請勿將定價中繼資料新增至 SKILL.md；該資料不屬於 Skill 格式，且不會使已發布的 Skill 成為付費項目。
• 如果 Skill 整合付費第三方服務，請在 Skill 指示與環境變數宣告中清楚記載外部費用和必要帳號（必要變數使用 requires.env，選用變數則使用 envVars 搭配 required: false）。