内容创作 · coreyhaines31/marketingskills

marketing-skills

Name: marketing-skills
Author: coreyhaines31/marketingskills

When the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' 'who is my target audience,' 'describe my product,' 'ICP,' 'ideal customer profile,' or wants to avoid repeating foundational information across marketing tasks. Use this at the start of any new project before using other marketing skills — it creates `.agents/product-marketing.md` that all other skills reference for product, audience, and positioning context.

L4 高权限 · 分级授权与审计V1 已固定执行命令联网读写文件Dual-pass Audit

Author coreyhaines31GitHub coreyhaines31/marketingskills ↗Stars 50403License MIT（GitHub API spdx_id=MIT；.claude-plugin/plugin.json 内 "license": "MIT"；README 自述 'The library is free and MIT-licensed.'）Commit 5b2c000776

管控等级描述 skill 的能力与建议配套的管控措施，不代表质量或安全认证，也不表示可用或不可用。是否使用由用户和管理者决定。不同 agent 宿主对权限的约束各不相同，请勿假定宿主一定会提供安全兜底。第三方 skill 版权归原作者，使用风险由使用者自行承担。

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 生成（带  标记），并有 --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结论

覆盖面与工程化程度都远超同类营销 skill：50 个 skill + 64 个可执行 CLI + 95 份集成指南，且共享一份 product-marketing 上下文

可执行而不只是建议：agent 能直接查 GA4/Ads/SEO 数据，且有 dry-run 预演

内容型 skill 竟带评测：50 份 evals.json 给出 prompt/expected_output/assertions

凭证卫生设计到位：环境变量 + 缺失即退出 + dry-run 打码 + 不落本地

赞助披露可机械核查，不靠自觉

清单/版本一致性有 CI 兜底，减少『README 与 manifest 不一致』这类常见腐烂

适合： 适合：技术型营销人与独立创始人，希望让 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: 27377979bea86ebe…

Option B · Copy Guide for Agent

install.json

agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。

② Upstream GitHub

GitHub Repo ↗

Pinned to commit 5b2c000776.