/ 目錄 / 演練場 / 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

安裝

作者儲存庫 · Claude Skills 官方文件

使用場景

實戰用法: openskills

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

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

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

步驟
  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. 以提示詞呼叫
    傳入一個範例任務,觀察實際會載入哪些內容。✓ 已複製
    → 揭露追蹤記錄:顯示 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