## 项目概述

Marketing Skills 是一个面向 AI 代理（如 Claude Code、OpenAI Codex、Cursor、Windsurf 等）的营销技能集合，旨在帮助技术营销人员和创始人利用 AI 编码代理完成转化率优化（CRO）、文案撰写、SEO、分析和增长工程等营销任务。该项目由 Corey Haines 构建，遵循 Agent Skills 规范，提供超过 50 个可复用的技能模块，覆盖从产品营销基础到具体执行策略的完整链路。

## 核心功能

- **技能库**：包含 50+ 个营销技能，如 `cro`（转化率优化）、`copywriting`（文案撰写）、`seo-audit`（SEO 审计）、`analytics`（分析）、`ads`（广告）、`emails`（邮件序列）、`pricing`（定价）等。
- **技能协同**：技能之间相互引用，`product-marketing` 技能作为基础，其他技能会先读取产品、受众和定位信息，确保执行一致性。
- **多代理支持**：兼容 Claude Code、OpenAI Codex、Cursor、Windsurf 等支持 Agent Skills 规范的代理。
- **安装方式多样**：提供 CLI 安装、Claude Code 插件、克隆复制、Git 子模块、Fork 定制、SkillKit 多代理安装等多种方式。
- **版本升级支持**：v2.0 起重命名了 17 个技能，并提供了详细的迁移指南和清理命令。

## 适用与不适用场景

**适用场景**：
- 技术营销人员或创始人希望利用 AI 代理辅助完成营销任务，如优化落地页、撰写文案、设置分析追踪、规划邮件序列等。
- 需要系统化营销知识库的团队，希望将最佳实践嵌入 AI 工作流。
- 使用支持 Agent Skills 规范的 AI 编码代理的用户。

**不适用场景**：
- 非技术背景且不熟悉终端或 AI 代理操作的用户（项目提供了配套指南，但核心使用仍需基础技术能力）。
- 需要完全自动化、无需人工干预的营销解决方案（技能仍需用户触发和审核）。
- 与 Agent Skills 规范不兼容的 AI 工具。

## 技术架构与依赖

- **语言**：JavaScript（仓库主要语言，但技能本身为 Markdown 文件）。
- **规范**：遵循 [Agent Skills 规范](https://agentskills.io)，技能以 Markdown 文件形式存在，包含 YAML frontmatter（`name`、`description` 等）。
- **依赖**：安装时依赖 `npx skills`（Vercel Labs）或 `npx skillkit`（SkillKit）等 CLI 工具；Claude Code 插件方式依赖其内置插件系统。
- **结构**：每个技能目录包含 `SKILL.md`（必需），可选 `references/`、`scripts/`、`assets/` 子目录。

## 安装与快速开始

### 方式一：CLI 安装（推荐）

```bash
# 安装所有技能
npx skills add coreyhaines31/marketingskills

# 安装特定技能
npx skills add coreyhaines31/marketingskills --skill cro copywriting

# 列出可用技能
npx skills add coreyhaines31/marketingskills --list
```

### 方式二：Claude Code 插件

```bash
/plugin marketplace add coreyhaines31/marketingskills
/plugin install marketing-skills
```

### 方式三：克隆并复制

```bash
git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/* .agents/skills/
```

### 方式四：Git 子模块

```bash
git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills
```

### 方式五：Fork 定制

1. Fork 本仓库
2. 按需定制技能
3. 将 Fork 克隆到项目中使用

### 方式六：SkillKit（多代理）

```bash
npx skillkit install coreyhaines31/marketingskills
npx skillkit install coreyhaines31/marketingskills --skill cro copywriting
npx skillkit install coreyhaines31/marketingskills --list
```

## 典型使用方法

安装后，直接向 AI 代理提出营销任务即可，代理会自动调用相应技能：

- "Help me optimize this landing page for conversions" → 使用 `cro` 技能
- "Write homepage copy for my SaaS" → 使用 `copywriting` 技能
- "Set up GA4 tracking for signups" → 使用 `analytics` 技能
- "Create a 5-email welcome sequence" → 使用 `emails` 技能

也可以直接调用技能：

```
/cro
/emails
/seo-audit
```

## 配置与部署要点

- **技能安装位置**：Claude Code 安装到 `.claude/skills/`，通用代理共享 `.agents/skills/`。若在代理会话内运行 CLI，可能只安装到通用目录，需显式指定代理：`npx skills add coreyhaines31/marketingskills -a claude-code`。
- **产品营销上下文文件**：v2.0 起从 `.claude/product-marketing-context.md` 迁移至 `.agents/product-marketing.md`，技能仍会检查旧位置作为回退。
- **升级清理**：从 v1.x 升级到 v2.0 后，需删除旧技能文件夹（如 `page-cro`、`form-cro` 等），并重新安装新技能。
- **自定义**：可通过 Fork 仓库定制技能，或按 CONTRIBUTING.md 指南贡献新技能。

## 限制、风险与许可证

- **限制**：技能为 Markdown 指令，实际效果取决于 AI 代理的理解和执行能力；部分技能可能需要外部工具或 API（如广告平台、分析工具），需用户自行配置。
- **风险**：技能内容可能包含过时信息或最佳实践，使用时需结合实际情况判断；AI 生成内容可能存在偏差，建议人工审核。
- **许可证**：MIT 许可证，允许自由使用、修改和分发。

## 官方链接

- 仓库地址：https://github.com/coreyhaines31/marketingskills
- 最新版本：v2.10.0（发布于 2026-07-27）
- 作者网站：https://corey.co
- 配套指南：https://codingformarketers.com
- 相关服务：Conversion Factory（https://conversionfactory.co）、Swipe Files（https://swipefiles.com）、Magister（https://magistermarketing.com）

## 信息来源和分析时间

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