Marketing Skills for AI Agents 实战指南:基于 Agent Skills 规范的营销技能库解析与接入手册
Marketing Skills for AI Agents 实战指南:基于 Agent Skills 规范的营销技能库解析与接入手册
本文围绕开源仓库 README.md 展开,系统讲解 "Marketing Skills for AI Agents" 这一专为 AI 编码代理(Claude Code、OpenAI Codex、Cursor、Windsurf 等)设计的营销技能库:它如何通过 50 个 markdown 技能把 CRO、文案、SEO、分析与增长工程的最佳实践注入 Agent 的工作流,以及你如何完成安装、升级、触发与二次开发。读完本文,你将掌握该技能库的架构协作机制、六种安装方式、v1.x→v2.0 升级迁移路径、前端描述触发机制与底层工具生态(CLI / MCP / 注册表),并能够基于仓库源码理解其规范约束与质量保障体系。
一、项目定位:给 AI Agent 的"营销专业技能包"
"Marketing Skills for AI Agents"(仓库名 marketingskills)是一个面向技术型营销人员与创始人的开源技能集合,核心载体是符合 Agent Skills 规范 的 markdown 文件。它解决的问题很具体:AI 编码代理擅长写代码,但面对"优化落地页转化率""写 SaaS 首页文案""配置 GA4 事件跟踪"这类营销任务时缺乏领域知识。该仓库把这些知识固化为可加载、可触发的技能文件。
仓库的边界在 README.md 中写得很清楚:它适用于任何支持 Agent Skills 规范的代理(Claude Code、OpenAI Codex、Cursor、Windsurf),且采用 MIT 许可(见 LICENSE),完全免费。仓库还通过 tools/PARTNERS.md 定义了"Verified Partners"(已验证合作伙伴)的边界:合作伙伴以赞助方式支持开发,但只作为中性工具选项的并列项被披露,永远不改变核心技能推荐什么工具——赞助状态仅表示"付费、已披露、通过契合度审查",而非"同类最佳"。
从仓库结构(AGENTS.md)可以看到其整体布局:
marketingskills/
├── .claude-plugin/
│ └── marketplace.json # Claude Code 插件市场清单
├── skills/ # Agent Skills 本体(每个技能一个目录)
│ └── skill-name/
│ └── SKILL.md # 必需的主技能文件
├── tools/
│ ├── clis/ # 零依赖 Node.js CLI 工具(51 个)
│ ├── composio/ # Composio 集成层
│ ├── integrations/ # 每个工具的 API 集成指南
│ └── REGISTRY.md # 工具索引与能力总览
├── CONTRIBUTING.md
├── LICENSE
└── README.md
每个技能都是一个独立目录,内含 SKILL.md 主文件,以及可选的 references/(按需加载的深度文档)、scripts/(可执行代码)、assets/(模板与数据文件)。
二、核心架构:product-marketing 是全部技能的"上下文基座"
这是理解整个技能库的关键设计。仓库不是 50 个互不相关的技能文件堆叠,而是一个共享上下文 + 一组专长技能的分层结构。README 中的 ASCII 架构图(README.md)展示了这一点:product-marketing 技能位于金字塔顶端,其他所有技能在动手前都会先读取它。
┌──────────────────────────────────────┐
│ product-marketing │
│ (read by all other skills first) │
└──────────────────┬───────────────────┘
▼ ▼ ▼ ▼ ▼ ▼ ▼ (SEO/CRO/Content/Paid/Retention/Sales/Strategy 七大技能族)
同时技能之间存在横向交叉引用,例如:
copywriting ↔ cro ↔ ab-testingrevops ↔ sales-enablement ↔ cold-emailseo-audit ↔ schema ↔ ai-seocustomer-research → copywriting, cro, competitors
2.1 技能文件的统一规范
每个 SKILL.md 都以 YAML frontmatter 开头,包含 name 与 description 两个必填字段,例如 skills/cro/SKILL.md:
---
name: cro
description: "When the user wants to optimize, improve, or increase conversions on any marketing page or form — including homepage, landing pages, pricing pages... Also use when the user says 'CRO,' 'conversion rate optimization,' 'this page isn't converting'... For signup/registration flows, see signup..."
metadata:
version: 2.0.0
---
description 是技能被发现的关键——它明确写清"做什么 + 何时触发(触发短语)+ 边界移交(For X, see Y)"。例如 analytics 技能的描述末尾显式声明:"For choosing attribution models... see attribution. For A/B test measurement, see ab-testing"(见 skills/analytics/SKILL.md),以此划定技能之间的职责边界。
2.2 product-marketing 技能:维护 .agents/product-marketing.md
skills/product-marketing/SKILL.md 是所有技能的入口依赖。它指导 Agent 创建并维护一个位于 .agents/product-marketing.md 的上下文文档,沉淀产品定位与信息传达的根基信息。工作流分四步:
- 检查已有上下文:优先读取
.agents/product-marketing.md,并兼容.claude/product-marketing.md与旧文件名product-marketing-context.md;不存在时提供两条路径——从代码库自动草拟(推荐,读取 README、落地页、营销文案、package.json 等)或从零逐节访谈。 - 信息采集:要求记录客户的原话而非润色过的描述——"verbatim customer language"被认为比优雅表述更有价值。
- 创建文档:按固定模板输出 12 个章节(Product Overview、Target Audience、Personas、Problems & Pain Points、Competitive Landscape、Differentiation、Objections & Anti-Personas、Switching Dynamics、Customer Language、Brand Voice、Proof Points、Goals)。
- 确认、版本化与保存:新文档标
Document version: v1;每次实质性更新递增版本并在文档底部## Changelog区前插一行"改了什么、为什么"的记录(如- v3 (2026-07-16) — Repositioned from "email tool" to "deliverability platform"; added RevOps to the ICP.),纯错别字修正不升版本。
这套 Changelog 机制(VERSIONS.md 记录了其引入)让"定位/ICP 变化"在整个项目里可追溯——因为它是所有下游技能共享的上下文,谁基于什么版本生成过什么内容一目了然。
2.3 实例解剖:cro 技能的触发到产出
以 skills/cro/SKILL.md 为例看单个技能的运作:Agent 首先检查 product-marketing 上下文,然后识别页面类型、主转化目标与流量来源,再按影响优先级分析七大维度(价值主张清晰度、标题有效性、CTA 位置与文案、视觉层级、信任信号、异议处理、摩擦点)。输出格式固定为四段式:Quick Wins(立即可做)→ High-Impact Changes(优先级)→ Test Ideas(值得 A/B 测试的假设)→ Copy Alternatives(关键元素的 2-3 个备选文案)。它还按页面类型(首页/落地页/定价页/功能页/博客)给出差异化框架,并链接 skills/cro/references/experiments.md 与 skills/cro/references/form.md 做深度扩展。
三、技能清单与九大分类体系
截至 v2.11.0(2026-08-23),仓库共包含 50 个技能(VERSIONS.md),完整清单见 README.md 的自动生成表格。每个技能的名称都遵循统一命名规范(小写字母 + 数字 + 连字符),并按业务职能划分为九大类:
| 类别 | 技能 | 定位 |
|---|---|---|
| Conversion Optimization | cro signup onboarding popups paywalls |
页面/表单、注册流程、激活、弹窗、应用内升级时机 |
| Content & Copy | copywriting copy-editing cold-email emails social image |
营销文案、编辑润色、冷邮件、自动化邮件流、社媒内容、AI 图片 |
| SEO & Discovery | seo-audit ai-seo programmatic-seo site-architecture competitors schema |
技术与页面 SEO、AI 搜索优化(AEO/GEO/LLMO)、规模化页面生成、站点架构、对比页、结构化数据 |
| Paid & Distribution | ads events ad-creative social |
Google/Meta/LinkedIn 广告、活动、批量广告素材、社媒分发 |
| Measurement & Testing | analytics ab-testing |
事件跟踪、实验设计 |
| Retention | churn-prevention |
取消流程、挽留优惠、欠费追缴、支付恢复 |
| Growth Engineering | co-marketing free-tools referrals |
联合营销、营销工具、推荐/联盟计划 |
| Strategy & Monetization | marketing-ideas marketing-psychology launch pricing |
140 个 SaaS 营销点子、心理模型、产品发布、定价与变现 |
| Sales & RevOps | revops sales-enablement |
线索生命周期/评分/路由、销售材料/演示脚本 |
每个技能版本单独追踪,汇总在 VERSIONS.md 的版本表中(如 cro 2.0.0、ad-creative 2.8.2、product-marketing 2.1.0),供 Agent 对比本地版本以检测更新。
四、安装与接入:六种官方方式
README 提供了六种安装路径(README.md),按推荐度排列:
方式一:CLI 安装(推荐)
基于 npx skills 工具(来自 Vercel Labs 的 Agent Skills 安装器):
# 安装全部技能
npx skills add coreyhaines31/marketingskills
# 只安装指定技能
npx skills add coreyhaines31/marketingskills --skill cro copywriting
# 列出可用技能
npx skills add coreyhaines31/marketingskills --list
该 CLI 会自动检测你已安装的代理并询问安装位置:对 Claude Code 安装到 .claude/skills/,通用代理共享 .agents/skills/。README 特别给出一个易踩坑提示:如果在 Agent 会话内部(例如让 Claude Code 帮你安装)执行,CLI 会以非交互模式运行,可能只装到 Claude Code 不读取的 .agents/skills/ 目录——此时需显式指定代理:
npx skills add coreyhaines31/marketingskills -a claude-code
方式二:Claude Code 插件
仓库同时充当 Claude Code 的插件市场(清单位于 .claude-plugin/marketplace.json):
/plugin marketplace add coreyhaines31/marketingskills
/plugin install marketing-skills
方式三:克隆后复制
git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/* .agents/skills/
方式四:Git 子模块
git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills
之后从 .agents/marketingskills/skills/ 引用技能,便于持续拉取更新。
方式五:Fork 定制
Fork 本仓库 → 按需改造技能 → 将你的 fork 克隆进项目。
方式六:SkillKit 多代理分发
使用 SkillKit 工具跨多个代理(Claude Code、Cursor、Copilot 等)安装:
npx skillkit install coreyhaines31/marketingskills
npx skillkit install coreyhaines31/marketingskills --skill cro copywriting
npx skillkit install coreyhaines31/marketingskills --list
五、v1.x → v2.0 升级:重命名、合并与上下文迁移
v2.0 是仓库迄今最重要的破坏性版本(VERSIONS.md 记载):重命名 17 个技能,并把 page-cro + form-cro 合并为单一 cro 技能(表单内容移入 references/form.md)。升级后旧名称文件夹会与新技能并存(例如同时出现 skills/page-cro/ 与 skills/cro/),README 要求手动清理旧目录:
rm -rf page-cro form-cro \
ab-test-setup analytics-tracking aso-audit competitor-alternatives \
email-sequence free-tool-strategy launch-strategy onboarding-cro \
paid-ads paywall-upgrade-cro popup-cro pricing-strategy \
product-marketing-context referral-program schema-markup \
signup-flow-cro social-content
完整新旧名称映射(README.md):
| 旧名称 | 新名称 | 旧名称 | 新名称 |
|---|---|---|---|
ab-test-setup |
ab-testing |
onboarding-cro |
onboarding |
analytics-tracking |
analytics |
page-cro |
合并进 cro |
aso-audit |
aso |
paid-ads |
ads |
competitor-alternatives |
competitors |
paywall-upgrade-cro |
paywalls |
email-sequence |
emails |
popup-cro |
popups |
form-cro |
合并进 cro |
pricing-strategy |
pricing |
free-tool-strategy |
free-tools |
product-marketing-context |
product-marketing |
launch-strategy |
launch |
referral-program |
referrals |
schema-markup |
schema |
signup-flow-cro |
signup |
social-content |
social |
5.1 产品上下文文件的迁移
上下文文件从 .claude/ 迁至 .agents/,文件名从 product-marketing-context.md 改为 product-marketing.md:
mkdir -p .agents
mv .claude/product-marketing.md .agents/product-marketing.md 2>/dev/null
mv .claude/product-marketing-context.md .agents/product-marketing.md 2>/dev/null
技能仍会回退检查 .claude/ 与旧文件名,因此不迁移也不会中断运行。
5.2 版本号语义
AGENTS.md 定义了双层版本规则:仓库发行版遵循 x.y.z(x=仓库级重构/规范变更,y=新增技能,z=技能内容更新),每个技能的 metadata.version 则独立追踪——技能有改动就必须升版,否则已安装用户无法通过更新检查感知变化。v2.7.0 与 v2.8.0 曾因漏改 plugin.json/marketplace.json 造成版本漂移,需后续补账,这是维护者的明确教训。
六、使用方式:自然语言触发与直接调用
安装完成后无需任何额外配置,直接用自然语言描述营销任务即可(README.md):
"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 技能
也支持在 Agent 会话中直接斜杠调用:
/cro
/emails
/seo-audit
这里的匹配机制正是依赖每个技能 frontmatter 中 description 的触发短语(trigger phrases)设计——这也是 validate-skills.sh 会检查描述是否包含 "when / mention / use" 等触发词的原因。
七、工具生态:注册表、零依赖 CLI 与 MCP 集成
技能负责"给出方案",工具负责"执行落地"。仓库通过 tools/REGISTRY.md 维护一份 90+ 工具的索引,按 Analytics、SEO、CRM、Payments、Email、SMS、Ads、Referral、CRO、Video、Data Enrichment 等 30+ 类别组织,每个工具标注 API/MCP/CLI/SDK 支持情况并链接到 tools/integrations/ 下的详细指南。
7.1 零依赖 CLI 工具
tools/clis/ 包含 51 个单文件 Node.js 脚本,专为"平台没有官方 CLI"的场景而建(使用说明见 tools/clis/README.md)。四个一致性约定:
- 零依赖:仅需 Node 18+,使用原生
fetch - JSON 输出:可直接管道给
jq、存文件或进入脚本 - 环境变量鉴权:设置
{TOOL}_API_KEY即可使用,绝不硬编码密钥 - 统一命令模式:
{tool} <resource> <action> [options]
# 语法检查
node --check tools/clis/<name>.js
# 查看用法(无参数即帮助)
node tools/clis/<name>.js
# 预览请求而不实际发送(凭据掩码为 ***)
node tools/clis/<name>.js <cmd> --dry-run
实际使用示例:
node tools/clis/ahrefs.js backlinks list --target example.com --limit 50
semrush keywords overview --phrase "marketing automation" --database us | jq '.keywords[0]'
resend send --from you@example.com --to them@example.com --subject "Hello" --html "<p>Hi</p>"
鉴权采用统一的环境变量约定(如 AHREFS_API_KEY、GA4_ACCESS_TOKEN、META_ACCESS_TOKEN + META_AD_ACCOUNT_ID),完整映射表见 tools/clis/README.md。
7.2 MCP 与集成层
具备 MCP 服务器的原生工具包括 ga4、stripe、mailchimp、google-ads、resend、zapier、zoominfo、clay、supermetrics、coupler、outreach、crossbeam、introw、exa(tools/REGISTRY.md)。对于没有原生 MCP 的 OAuth 重型工具(HubSpot、Salesforce、Meta Ads、LinkedIn Ads、Google Sheets、Slack、Notion 等),仓库提供 Composio 集成层,通过单个 MCP 服务器统一接入 500+ 工具;另有 Cogny 作为聚焦营销渠道的托管 MCP 网关。各技能到工具的映射示例:referrals → rewardful/tolt/dub-co/mention-me,analytics → ga4/mixpanel/segment,emails → customer-io/mailchimp/resend,ads → google-ads/meta-ads/linkedin-ads(AGENTS.md)。
7.3 合作伙伴块的自动生成
README 的 Partners 区与 REGISTRY 的 Verified Partners 表由 scripts/sync-partners.mjs 从 partners.json 自动生成:脚本定位 <!-- PARTNERS:START --> 与 <!-- PARTNERS:END --> 标记并重写其间的块,--check 参数用于 CI 校验是否过期。当前无活跃合作伙伴(README.md),"Become a partner"入口保留。
八、技能规范与质量保障体系
8.1 Agent Skills 规范约束
仓库自带校验脚本 validate-skills.sh,逐一审计 skills/ 下每个技能,检查项与 AGENTS.md 的字段约束一致:
| 字段 | 必填 | 约束 |
|---|---|---|
name |
是 | 1-64 字符,仅小写字母/数字/连字符,须与目录名完全一致,不能以连字符开头/结尾、不能有连续 -- |
description |
是 | 1-1024 字符,须含触发短语(when/mention/use)与相关技能移交(see/for) |
license |
否 | 默认 MIT(允许 MIT/Apache-2.0/ISC) |
metadata |
否 | 键值对(author、version 等),version 必须放在 metadata 下而非顶层 |
结构约束:SKILL.md 应小于 500 行(超出即告警,提示把细节移入 references/),正文用 H2/H3 层级、短段落、加粗关键术语、表格呈现参考数据。脚本按 "Error(阻断)/ Warning(警告)/ Pass" 三档汇总并给出退出码。
8.2 评测套件
每个技能目录下的 evals/evals.json 是对应的自动评测集。以 skills/ab-testing/evals/evals.json 为例:每条评测含 prompt(用户自然语言请求)、expected_output(期望行为描述)与 assertions(断言列表)。如第 1 条评测要求 Agent "先检查 product-marketing.md、用'Because [observation], we believe [change] will cause [outcome], which we'll measure by [metric]'框架构建假设、基于 1.5 万月访问量与 3.2% 基线计算样本量、定义主/次/护栏指标、警告偷看(peeking)问题"。VERSIONS.md 显示各技能的新功能几乎都配套新增评测,构成"能力变更 → 评测锁定"的质量闭环。
8.3 更新检查机制
AGENTS.md 规定了安装后的更新检查流程:每次会话首次使用技能时拉取 VERSIONS.md 与本地对比,仅在"2 个及以上技能有更新"或"存在主版本跳升(如 1.x→2.x)"时提示,且为非阻塞式通知。
九、参与贡献与许可
仓库欢迎 PR 与 Issue(规范见 CONTRIBUTING.md),要求遵循 Conventional Commits 风格(feat: add skill-name skill、fix: improve clarity in cro、docs: update README),并遵守 AGENTS.md 的 PR 检查清单:name 与目录一致、description 含触发短语、SKILL.md 小于 500 行、不提交敏感数据。仓库整体以 MIT 许可发布,README.md 原话是"Use these however you want"。
结语
Marketing Skills for AI Agents 的价值不在于单个技能,而在于它把"营销方法论"结构化成了 Agent 可检索、可触发、可组合的资产:product-marketing 提供全技能共享的上下文基座,九大类 50 个技能覆盖从 CRO、SEO 到 RevOps 的完整营销职能,tools/ 注册表让方案与执行工具无缝衔接,而 frontmatter 规范、校验脚本与评测套件则保证了这套体系在跨代理场景下的可维护性与质量。对于希望让 AI 编码代理真正参与营销工作的团队,这是一个可直接安装、按需裁剪、可自由扩展的实战起点。