workbuddy 支持四种技能导入方式：一、确认技能包为 .skill.json 格式且符合 mcp 规范；二、拖拽至主窗口中央导入单个技能；三、通过设置→技能管理→导入本地技能批量导入并查看日志；四、高级用户可用 workbuddy-cli 命令行工具静默导入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已拥有 OpenClaw 或其他兼容格式的技能包（Skills），希望在 WorkBuddy 中复用已有能力，则需通过本地导入方式加载技能文件。以下是完成技能导入的具体操作步骤：
一、确认技能包格式与存放路径
WorkBuddy 仅支持标准 JSON 格式的技能定义文件，文件名须以 .skill.json 结尾，且内容结构需符合 MCP 协议规范。导入前请将技能包文件统一存放于本地易访问目录（如桌面或文档文件夹），避免路径含中文、空格或特殊符号。
1、检查技能文件扩展名是否为 .skill.json；
2、用文本编辑器打开该文件，确认根对象包含 "name"、"description"、"triggers" 和 "steps" 四个必填字段；
3、确保文件未被其他程序占用或设置为只读属性。
二、通过主界面拖拽方式导入
此方法适用于单个或少量技能包导入，操作最直观，无需进入设置菜单。WorkBuddy 主窗口支持原生拖放识别，可自动解析并校验技能结构。
1、打开 WorkBuddy 桌面客户端，确保已登录并进入主界面；
2、将准备好的 .skill.json 文件直接拖入 WorkBuddy 主窗口中央空白区域；
3、松开鼠标后，界面弹出绿色提示条显示 “技能校验通过，正在注册…”；
4、约2秒后提示变为 “导入成功：[技能名称] 已启用”，该技能即刻出现在侧边栏“技能库”中。
三、通过设置面板手动选择导入
当需批量导入多个技能或需查看详细导入日志时，应使用设置面板路径。该方式支持一次选择多个文件，并对失败项给出具体错误原因。
OpenClaw配置管理最佳实践与常见陷阱。适用场景：(1) 修改配置，(2) 询问路径或结构，(3) 遇到配置错误，(4) 添加渠道，(5) 修改前避免路径错误或直接编辑JSON等常见错误。
1、点击右上角个人头像，选择 “设置”；
2、在左侧菜单中点击 “技能管理”；
3、在右侧区域点击 “+ 导入本地技能” 按钮；
4、在系统文件选择窗口中，按住 Ctrl（Windows）或 Command（macOS）键多选多个 .skill.json 文件，点击“打开”；
5、WorkBuddy 逐个校验并显示每项结果，成功项标记为 ✅ 已激活，失败项显示红色错误码（如 ERR_SCHEMA_MISMATCH）及说明。
四、通过命令行工具导入（高级用户）
适用于自动化部署场景或集成 CI/CD 流程。该方式绕过图形界面，直接调用内置 CLI 模块，支持静默模式与路径通配符。
1、打开终端（Windows 使用 PowerShell，macOS 使用 Terminal）；
2、执行命令：workbuddy-cli skill import --path "/Users/xxx/Skills/*.skill.json"；
3、若当前环境未识别 workbuddy-cli，请先运行 workbuddy --install-cli 安装命令行工具；
4、命令执行完成后，终端输出汇总报告，包括导入总数、成功数、跳过数及首个失败项详情。
