Garden Skills安装前准备：Node 20环境与目录权限检查清单
Garden Skills安装前准备Node 20环境与目录权限检查清单【免费下载链接】garden-skillsConardLis open-source Skills collection, featuring web design, knowledge retrieval, image generation, and more.项目地址: https://gitcode.com/GitHub_Trending/we/garden-skills 安装Garden Skills开源 Agent Skills 集合之前最容易卡住新手的不是安装命令本身而是两件事Node 20 环境没达标和目标目录权限不足。Garden Skills 是花园老师ConardLi维护的开源 Skills 集合包含网页设计、网页演示、知识检索、图像生成等技能面向 Claude Code、Cursor、Codex 等所有支持SKILL.md格式的 AI 编程代理。本文给你一份安装前准备清单先用 3 条命令确认 Node 版本再逐项核对目录读写权限避免装到一半报错。为什么必须先确认 Node 20 环境Garden Skills 的发布与校验工具链是纯 ESM Node 脚本、零运行时依赖——npm install在这里是空操作CI 也不装任何依赖。这意味着环境要求全部落在Node 本身上仓库 package.json 里明确声明engines: { node: 20 }Node 20 以下比如系统自带的 Node 18会直接跑不动scripts/release/下的工具脚本表现为脚本报错或 ESM 语法不识别。官方贡献文档 CONTRIBUTING.zh-CN.md 的快速开始一节把node --version必须 20列为第 2 步先于一切安装动作。 一句话原则先验环境再谈安装。30 秒的检查能省半小时的排错。Node 20 版本检查两条命令定位问题在终端执行下面两条命令即可node --version # 输出必须 v20如 v20.19.0 / v22.x / v24.x npm --version # 顺带确认 npm 可用一般 10.x判定标准很简单输出示例判定处理方式v20.19.0、v22.13.0、v24.x✅ 满足20直接进入权限检查v18.20.0、v16.x❌ 版本过低升级或切换 Node 版本command not found❌ 未安装先安装 Node 20 LTS常见升级方式任选其一使用 nvm 等版本管理器nvm install 20 nvm use 20使用公司/系统包管理器安装 Node 20 LTS 发行版多版本共存时确认当前 shell 默认指向的是 20而不仅是装过 20如果机器上同时存在 Node 18很多 CI 镜像默认是 18务必在新会话里再跑一次node --version复验——这是新手最高频的假通过场景。目录权限检查清单装到哪、能不能写Skill 本质是一个自包含文件夹核心是SKILL.md manifest.json安装就是把文件夹放进 Agent 扫描的目录。因此权限检查分三层1️⃣ 仓库来源目录只读即可无论走哪种安装方式Garden Skills 仓库本身只需要可读。如果通过 clone 获取git clone https://gitcode.com/GitHub_Trending/we/garden-skillsclone 出来的目录不需要写权限但如果你的方案是clone 后手动拷贝则目标机对 clone 目录可读、对拷贝目标目录可写即可。2️⃣ Skill 安装目标目录必须可写按你使用的 Agent 不同目标目录不同参考 README.zh-CN.md 的兼容性表Agent / RuntimeSkill 安装路径需要写权限Claude Code.claude/skills/name/✅Cursor / 通用 Agent.agents/skills/name/✅Codex CLI.codex/skills/name/✅OpenCode.opencode/skills/name/✅用一条命令验证当前用户对目标目录可写替换成你的实际路径# 项目级目录 touch .claude/skills/.write_test rm .claude/skills/.write_test echo 可写 ✅ # 或全局目录~/.skills touch ~/.skills/.write_test rm ~/.skills/.write_test echo 可写 ✅如果目录不存在先手动mkdir -p创建创建失败通常就是权限问题的直接信号例如目录属主是 root、或开启了只读挂载。3️⃣ 脚本执行权限用到 scripts 时才需要部分 Skill 携带可执行脚本例如 skills/gpt-image-2/scripts/ 和 skills/web-video-presentation/scripts/。如果你要直接./xxx.sh方式调用检查ls -l skills/web-video-presentation/scripts/scaffold.sh # 确认有 x 权限位没有则 chmod x skills/web-video-presentation/scripts/scaffold.sh安装前最终验证两条命令跑通才算就绪Node 版本和目标目录都 OK 之后在仓库根目录跑一遍官方同款检查与 PR CI 完全一致npm run list # 列出所有 Skill manifest 状态 npm run validate # 结构校验 打包演练不产生副作用两条都通过说明仓库文件完整、结构合法。相关命令定义见 package.json 的scripts字段实现位于 scripts/release/list-skills.mjs 与 scripts/release/pack-skill.mjs。五种安装方式对应的权限要求速查方式命令示例需要写权限的位置A ·skillsCLInpx skills add ConardLi/garden-skills.skills或~/.skills目录B · Claude Code 插件市场/plugin install web-design-skillsgarden-skillsClaude 插件目录C · Releases 钉版本 .zip下载 .zip 后解压解压目标目录建议先shasum -a 256校验D · clone 后手动拷贝cp -r garden-skills/skills/xxx 你的项目/.claude/skills/项目 skills 目录E · Git Submodulegit submodule add 仓库地址 vendor/garden-skills项目根目录 .git方式 C 适合 CI / 内网 / 需要字节级可复现的场景方式 A 是最快的一行命令方案。详细说明见 README.zh-CN.md 的安装章节。✅ 安装前准备总清单截图保存node --version输出 v20注意是当前 shell 生效的版本npm --version正常返回仓库来源目录可读clone 成功 / zip 已下载目标 Agent 目录如.claude/skills/可创建、可写入如需直接执行脚本scripts/下文件有x 权限位npm run list与npm run validate全部通过全部打勾后就可以放心执行安装命令了。祝你的 Agent 早日用上 Garden Skills 的设计、演示、检索与生图能力 【免费下载链接】garden-skillsConardLis open-source Skills collection, featuring web design, knowledge retrieval, image generation, and more.项目地址: https://gitcode.com/GitHub_Trending/we/garden-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考