## 项目概述

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（推荐）**

```bash
# 安装所有技能
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 插件市场**

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

**方式三：从 Releases 下载压缩包**

```bash
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/
```

**方式四：手动复制**

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

**方式五：Git 子模块**

```bash
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 日期）。