/ 目錄 / 演練場 / openskills
● 社群 Geeksfino ⚡ 即開即用

openskills

作者 Geeksfino · Geeksfino/openskills

使用 TypeScript/Python 綁定的 Rust 執行環境,專為 Agent Skills 設計——漸進式揭露、沙箱隔離,且不限於 Claude 使用。

openskills 是基礎設施,而非單一技能:一個以 Rust 實作的執行環境,能載入 SKILL.md 套件(依序載入元資料、主體、腳本/資源),並透過 TS 或 Python 綁定向任何 Agent 公開介面。它加入了沙箱機制(macOS 上使用 Seatbelt,另有實驗性 WASM 支援),防止技能腳本悄悄逃逸執行環境。若你正在開發自己的 Agent,或希望技能具備跨 Agent 的可移植性,這個工具正是你需要的。

為什麼要用

核心特性

即時演示

實際使用效果

openskills-skill.replay ▶ 就緒
0/0

安裝

選擇你的客戶端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

點擊 Cline 側欄中的 MCP Servers 圖示,然後選 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "openskills-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ],
      "_inferred": true
    }
  }
}

格式與 Claude Desktop 相同。重啟 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "openskills-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/Geeksfino/openskills",
        "~/.claude/skills/openskills"
      ]
    }
  ]
}

Continue 使用伺服器物件陣列,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "openskills-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/Geeksfino/openskills",
          "~/.claude/skills/openskills"
        ]
      }
    }
  }
}

加入 context_servers。Zed 儲存後熱重載。

claude mcp add openskills-skill -- git clone https://github.com/Geeksfino/openskills ~/.claude/skills/openskills

一行命令搞定。用 claude mcp list 驗證,claude mcp remove 移除。

使用場景

實戰用法: openskills

如何將 Agent Skills 嵌入你自己的 Agent 執行環境

👤 正在開發自訂 LLM Agent 的工程師 ⏱ ~120 min advanced

何時使用: 你正在從零開始撰寫一個 Agent,並希望使用一套已能理解 SKILL.md 格式的技能系統。

前置條件
  • Rust 工具鏈(用於編譯)或預先建置的綁定 — rustup install stable;或直接使用 TS/Python 綁定
  • 已複製儲存庫 — git clone https://github.com/Geeksfino/openskills ~/.claude/skills/openskills
步驟
  1. 安裝綁定
    安裝 openskills 的 Python 或 TS 綁定,並指向我的技能目錄。✓ 已複製
    → 執行環境已載入;技能已列舉完畢
  2. 與 Agent 整合
    將執行環境接入我的 Agent 規劃器,使其在每個步驟中都能考量技能。✓ 已複製
    → Agent 具備 SkillRegistry 抽象層
  3. 啟用沙箱執行
    在 macOS 上為技能腳本啟用 Seatbelt 沙箱。✓ 已複製
    → 技能腳本在沙箱設定檔下執行

結果: 你的自訂 Agent 能像 Claude Code 一樣載入並執行 SKILL.md 套件。

注意事項
  • 啟動時載入所有腳本會耗盡記憶體 — 依賴漸進式揭露機制——優先載入元資料
  • 沙箱封鎖了合法的操作 — 審查沙箱設定檔;採用「先收緊再放寬」的策略,而非一律全部拒絕
搭配使用: filesystem

在 Claude Code 之外獨立測試技能

👤 希望進行跨 Agent 驗證的技能作者 ⏱ ~45 min intermediate

何時使用: 你想在不依賴 Claude Code 特定執行環境的情況下,驗證技能的正確性。

步驟
  1. 載入技能
    使用 openskills 載入 ~/.claude/skills/my-skill/ 並印出其元資料。✓ 已複製
    → 已解析的前置資料(frontmatter)與主體內容
  2. 以提示詞呼叫
    傳入一個範例任務,觀察實際會載入哪些內容。✓ 已複製
    → 揭露追蹤記錄:顯示 Agent 將會看到的內容

結果: 確信你的技能具備可移植性。

注意事項
  • 技能依賴 Claude Code 的內部實作 — 重構技能,使其僅依賴公開的 SKILL.md 介面

組合

與其他 MCP 搭配,撬動十倍槓桿

openskills-skill + skill-optimizer-skill

在最佳化技能前先進行可移植性驗證

使用 openskills 載入技能,再交由 skill-optimizer 提供修補建議。✓ 已複製
openskills-skill + filesystem

直接對技能目錄進行操作

列出 ~/.claude/skills/ 中所有 SKILL.md,並逐一摘要說明。✓ 已複製

工具

此 MCP 暴露的能力

工具輸入參數何時呼叫成本
skill-loader skills dir Agent 啟動時 minimal
progressive-disclosure skill id + stage Agent 推理過程中 minimal
sandbox-runner script + policy 技能啟動子行程時 script runtime

成本與限制

運行它的成本

API 配額
none
每次呼叫 Token 數
執行環境對提示詞的消耗極少;你可自行控制揭露的內容
費用
免費、開放原始碼
提示
保持漸進式揭露開啟——啟動時載入所有腳本會大量消耗上下文額度

安全

權限、密鑰、影響範圍

憑證儲存: 執行環境層級不儲存任何憑證
資料出站: 除腳本本身的行為外,不對外傳送任何資料

故障排查

常見錯誤與修復

Binding import fails

確認原生二進位檔與你的平台相符;若不符,請從原始碼重新編譯。

Sandbox blocks expected syscalls

逐步調整 Seatbelt 設定檔;記錄被拒絕的操作,以找出正確的允許清單。

替代方案

openskills 對比其他方案

替代方案何時用它替代權衡
Claude Code native skill loader你只在 Claude Code 內部執行無法跨 Agent 移植

更多

資源

📖 閱讀 GitHub 上的官方 README

🐙 查看未解決的 issue

🔍 瀏覽全部 400+ MCP 伺服器和 Skills