Skill Loader

Universal skill adapter for OpenClaw - load Claude Code, Codex, and Gemini CLI skills seamlessly

打通 AI Agent 生态 - 让不同平台的 skills 无缝互通

---

🎯 问题

Claude Code、Codex、Gemini CLI 的 skills 格式不同，不能直接在 OpenClaw 里用：

✨ 解决方案

四步自动适配：检测 → 解析 → 映射 → 注入

• ✅ 零修改：不改原 skill 代码
• ✅ 自动化：用户无感知
• ✅ 可扩展：支持多种 skill 格式

---

🚀 快速开始

安装

# Clone 到你的 OpenClaw skills 目录
cd /path/to/openclaw/workspace/skills
git clone https://github.com/ythx-101/skill-loader.git

使用

# 扫描所有可用的 skills
python3 skill-loader/loader.py scan

# 加载指定 skill
python3 skill-loader/loader.py load /path/to/skill

# 查找触发词匹配的 skill
python3 skill-loader/loader.py find "画个架构图"

示例

# 1. 克隆一个 Claude Code skill
cd skills
git clone https://github.com/axtonliu/axton-obsidian-visual-skills.git obsidian-visual

# 2. 自动识别并加载
python3 skill-loader/loader.py load obsidian-visual

# 输出：
# [
#   {
#     "name": "excalidraw-diagram",
#     "description": "...",
#     "triggers": ["画图", "Excalidraw", ...],
#     "content": "...",
#     "source_type": "claude-marketplace"
#   },
#   ...
# ]

---

📦 支持的格式

---

🚀 使用方法

方式1: 克隆外部 skill

cd /root/clawd/skills
git clone https://github.com/user/some-claude-skill.git

OpenClaw 会自动识别并加载。

方式2: 手动触发加载

在对话中说：

"加载 excalidraw skill"
"画个架构图"（自动匹配 skill 触发词）

方式3: Python API

from skills.skill_loader import load_skill

skill = load_skill('/root/clawd/skills/obsidian-visual')
skill.execute('画个流程图')

---

🔧 工作原理

1. 自动检测

def detect_skill_type(skill_dir):
    if os.path.exists(f"{skill_dir}/.claude-plugin/marketplace.json"):
        return "claude-marketplace"
    elif os.path.exists(f"{skill_dir}/.claude-plugin/SKILL.md"):
        return "claude-single"
    elif os.path.exists(f"{skill_dir}/codex.json"):
        return "codex"
    elif os.path.exists(f"{skill_dir}/skill.yaml"):
        return "gemini-cli"
    return None

2. 解析 Skill

• 读取 SKILL.md 内容
• 提取 frontmatter（name / description / triggers）
• 提取指令部分（Workflow / Design Rules / Examples）

3. 工具映射