应将技能包文件改为标准JSON格式，因WorkBuddy仅支持扩展名为.skill.json且内容为合法JSON结构的文件，不解析YAML语法；需检查扩展名与内容一致性，确认首行为{"name":等JSON起始符号，删除YAML特有语法如缩进列表、冒号后空格等。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试导入 WorkBuddy 技能包，但系统提示“格式错误”，则很可能是技能配置文件未采用 WorkBuddy 所要求的 JSON 格式，而误用了 YAML 语法。WorkBuddy 仅接受标准 JSON 结构的 .skill.json 文件，不支持原生 YAML 解析。以下是解决此问题的步骤：
一、确认文件实际格式与扩展名一致性
WorkBuddy 依赖文件扩展名判断解析器类型，若扩展名为 .skill.json，但内容为 YAML 语法（如使用缩进、冒号后空格、短横线列表等），将导致解析失败并报格式错误。必须确保内容结构与扩展名严格匹配。
1、右键点击该文件，选择“属性”或“显示简介”，核对“类型”或“扩展名”是否确为 .skill.json；
2、用记事本或 VS Code 打开文件，观察首行是否为 {"name": 等 JSON 对象起始符号，而非 name: 或 - trigger: 等 YAML 特征语法；
3、若内容含 YAML 元素（如无引号的字符串、锚点&、合并
二、将 YAML 内容转换为合法 JSON 格式
YAML 与 JSON 存在语法映射关系，但不可直接重命名扩展名。需通过标准化工具或手动校验完成语义等价转换，确保所有字段符合 MCP 协议的 JSON Schema 要求。
1、访问在线转换工具 yaml2json.io 或使用本地命令行：安装 yq 工具后执行 yq e -o=json .\skill.yaml > skill.json；
2、转换后打开新生成的 .json 文件，检查是否所有字符串值均被双引号包裹，布尔值为 true/false（非 yes/no），null 值为 null（非 ~）；
3、验证根对象是否包含且仅包含四个必需字段："name"、"description"、"triggers"、"steps"，且均为有效 JSON 数据类型。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
三、使用 JSON Schema 校验器验证结构合规性
即使语法合法，若字段缺失、嵌套错误或类型错配（如 triggers 为字符串而非数组），仍会触发格式错误。WorkBuddy 在导入前执行严格 Schema 校验，需确保结构完全符合 MCP 协议定义。
1、前往官方 Schema 仓库 https://github.com/Tencent/workbuddy-mcp/blob/main/schema/skill.schema.json ，下载最新版 skill.schema.json；
2、使用 VS Code 安装插件 “JSON Schema Validator”，在文件顶部添加注释 // @schema ./skill.schema.json；
3、保存文件，编辑器将实时标出所有违反 Schema 的位置（如 steps 数组内缺少 required 字段、trigger 类型非 object 等），按提示逐一修正。
四、通过 CLI 工具执行静默校验并获取精准错误定位
图形界面仅提示“格式错误”，无法指出具体哪一行或哪个字段异常。命令行工具可输出结构化错误信息，包括错误码、路径与建议修复方式，大幅提升排查效率。
1、打开终端，执行 workbuddy skill validate ./my.skill.json；
2、若返回 ERR_JSON_PARSE，说明存在非法字符或括号不匹配，重点检查末尾逗号、Unicode BOM 头、控制字符；
3、若返回 ERR_SCHEMA_REQUIRED，说明 name 或 steps 字段缺失或为空，需补全对应 JSON 键值对；
4、若返回 ERR_SCHEMA_TYPE，例如提示 "triggers must be array, got string"，则需将 triggers: "on_message" 改为 "triggers": [{"type": "on_message"}]。
