GitShelf — GitHub 项目目录

项目概述

Garden Skills 是 ConardLi 维护的一个开源 Agent Skills 集合，旨在为 Claude Code、Cursor、Codex 等 AI 编程代理提供生产就绪的技能包。仓库包含 5 个技能：web-video-presentation（网页视频/演示）、web-design-engineer（网页设计/前端）、gpt-image-2（图像生成/提示词）、kb-retriever（本地知识库检索）和 beautiful-article（精美文章编辑）。每个技能遵循 SKILL.md 规范，可独立安装和版本化。

核心功能

web-video-presentation：将脚本、文章、课程等转换为可录屏的 16:9 网页演示，支持 23 种内置主题、可插拔 TTS 语音合成。
web-design-engineer：将 AI 生成的网页产物打磨为专业前端作品，提供 25 种风格配方（如 Linear、Aesop、Bloomberg 等），涵盖响应式布局、动效和交互。
gpt-image-2：面向 GPT Image 2 和 OpenAI 兼容图像 API 的图像生成技能，支持本地生成、宿主原生工具委托和纯提示词顾问三种模式，提供 18 个视觉类别和 79 个提示词模板。
kb-retriever：本地知识库检索器，通过分层索引和渐进式搜索，从 Markdown、PDF、Excel 等文件中提取证据，避免上下文过载。
beautiful-article：将 URL、PDF、DOCX、Markdown 等任意来源转换为精美文章，支持 10 种文章类型和 11 种主题配置，强调编辑控制和排版质量。

适用与不适用场景

适用场景：

需要为 AI 编程代理（Claude Code、Cursor、Codex 等）添加可复用技能包的开发者。
需要快速生成高质量网页演示、前端设计、图像、知识库问答或精美文章的创作者。
希望以标准化方式（SKILL.md）管理和分发技能的组织。

不适用场景：

需要完整、独立的应用程序（而非技能包）的场景。
对图像生成质量要求极高且需要专用 GPU 训练的场景（本仓库仅提供提示词和流程）。
需要实时协作编辑或复杂权限管理的知识库系统（kb-retriever 仅面向本地目录）。

技术架构与依赖

技能格式：遵循 Agent Skills 规范（SKILL.md + manifest.json），每个技能独立版本化（SemVer）。
前端技术：web-video-presentation 和 web-design-engineer 基于 Vite + React + TypeScript。
图像生成：gpt-image-2 支持 OpenAI 兼容 API，可本地运行或委托宿主工具。
知识检索：kb-retriever 使用 grep、pdftotext、pdfplumber、pandas 等工具。
文章编辑：beautiful-article 基于 Reacticle 组件库（ConardLi/reacticle）。
安装工具：支持 npx skills CLI、Claude Code 插件市场、GitHub Releases 压缩包、手动复制和 Git 子模块。
开发工具：Node.js >= 20，零运行时依赖，纯 ESM 脚本。

安装与快速开始

方式一：npx skills CLI（推荐）

# 安装所有技能
npx skills add ConardLi/garden-skills

# 安装单个技能
npx skills add ConardLi/garden-skills -s web-design-engineer

# 全局安装
npx skills add ConardLi/garden-skills -s gpt-image-2 --global

方式二：Claude Code 插件市场

/plugin marketplace add ConardLi/garden-skills
/plugin install web-design-skills@garden-skills

方式三：从 Releases 下载压缩包

curl -fsSL -o web-design-engineer.zip "https://github.com/ConardLi/garden-skills/releases/download/web-design-engineer-v1.3.0/web-design-engineer-1.3.0.zip"
unzip -q web-design-engineer.zip -d .claude/skills/

方式四：手动复制

git clone https://github.com/ConardLi/garden-skills.git
cp -r garden-skills/skills/web-design-engineer your-project/.claude/skills/

方式五：Git 子模块

git submodule add https://github.com/ConardLi/garden-skills.git vendor/garden-skills
ln -s ../../vendor/garden-skills/skills/web-design-engineer .claude/skills/web-design-engineer

典型使用方法

使用 web-design-engineer 设计落地页：在 Claude Code 中描述需求，技能会自动引导设计流程，包括设计评审、风格选择、原型构建和验收测试。

使用 gpt-image-2 生成海报：选择模式（本地/委托/顾问），从 79 个模板中选择，生成提示词并调用图像 API。

使用 kb-retriever 检索知识库：将文档放入 knowledge/ 目录，技能会通过分层索引和渐进搜索回答问题，并附上来源。

使用 beautiful-article 编辑文章：提供 URL 或文档，技能会规划文章类型、主题、布局，并通过检查点确认后生成 HTML 或 PDF。

配置与部署要点

技能目录：根据代理类型放置到对应目录（.claude/skills/、.agents/skills/、.codex/skills/ 等）。
版本固定：生产环境建议使用 Releases 中的不可变压缩包，并校验 SHA-256。
环境变量：gpt-image-2 需要配置 OpenAI API 密钥；TTS 需要配置对应服务商凭证。
依赖工具：kb-retriever 需要 pdftotext、pdfplumber、pandas 等；web-video-presentation 需要 Node.js 和 npm。
CI/CD：仓库提供 validate-skills.yml 和 release-skill.yml 工作流，用于验证和发布技能。

限制、风险与许可证

限制：技能依赖外部 API（如 OpenAI、TTS 服务），可能产生费用；图像生成质量受模型限制；知识检索仅支持本地文件。
风险：技能可能包含不安全的提示词或脚本，使用前需审查；依赖第三方库可能存在供应链风险。
许可证：MIT License，版权归 ConardLi 所有。

官方链接

GitHub 仓库：https://github.com/ConardLi/garden-skills
技能规范：https://agentskills.io
Anthropic 参考仓库：https://github.com/anthropics/skills
作者个人网站：https://mmh1.top

信息来源和分析时间

信息来源：GitHub 仓库 README、CONTRIBUTING.md、manifest.json 及最新 Release 信息。
分析时间：2026-07-12（基于最新 Release 日期）。

项目概览