ConardLi/garden-skills 怎么安装？Claude Code/Codex 创作技能包教程

很多人最容易踩的坑不是命令敲错，而是误以为 garden-skills 是个必须整体运行的程序。其实它就是 5 个可独立安装的 Skill 文件夹：你可以一次性装完整仓库，也可以只挑 web-design-engineer 或者 beautiful-article 单独装。官方来源只认 ConardLi/garden-skills、仓库内的 README 和对应 Release，千万别从二次打包的第三方站点下载。

安装前要准备什么？

1. 先确认你的终端能正常使用 Git；要是走 npx 安装方案的话，还得确保 Node.js、npm 和 npx 都能用。
2. 确认你用的目标 Agent：Claude Code 通常扫描 .claude/skills/<name>/，Codex CLI 扫描 .codex/skills/<name>/。
3. 先想好是装整个仓库还是单个 Skill。只做网页设计的话，完全没必要同时带上知识库和图像模板。
4. 公司 CI、Docker 或内网环境需要可复现安装时，别跟着 main 分支走，改用带版本的 Release 压缩包并校验 SHA-256。

一行命令怎么装到 Claude Code 或 Codex？

跨 Agent 最省心的通用入口是社区出的 skills CLI。安装完整仓库的命令是：

npx skills add ConardLi/garden-skills

只安装网页设计 Skill 的话，用这条：

npx skills add ConardLi/garden-skills -s web-design-engineer

只安装图像 Skill，并放到全局 ~/.skills 的话：

npx skills add ConardLi/garden-skills -s gpt-image-2 --global

Claude Code 插件市场怎么装？

用 Claude Code 的话，还可以先订阅仓库市场，再安装按用途拆分的插件包。网页演示、网页设计、知识库、图像生成和精美文章分别有独立包，很适合团队统一订阅。

/plugin marketplace add ConardLi/garden-skills

/plugin install web-design-skills@garden-skills

/plugin install beautiful-article-skills@garden-skills

Codex 想手动拷贝，目录放哪里？

要是需要改源码的话，可以走 HTTPS 克隆仓库，再把单个 Skill 拷到项目的 Codex 目录里。注意别只复制 SKILL.md 这一个文件，它引用的 references、scripts 和 assets 也要一起保留。

git clone https://github.com/ConardLi/garden-skills.git

cp -r garden-skills/skills/web-design-engineer your-project/.codex/skills/

安装后第一次怎么试？

先重启 Agent，或者让它重新扫描一遍工作区，然后给一个能明显触发对应 Skill 的小任务试试。测试 web-design-engineer 时，可以让它把现有 HTML 页面改成响应式产品页并先给出设计方向；测试 beautiful-article 时，可以提供一份 Markdown，要求整理成可离线打开的单文件文章。

判断安装成功的信号，不是终端只显示「完成」就完事了，而是 Agent 能识别对应 Skill 的边界，并按它的专属流程继续。例如网页设计任务会先理解产品上下文，文章任务会先梳理来源和规划，网页视频任务会生成口播稿与视觉大纲，而不是五种任务都回同一种模板。

遇到报错，先看哪三处？

终端提示 npx 找不到

现象：执行安装命令后出现 command not found。原因：本机没有 Node.js/npm，或终端 PATH 尚未刷新。修复：安装当前受支持的 Node.js 版本，重新打开终端，再确认 node、npm、npx 都能运行。

文件已经复制，Agent 仍不触发

现象：目录存在，但任务还是按普通方式回答。原因：Skill 放进了错误 Agent 的目录、只复制了单个文件，或工作区还没重新扫描。修复：核对上面的兼容路径，保证目标文件夹内有 SKILL.md 及其配套目录，再重启 Agent 会话。

Release 压缩包下载失败或校验不通过

现象：URL 返回 404，或 SHA-256 不匹配。原因：手写了不存在的版本号，或下载被代理缓存替换。修复：从每个 Skill 的官方 README 链接进入对应 Release，下载同版本的 zip 和 sha256 文件，校验通过后再解压。

团队里怎样装才不乱？

要是售前方案、客户交付网页和内部培训材料都依赖同一套 Skill，研发负责人最好把版本固定在 Release tag 或 Git Submodule SHA，仓库里记录好安装位置和最小试跑任务。新人拉取项目后先做版本检查，再跑一条有可见产物的测试用例；CI 只接受校验通过的压缩包。这样更新规则时能随时回滚，也不会出现「同一句任务，五台电脑跑出五套流程」的情况。

安装完成检查：官方 owner/repo 正确；目标 Skill 文件夹完整；目录属于当前 Agent；会话已重新扫描；最小任务能触发对应流程；CI 场景已固定版本并校验哈希。只要这六项都对，garden-skills 才算真正装好。