在国内网络环境下为Qoder安装Skill需避开GitHub直连失败、权限路径错误、Node版本不兼容三大卡点；须确保node≥v18.19.0、npm≥9.0.0，支持自然语言一键、Marketplace图形化、npx命令行三种安装方式，并通过/命令列表或qodercli list-skills验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在国内网络环境下为Qoder安装Skill，需避开GitHub直连失败、权限路径错误、Node版本不兼容三大常见卡点，确保技能能被正确识别并触发执行。
确认基础环境是否就绪
打开终端，依次运行以下两条命令：
node -v → 查看输出是否为 【v18.19.0 或更高版本】；低于此版本将导致SKILL.md解析失败、Quest Mode无法启动。
npm -v → 输出值必须 ≥ 9.0.0；若不满足，执行 npm install -g npm@latest 升级即可，无需卸载重装。
这两项是硬性前提，缺一不可。Windows用户若用WSL2安装CLI，也必须在WSL内单独验证这两个版本，宿主机的Node不影响但也不起作用。
三种主流安装方式任选其一
方法一：自然语言一键安装（推荐新手）
在Qoder IDE智能会话框或Quest界面中，直接输入类似“帮我安装 Excel合并 Skill 到当前项目”或粘贴 skills.sh 上的仓库地址（如 https://github.com/qoder-skills/excel-merge），AI会自动完成检索→下载→解压→放置→加载全流程。
该方式自动判断作用域：含“当前项目”字眼则放入项目级目录 .qoder/skills/，否则默认走用户级 ~/.qoder/skills/。
方法二：Marketplace图形化安装（适合免命令行场景）
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
启动Qoder桌面端 → 左侧导航栏点击「Marketplace」→ 在搜索框输入关键词（如“支付宝支付集成”）→ 找到对应Skill卡片 → 点击 Install 按钮。
系统会自动校验环境兼容性、下载依赖、写入配置，完成后即可在对话中用自然语言调用，例如：“为电商站添加支付宝手机网站支付入口”。
方法三：npx 命令行安装（适合批量部署或CI流程）
在项目根目录下执行 npx skillsadd excel-merge（不加 -g）→ 技能将被安装至当前项目的 .qoder/skills/excel-merge/SKILL.md 目录。
若需全局生效，追加 -g 参数：npx skillsadd excel-merge -g → 安装路径变为 ~/.qoder/skills/excel-merge/SKILL.md。
注意：npx 安装时当前目录必须是项目根目录或用户主目录，否则路径错位会导致Qoder完全无法识别该Skill。
验证安装是否成功
① 在Qoder IDE智能会话框中输入 / ，查看弹出列表是否包含刚安装的Skill名称（如 /excel-merge）。
② 或直接运行 qodercli list-skills 命令，终端将列出所有已加载的Skill及其作用域（global/project）。
③ 若列表为空或名称缺失，检查 .qoder/skills/ 目录下是否存在对应子文件夹，且该文件夹内含有合法的 SKILL.md 文件——文件名大小写必须全小写，不能是 skill.md 或 SKILL.MD。
