QoderWake安装Skill前需要准备什么？

先来聊几个关键点：QoderWake安装Skill前，必须确保服务已启动、Skills目录结构合规、Node.js与npm版本达标，并且正确编写SKILL.md文件。否则，SKILL.md会被静默忽略，技能列表一片空白，/命令完全无法调用任何能力，而且系统不会给出任何错误提示。这可能是最让人头疼的地方——你根本不知道问题出在哪。

所以，在动手之前，先把环境检查一遍，别让后续的尝试都白费。

确认QoderWake服务已成功启动

打开终端，执行 qoderwake status。如果返回 active (running)，说明服务正在后台运行；如果显示 inactive 或报错 command not found，那就需要先完成QoderWake主程序安装和service install步骤。记住，这一步可千万别跳过——

。

检查Skills目录结构是否合规

QoderWake只认两种路径下的SKILL.md文件：

用户级技能：必须放在 ~/.qoder/skills/{skillName}/SKILL.md（macOS/Linux）或 %USERPROFILE%.qoderskills{skillName}SKILL.md（Windows）；

项目级技能：必须放在当前工作区根目录下的 .qoder/skills/{skillName}/SKILL.md，且该目录需在git仓库根路径内。

特别注意：

。比如 code-review 合法，但 code_review 或 My Skill 会被直接跳过。

验证Node.js与npm版本是否达标

执行 node -v，输出必须为 v18.19.0 或更高；执行 npm -v，输出必须 ≥ 9.0.0。低于此版本会导致YAML注册方式失败、依赖解析中断，甚至SKILL.md中 input_schema 字段校验不通过。版本不达标的话，去 https://nodejs.org 下载LTS版本重新安装——旧版本不兼容QoderWake 0.3.5+的契约解析引擎。

准备第一个Skill文件内容

新建一个文本文件，命名为 SKILL.md，内容至少包含以下四块：

：必须唯一，如 hello-world；
：一句话说明用途，如 返回固定欢迎语；
：即使无输入也需写成 {}；
：同样不能为空，可写 {"message": "string"}；
：至少提供一个调用示例，格式为 - input: {} → output: {"message": "Hello, Qoder!"}。

保存后，确保该文件位于前述任一合规路径中，且父目录名与 name 值完全一致。这样，第一个Skill才算真正准备好了。