核心问题: 这五个 SKILL.md 模块在你自己的提示词上是否足够稳定,值得固定版本后按合集采用?
RepoDaily 采用评分
RepoDaily 将该项目的采用分评为 90/100（强）：分数来自文章来源、安装路径、生产风险、差异化、许可证清晰度以及 AI/Agent 适配度。
包含 5 个来源、覆盖 4 类来源；如有 RepoDaily 独有模块，会进一步提高证据分。
检测到 5 个工作流步骤、5 个下一步动作，以及 3 个命令/安装信号。
趋势热度为 +413 stars；如内容中有 release、issue 或维护信号，会提高维护可信度。
采纳风险标记为 medium，并包含 5 条安全说明与 3 条跳过条件。
3 个机会视角、4 个替代方案，以及 5 个类型化模块支撑差异化判断。
文章中包含许可证来源或许可证表述。
文章正文和元数据中检测到 6 个 AI/Agent 相关信号。
项目概览
Garden Skills 是 ConardLi 维护的生产级 Agent Skills 合集,面向 Claude Code、Cursor、Codex 及其他兼容 SKILL.md 规范的编码智能体。它在 2026-08-28 的趋势窗口拿到 413 星、排名第 12,靠的是一件朴素的事:把可复用的智能体行为打包成带版本、带校验和的模块,而不是散落在聊天记录里的提示词片段。仓库提供五个技能 —— web-video-presentation、web-design-engineer、gpt-image-2、beautiful-article、kb-retriever,各自独立放在 skills/ 目录下,每个文件夹都有必需的 SKILL.md 规范和 manifest.json。
这类提示词工程的仓库少见的纪律性体现在工程细节上。CONTRIBUTING.md 记录了一个 monorepo:每个技能保持同样的最小结构 —— SKILL.md(面向智能体的契约)、manifest.json(name/version/category/compat)、三语 README,以及可选的 references/、scripts/、templates/、themes/ 目录。根 package.json 刻意保持无聊:@conardli/garden-skills,版本 0.0.0,private,零运行时依赖,engines.node >= 20。npm install 是空操作,发布工具链是零依赖的纯 ESM Node。
你实际安装的对象是单个技能。发布按技能 tag 驱动:cut-release.mjs 打出带版本的 .zip 和 .sha256 校验和,update-readme.mjs 重写 README 里的下载链接,validate-skills.yml 在每个 PR 上跑与 CI 相同的检查。安装途径包括 npx 的 skills CLI、Claude Code 插件市场(由 .claude-plugin/marketplace.json 支撑)、Releases 里固定版本的 .zip、手动拷贝、git submodule。
旗舰技能 web-video-presentation 能说明野心:它构建可录屏的 Vite + React + TypeScript 演示,固定 1920×1080 舞台并缩放到视口,用点击/键盘驱动的 (chapter, step) 游标推进场景、每个视觉步骤对应一条旁白节拍,在脚本、主题、大纲、实现模式、可选合成旁白音频等硬性协作检查点暂停,内置 23 套主题。这是可交付的产物,不是演示级提示词。
为什么现在变热
- 2026-08-28 趋势窗口 413 星,排名第 12。
- 踩中 SKILL.md 规范(agentskills.io)的普及 —— Claude Code、Cursor、Codex 都按 description 加载技能,写得好的合集价值会复利。
- 一个仓库五个技能:网页设计、视频演示、图像生成、文章排版、知识检索。
- MIT 协议加零运行时依赖:npm install 是空操作,审计面缩小到可读的 markdown 和脚本。
- 三语文档(英文、zh-CN、ja-JP),合集索引和贡献指南都齐。
解决什么问题
- 写好一份 SKILL.md —— 让 frontmatter 的 name/description 在恰当时机触发,再配上智能体按需加载的 references —— 很繁琐,多数开发者每次都从零重写。
- 以 gist 或聊天粘贴形式分享的提示词模块没有版本、没有校验和、没有兼容性声明;garden-skills 的 manifest.json 为每个技能记录 name/version/category/compat。
- 让下载链接始终指向最新 zip 在别处是手工活;这里 update-readme.mjs 和 readme:check 在 CI 下保持 README 链接与 manifest 同步。
- 技能合集需要按技能发布而不是整仓库打 tag;release-skill.yml 按技能 tag 驱动发布。
工作原理
- 从 skills/ 挑一个技能 —— 每个文件夹(如 skills/web-video-presentation/)包含必需的 SKILL.md 与 manifest.json,以及可选的 references/、scripts/、templates/、themes/。
- 智能体读取 SKILL.md frontmatter(name、description)判断何时适用,再按需加载文件夹里的 references。
- 按需安装:npx 的 skills CLI、Claude Code 插件市场、Releases 固定版本 .zip、手动拷贝进项目、git submodule。
- 维护者在 skills/<name>/manifest.json 中为每个技能记版本;npm run release 打出 .zip + .sha256 并重写 README 下载链接。
- 每个 PR 都要通过 validate-skills.yml 跑 npm run validate(list + pack:all + readme:check)。
产品演示与界面预览
仓库解剖:五个技能,一份契约
每个技能都遵循 CONTRIBUTING.md 记录的同一最小结构:SKILL.md(YAML frontmatter 写 name 和 description,正文是给智能体的指令)、manifest.json(name/version/category/description/compat)、README.md 加 zh-CN、ja-JP 两个语言变体,以及可选的 references/、scripts/、assets 目录。这种统一性很关键,因为智能体依赖 frontmatter 契约 —— description 正是智能体判断要不要加载该技能的依据。
技能外围是维护基础设施:scripts/release/ 里有 cut-release.mjs(交互式发布入口)、pack-skill.mjs(技能打包为带版本的 .zip + .sha256)、update-readme.mjs(重写 Download 链接)、list-skills.mjs(检查 manifest)。两个 GitHub workflow 守门 —— release-skill.yml 按技能 tag 发布、validate-skills.yml 做 PR 护栏 —— .claude-plugin/marketplace.json 则把合集注册进 Claude Code 插件市场。demo/ 放可打开的演示,website/ 放独立展示站。
命令面:你实际要跑的东西
- 要求 Node >= 20 —— CONTRIBUTING.md 的 quick start 写明,package.json 的 engines 字段也做了约束。
- npm install 是空操作:仓库没有运行时依赖,发布工具链是零依赖纯 ESM Node。
- npm run list —— 列出全部技能及 manifest 状态。
- npm run validate —— 执行 npm run list && npm run pack:all && npm run readme:check,与 CI 在每个 PR 上跑的检查一致。
- npm run release 与 npm run release:dry —— cut-release.mjs,带 dry-run 参数可先彩排。
- npm run pack / pack:all 与 readme:sync / readme:check —— 按技能打包 zip、同步 README 链接。
- 根包 @conardli/garden-skills 刻意保持 private 且版本 0.0.0;各技能版本写在 skills/<name>/manifest.json 里。
上手路径:五条安装路线,一个下午
- 方式 A:npx 的 skills CLI —— 往智能体项目里加技能的最快路径。
- 方式 B:Claude Code 插件市场,由 .claude-plugin/marketplace.json 支撑。
- 方式 C:GitHub Releases 固定版本 .zip,附带 .sha256 校验和可验证。
- 方式 D:把技能文件夹手动拷进项目。
- 方式 E:git submodule,适合想整仓库跟踪的场景。
- 克隆后的验证步骤:node --version(>= 20)、npm run list、npm run validate。
维护风险读数:哪些地方会先坏
- 单人维护项目(ConardLi)同时产出英、中、日三语文档 —— bus factor 是一。
- 根版本 0.0.0 且 private: true,意味着没有稳定的根产物可依赖;需要到 skills/<name>/manifest.json 里逐技能固定版本。
- 对冲因素:按技能 tag 驱动的发布带 .sha256 校验和、CI 会在 npm run validate 失败时挡下 PR、CONTRIBUTING.md 写明了手动发布兜底方案。
- 技能质量受宿主模型指令遵循能力约束;gpt-image-2 还依赖外部图像生成服务,输出漂移不在这个仓库的控制范围内。
集成面:它插在哪里
- 面向 Agent Skills 规范(SKILL.md)—— README 同时链接了 Claude 官方 Skills 说明文章和 agentskills.io。
- 点名的兼容智能体:Claude Code、Cursor、Codex 及其他兼容 SKILL.md 的智能体;manifest.json 为每个技能带 compat 字段。
- web-video-presentation 产出 Vite + React + TypeScript 项目 —— 固定 1920×1080 舞台、(chapter, step) 游标每步一条旁白节拍、悬停才显示的进度控件、主题令牌架构下内置 23 套主题。
- 安装集成点:npx CLI、Claude Code 插件市场 manifest、带校验和的 Release zip、git submodule。
谁适合关注
适合关注
- 在 Claude Code、Cursor、Codex 上做前端的开发者,想要现成的 web-design-engineer 而不是每个项目重写设计提示词。
- 要把文章变成可录制演示的讲者和教育者 —— web-video-presentation 的脚本/大纲检查点加 23 套主题正是为此设计。
- 跑之前必须逐行读完代码的人:零运行时依赖、markdown 优先的技能,让完整审计只需要一个下午。
- 想找参考 monorepo 的技能作者 —— 结构、校验、按技能发布的机制都可以照搬。
可以先跳过
- 智能体不加载 SKILL.md 文件的团队 —— 这里的一切都用不上。
- 需要供应商支持或 SLA 的场景;这是社区的 MIT 项目。
- 期望有稳定根 npm 包的人 —— 根包 private 且 0.0.0,消费单位是单个技能的 zip 或文件夹拷贝。
风险与注意事项
MIT、零依赖、CI 守门、发布带校验和 —— 但单一维护者、根包 0.0.0,实际效果依赖宿主模型行为。
- bus factor 为一:ConardLi 一个人维护技能和三语文档。
- 没有可固定的根产物;稳定性分散在每个技能的 manifest.json 里,需要逐个阅读。
- 技能输出随宿主模型波动,gpt-image-2 还依赖外部图像服务 —— 仓库无法保证结果。
- 缓解因素:MIT 允许自有 fork;.sha256 校验和与 validate-skills.yml 让固定版本可复现。
- MIT 协议(版权 2026)允许商业使用、修改和再分发,保留声明即可。
- 供应链面极小:零运行时依赖,npm install 是空操作,发布工具链是零依赖纯 ESM Node。
- SKILL.md 技能会指示智能体执行动作;可选的 scripts/ 目录可能包含可执行辅助脚本,放开大范围文件权限前先审查。
- Releases 的固定 .zip 附带 .sha256 校验和,安装前可验证。
- validate-skills.yml 在每个 PR 上跑结构检查,降低 manifest 畸形的风险。
替代方案比较
| 方案 | 适用场景 | 代价 |
|---|---|---|
anthropics/skills | 想先用 Anthropic 官方示例技能做基线,再考虑第三方合集。 | 免费,开源 |
| 想要更大型、社区驱动的 Claude Code 技能合集。 | 免费,开源 | |
awesome-claude-code | 想要覆盖 Claude Code 命令、技能、工具的链接清单,而不是可直接安装的合集。 | 免费,开源 |
在自己仓库里手写 SKILL.md | 提示词涉密,或需要严格评审后才能离开公司。 | 仅工程时间 |
这个趋势说明了什么
把技能 fork 成自家设计规范
web-design-engineer 以可读的 SKILL.md 加 references 交付;fork 之后把你们自己的设计令牌和评审规则写进去,比从空白提示词起步快得多。
把 skills/web-design-engineer/ 拷进仓库,改 SKILL.md frontmatter 与 manifest.json,跑 npm run list 确认 manifest 被识别。
复用发布工具链管理你自己的技能 monorepo
cut-release.mjs、pack-skill.mjs、update-readme.mjs 是零依赖纯 ESM Node 脚本,可以为任何 SKILL.md 合集管理按技能的 zip 与校验和。
对一个技能跑 npm run pack,检查带版本的 .zip 与 .sha256 输出,再把同样的命令接入你的 CI。
没有视频团队的录屏产线
web-video-presentation 在 1920×1080 舞台构建 Vite + React + TypeScript 演示,带检查点暂停与 23 套主题;用录屏点击驱动场景代替渲染视频。
喂一篇短文,通过脚本与大纲检查点,录制点击驱动的场景,和现有幻灯工具对比投入产出。
RepoDaily 判断
Garden Skills 是一个克制的小赌注:五个 MIT 协议的 SKILL.md 模块、按技能版本化并附校验和的 zip、零依赖且一个下午能读完的工具链。先采用单个技能、固定它的 manifest 版本,并在单一维护者沉寂时准备好 fork。