1实现原理 · 为什么它能做到
它是一套 50 个独立 skill 的集合（skills/<name>/SKILL.md），靠共享上下文串起来：product-marketing 是地基，其余 skill 先读它生成的产品/受众/定位文档再干活。
README.md
Skills reference each other and build on shared context. The `product-marketing` skill is the foundation — every other skill checks it first to understand your product, audience, and positioning before doing anything.
落地成 .agents/product-marketing.md 一份文件（product-marketing 的 Workflow Step 1 会检查它是否存在，并提供从代码库自动起草 V1 的选项）。
每个 skill 都是纯 Markdown 指令（skills/ 下无任何可执行文件），实现方式是领域专家式检查表 + 输出结构纪律；知识密集部分拆到 references/ 按需加载。
skills/cro/SKILL.md
You are a conversion rate optimization expert. Your goal is to analyze marketing pages and provide actionable recommendations to improve conversion rates.
50 个 SKILL.md 合计 15196 行，实测无一超过 500 行（符合 AGENTS.md 的自设上限）；另有 178 个 references/ 文件承载细节。
真正的执行面在 tools/clis：64 个零依赖单文件 Node CLI，每个从环境变量读凭证、用 fetch 调对应厂商 API，并内置 --dry-run 只回显请求不发送。
tools/clis/ga4.js
if (args['dry-run']) { return { _dry_run: true, method, url: `${baseUrl}${path}`, headers: { Authorization: '***', 'Content-Type': 'application/json' }, body: body || undefined } }
实测三统计一致：grep -l 'process.env' / 'await fetch' / 'dry-run' 均为 64 个文件，即 100% 覆盖。凭证缺失即报错退出（如 'GA4_ACCESS_TOKEN environment variable required'）。
工具知识做成注册表 + 逐工具集成指南两层：REGISTRY.md 给索引与能力矩阵，tools/integrations/*.md 给端点、鉴权与常见操作。
tools/REGISTRY.md
Quick reference for AI agents to discover tool capabilities and integration methods.
实测 tools/integrations/ 有 95 份指南；REGISTRY 表内标注每个工具的 API/MCP/CLI/SDK 支持情况。
每个 skill 自带评测用例（evals/evals.json），把期望输出与可断言要点写死——内容型 skill 里少见的自测资产。
skills/cro/evals/evals.json
Checks for product-marketing.md
50 个 skill 各一份（find -name evals.json = 50）；用例含 prompt、expected_output 与 assertions 数组（如要求输出必须含 Quick Wins / High-Impact Changes / Test Ideas 三段）。
分发与清单一致性有自动化：CI 在 SKILL.md 变动时按改动矩阵逐个校验，并在 push 到 main 时同步 marketplace.json / plugin.json / README。
.github/workflows/validate-skill.yml
uses: Flash-Brew-Digital/validate-skill@v1
sync-skills.yml 以 Coreybot 身份自动提交 'chore: sync skills with marketplace.json, plugin.json, and README'；本地另有 validate-skills.sh（自研规范检查）与 validate-skills-official.sh（拉官方 skills-ref 库校验）。
版本纪律分两层并由 VERSIONS.md 驱动使用者侧更新检查：repo release 版本进 plugin.json/marketplace.json/VERSIONS.md，每 skill 另有 metadata.version。
AGENTS.md
**Per-skill version** — `metadata.version` in each SKILL.md, mirrored in the `VERSIONS.md` table. Bump on ANY shipped change to that skill: the update check compares `VERSIONS.md` against users' local skill metadata, so an unbumped change is invisible to installed users.
更新检查做法写在 AGENTS.md：'Fetch `VERSIONS.md` from GitHub: https://raw.githubusercontent.com/coreyhaines31/marketingskills/main/VERSIONS.md'，并规定只在 ≥2 个 skill 有更新或任一主版本跳变时非阻塞提示。
赞助与工具推荐被显式隔离并写成治理文档：伙伴是『已披露的存在』而非推荐加权。
tools/PARTNERS.md
**Sponsorship funds the work, never the recommendations.** Money buys a *disclosed presence*, never a bias.
README 的 Partners 区块与 REGISTRY 的 Verified Partners 表都由 partners.json 经 scripts/sync-partners.mjs 生成（带 <!-- PARTNERS:START/END --> 标记），并有 --check 模式供 CI 使用。
2核心能力
01CRO 与页面转化诊断（按页型分类，覆盖价值主张/标题/CTA 层级/信任信号/异议处理等维度，输出 Quick Wins / High-Impact / Test Ideas 三段）
02共享产品营销上下文文档的建立与维护（含版本与 changelog，避免每个 skill 重复问基础问题）
03文案与内容生产：copywriting / copy-editing / cold-email（B2B 冷邮件 + follow-up 序列 + 主题行与基准数据参考）
04SEO 族：seo-audit、ai-seo、programmatic-seo、schema、site-architecture（含国际 SEO 与 AI 写作检测参考）
05付费投放与实验：ads / ad-creative / ab-testing（含样本量指南与测试模板）
06增长与留存：referrals / free-tools / churn-prevention / paywalls / popups / onboarding / signup
07GTM 与营收运营：pricing / launch / revops / sales-enablement（含异议库、deck 框架、demo 脚本）/ prospecting
0864 个营销平台 CLI：GA4 / Mixpanel / Segment / Amplitude / Adobe Analytics / Plausible 到 Meta Ads / Google Ads / LinkedIn Ads / TikTok Ads、Klaviyo / Customer.io / Resend / Mailchimp、Ahrefs / Semrush / DataForSEO / G2 等
09策略与传播类：AARRR 结构营销计划、公关与 earned media、offer 设计、事件营销与 webinar、合作营销、竞品画像
3外部依赖
| Kind | Dependency / Endpoint |
|---|---|
| cli | node（64 个零依赖 CLI 的运行时，要求 Node 18+） |
| api | GA4（Data API + Admin API + Measurement Protocol；凭证 GA4_ACCESS_TOKEN） |
| api | Resend（邮件发送；凭证 RESEND_API_KEY） |
| api | Dub（短链/归因；凭证 DUB_API_KEY） |
| api | 其余厂商 API（每个 CLI 一个固定 base URL，共 64 个；鉴权与操作见 tools/integrations/*.md） |
| network | 更新检查（skill 指示 agent 抓取 raw.githubusercontent 上的 VERSIONS.md 比对版本） |
| network | 本地官方校验脚本会克隆并安装官方 skills-ref 库（仅维护者手动运行） |
| network | Composio（为无原生 MCP 的工具提供 MCP 访问的集成层，纯文档指引） |
| package | CI 侧第三方 Action：Flash-Brew-Digital/validate-skill@v1、actions/checkout@v6、stefanzweifel/git-auto-commit-action@v7 |
4管控建议与判定依据
建议配套管控措施
面向 Agent
分级或逐次授权，建议在沙箱运行
面向管理者
审批流程、可回滚、全程审计
判定依据（文件路径与关键语句摘要）
- scripts/: 执行本地脚本或命令: tools/clis/*.js（64 个）：由 agent 或用户按需 `node tools/clis/<name>.js <cmd> ...` 调
- 网络端点: 声明外部网络访问: tools/clis 的 64 个 CLI 会向各自厂商 API 发起 HTTPS 请求（GA4、Resend、Dub、Meta/Google/Lin
- 本地工作目录: 文件读写与工件输出: 核心 skill 会指示写入用户项目文件：.agents/product-marketing.md（product-marketing 的产物，含版本
审计说明： 。判级依据（按六档：涉及凭证/环境变量读取即橙色）：① tools/clis 下 64 个脚本 100% 读取厂商 API 凭证环境变量并以 Authorization 头外发（GA4_ACCESS_TOKEN、RESEND_API_KEY、META_ACCESS_TOKEN、GOOGLE_ADS_TOKEN 等），凭证接触与数据出境面真实存在；② skill 指示 agent 抓取 raw.githubusercontent 上的 VERSIONS.md 做更新检查；③ 分发链含第三方 GitHub Action（Flash-Brew-Digital/validate-skill@v1、stefanzweifel/git-auto-commit-action@v7），本地官方校验脚本还会 git clone + pip install 外部库。缓解面（不改变档位但必须写明）：核心 50 个 skill 本身零脚本、零凭证读取；CLI 的凭证全部来自用户自己的环境变量、指向各厂商官方端点、支持 --dry-run 预演且不落本地文件；仓库不读 keychain/.env/cookie；赞助推荐有显式治理与披露（PARTNERS.md + partners.json + 生成脚本 + CI check）。提醒点：① 让 agent 用这些 CLI 时，等于把对应厂商的 API key 交给会话进程环境，注意作用域与轮换；② 先用 --dry-run 看请求再实跑，尤其对会真实发信/建广告的 CLI（resend、meta-ads、google-ads 等）；③ 若在 Claude Code 里采用 AGENTS.md 的 `!`command`` 注入写法，那是你自己项目内的命令执行面，别写进共享 SKILL.md。
5第二遍独立确认
- [ok] skill.path 定位（任务表标『待定位』）；合集条目指向哪个具体 skill — 本条目展示名『Marketing Skills』对应的是 50 个 skill 的合集，仓库根无集合级 SKILL.md。skill.path 现指向 skills/product-marketing —— README 明写它是地基（'The `product-marketing` skill is the foundation — every other skill checks it first'），它产出全部其它 skill 共用的 .agents/product-marketing.md，因此最能代表这个集合的整体形态。其余 49 个 skill 并列于 skills/<name>/（cro、copywriting、seo-audit、ads、analytics、referrals、revops 等）；本 JSON 的 capabilities/traits 按合集口径书写，evidence 分别指向 skills/ 下与 tools/ 下的具体文件。
- [discrepancy] official_desc 取哪一份（合集无集合级 frontmatter description） — 合集在仓库根没有集合级 SKILL.md/frontmatter description（50 个 skill 各有自己的 description 与 metadata.version）。本条目 official_desc 采用代表 skill skills/product-marketing 的 frontmatter description 逐字原文（与 skill.path 指向的具体 skill 一致，满足『official_desc = SKILL.md frontmatter 原文』的取证规则）；集合级口径（plugin.json 的 'Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, ad creative, and growth' 与 marketplace.json 的 50-skill 长描述）已逐字记入 internal_assets 的清单条目说明，不丢失信息。
- [ok] 『核心 skill 无脚本』结论的反例搜索 — find skills -name '*.py' -o -name '*.sh' -o -name '*.js' 零命中；skills/ 下可执行资产为 0，全部内容为 .md 与 evals.json。所有可执行代码集中在 tools/clis（64）、scripts/（sync-partners.mjs）与两个根级 validate-skills*.sh。
- [ok] 『每个 CLI 都读凭证 + 都有 dry-run』是否全量成立 — grep -l 'process.env' tools/clis/*.js = 64；grep -l 'await fetch' = 64；grep -l 'dry-run' = 64。抽样读 ga4.js（三端点 + dry-run 打码 Authorization）、resend.js（api.resend.com）、dub.js（api.dub.co）确认模式一致，非个别实现。
- [ok] 赞助是否会污染推荐（治理是否只是口号） — PARTNERS.md 首条原则逐字 'Sponsorship funds the work, never the recommendations.'；README 与 REGISTRY 的伙伴区块由 partners.json 经 sync-partners.mjs 生成且带 ◆ 披露标记；REGISTRY 明写伙伴『listed alongside the neutral options for the same job, never instead of them』。属可核查的机制而非纯声明（生成脚本 + 标记区块 + --check）。
- [ok] 更新检查的真实动作 — AGENTS.md 'Checking for Updates' 小节逐字给出 raw.githubusercontent 上的 VERSIONS.md 抓取，并要求『Once per session, on first skill use』且仅在 ≥2 skill 有更新或主版本跳变时以非阻塞方式提示；属指示 agent 去抓取，而非仓库自带定时任务。
- [ok] CI 与本地校验的真实命令 — validate-skill.yml 用 matrix + Flash-Brew-Digital/validate-skill@v1 按改动的 SKILL.md 逐个校验；sync-skills.yml 跑 node .github/scripts/sync-skills.js 并自动提交三处清单；validate-skills.sh 为自研 shell 检查（exit 1 on issues）；validate-skills-official.sh 会 git clone github.com/agentskills/agentskills 到 /tmp 并 uv sync / pip install -e，属维护者手动运行的网络+远程包路径。
- [ok] stars / last_push 两源比对 — gh api 实时 stars=50403、pushed_at=2026-09-05T04:48:10Z；queue-100.json 快照为 50403 / 2026-09-05，一致。
6结论
适合： 适合：技术型营销人与独立创始人，希望让 agent 直接查数据（GA4/Ads/SEO）并落地文案、落地页、冷邮件、CRO 诊断；以及想照抄『如何把领域知识拆成 50 个可互相引用的 skill + 可执行 CLI + 评测』这套工程结构的 skill 作者。工作在 Claude Code / Codex / Cursor / Windsurf 等任何支持 Agent Skills 的宿主。
不适合： 不适合：① 只想要一段文案改写的轻量用户（装整包过载）；② 不愿意把厂商 API key 放进会话环境的团队；③ 需要自动化大规模投放/发信却不做 dry-run 复核的场景（会把副作用直接打到线上账户）；④ 追求单一权威方法论的用户——50 个 skill 跨 CRO/SEO/投放/留存，部分结论互有取舍，需自行判断；⑤ 期待它自动运营营销的用户：它给方法、给工具，但不做策略决策。
Install Agent-Ready
① Verified Mirror 2026-09-15
Option A · Direct DownloadDownload marketing-skills.tar.gz
sha256:
Option B · Copy Guide for Agent27377979bea86ebe…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② Upstream GitHub
GitHub Repo ↗
Pinned to commit 5b2c000776.