Garden Skills安装前准备：Node 20环境与目录权限检查清单-平芜编程栈

Garden Skills安装前准备：Node 20环境与目录权限检查清单

【免费下载链接】garden-skillsConardLi's 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-skills

clone 出来的目录不需要写权限；但如果你的方案是"clone 后手动拷贝"，则目标机对 clone 目录可读、对拷贝目标目录可写即可。

2️⃣ Skill 安装目标目录（必须可写）

按你使用的 Agent 不同，目标目录不同（参考 README.zh-CN.md 的兼容性表）：

Agent / Runtime	Skill 安装路径	需要写权限？
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 ·`skills`CLI	`npx skills add ConardLi/garden-skills`	`.skills`或`~/.skills`目录
B · Claude Code 插件市场	`/plugin install web-design-skills@garden-skills`	Claude 插件目录
C · Releases 钉版本 .zip	下载 .zip 后解压	解压目标目录（建议先`shasum -a 256`校验）
D · clone 后手动拷贝	`cp -r garden-skills/skills/xxx 你的项目/.claude/skills/`	项目 skills 目录
E · Git Submodule	`git submodule add <仓库地址> vendor/garden-skills`	项目根目录 +`.git`