{
"canonical_name": "coreyhaines31/marketingskills",
"compilation_id": "pack_dccadc786bc94535a88331a86f2cb518",
"created_at": "2026-05-15T16:09:42.925122+00:00",
"created_by": "project-pack-compiler",
"feedback": {
"carrier_selection_notes": [
"viable_asset_types=skill, recipe, host_instruction, eval, preflight",
"recommended_asset_types=skill, recipe, host_instruction, eval, preflight"
],
"evidence_delta": {
"confirmed_claims": [
"identity_anchor_present",
"capability_and_host_targets_present",
"install_path_declared_or_better"
],
"missing_required_fields": [],
"must_verify_forwarded": [
"Run or inspect `npx skills` in an isolated environment.",
"Confirm the project exposes the claimed capability to at least one target host."
],
"quickstart_execution_scope": "allowlisted_sandbox_smoke",
"sandbox_command": "npx skills",
"sandbox_container_image": "node:22-slim",
"sandbox_execution_backend": "docker",
"sandbox_planner_decision": "deterministic_isolated_install",
"sandbox_validation_id": "sbx_e9a0f2ae76194510a75b82366c6ab9ce"
},
"feedback_event_type": "project_pack_compilation_feedback",
"learning_candidate_reasons": [],
"template_gaps": []
},
"identity": {
"canonical_id": "project_2516f5ef449745e98d6cab05315dd891",
"canonical_name": "coreyhaines31/marketingskills",
"homepage_url": null,
"license": "unknown",
"repo_url": "https://github.com/coreyhaines31/marketingskills",
"slug": "marketingskills",
"source_packet_id": "phit_4bd984dc46d64c7e993e196d193cd3d6",
"source_validation_id": "dval_d436df076e8348609d8f07e74d4f2057"
},
"merchandising": {
"best_for": "需要内容营销与增长能力，并使用 claude的用户",
"github_forks": 4473,
"github_stars": 27852,
"one_liner_en": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.",
"one_liner_zh": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.",
"primary_category": {
"category_id": "content-growth",
"confidence": "high",
"name_en": "Content & Growth",
"name_zh": "内容营销与增长",
"reason": "matched_keywords:marketing, growth, seo"
},
"target_user": "使用 claude, claude_code 等宿主 AI 的用户",
"title_en": "marketingskills",
"title_zh": "marketingskills 能力包",
"visible_tags": [
{
"label_en": "Browser Agents",
"label_zh": "浏览器 Agent",
"source": "repo_evidence_project_characteristics",
"tag_id": "product_domain-browser-agents",
"type": "product_domain"
},
{
"label_en": "Web Task Automation",
"label_zh": "网页任务自动化",
"source": "repo_evidence_project_characteristics",
"tag_id": "user_job-web-task-automation",
"type": "user_job"
},
{
"label_en": "Structured Data Extraction",
"label_zh": "结构化数据提取",
"source": "repo_evidence_project_characteristics",
"tag_id": "core_capability-structured-data-extraction",
"type": "core_capability"
},
{
"label_en": "Multi-role Workflow",
"label_zh": "多角色协作流程",
"source": "repo_evidence_project_characteristics",
"tag_id": "workflow_pattern-multi-role-workflow",
"type": "workflow_pattern"
},
{
"label_en": "Open Source Tool",
"label_zh": "开源工具",
"source": "repo_evidence_project_characteristics",
"tag_id": "selection_signal-open-source-tool",
"type": "selection_signal"
}
]
},
"packet_id": "phit_4bd984dc46d64c7e993e196d193cd3d6",
"page_model": {
"artifacts": {
"artifact_slug": "marketingskills",
"files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json",
"REPO_INSPECTION.md",
"CAPABILITY_CONTRACT.json",
"EVIDENCE_INDEX.json",
"CLAIM_GRAPH.json"
],
"required_files": [
"PROJECT_PACK.json",
"QUICK_START.md",
"PROMPT_PREVIEW.md",
"HUMAN_MANUAL.md",
"AI_CONTEXT_PACK.md",
"BOUNDARY_RISK_CARD.md",
"PITFALL_LOG.md",
"REPO_INSPECTION.json"
]
},
"detail": {
"capability_source": "Project Hit Packet + DownstreamValidationResult",
"commands": [
{
"command": "npx skills",
"label": "Node.js / npx · 官方安装入口",
"source": "https://github.com/coreyhaines31/marketingskills#readme",
"verified": true
}
],
"display_tags": [
"浏览器 Agent",
"网页任务自动化",
"结构化数据提取",
"多角色协作流程",
"开源工具"
],
"eyebrow": "内容营销与增长",
"glance": [
{
"body": "判断自己是不是目标用户。",
"label": "最适合谁",
"value": "需要内容营销与增长能力，并使用 claude的用户"
},
{
"body": "先理解能力边界，再决定是否继续。",
"label": "核心价值",
"value": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering."
},
{
"body": "未完成验证前保持审慎。",
"label": "继续前",
"value": "publish to Doramagic.ai project surfaces"
}
],
"guardrail_source": "Boundary & Risk Card",
"guardrails": [
{
"body": "Prompt Preview 只展示流程，不证明项目已安装或运行。",
"label": "Check 1",
"value": "不要把试用当真实运行"
},
{
"body": "claude, claude_code",
"label": "Check 2",
"value": "确认宿主兼容"
},
{
"body": "publish to Doramagic.ai project surfaces",
"label": "Check 3",
"value": "先隔离验证"
}
],
"mode": "skill, recipe, host_instruction, eval, preflight",
"pitfall_log": {
"items": [
{
"body": "仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。",
"category": "身份坑",
"evidence": [
"identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills"
],
"severity": "medium",
"suggested_check": "在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。",
"title": "仓库名和安装名不一致",
"user_impact": "用户照着仓库名搜索包或照着包名找仓库时容易走错入口。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。",
"title": "来源证据：Add OpenAI Codex plugin support",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：Create official marketing skills plugin for Claude Code plugin marketplace",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。",
"title": "来源证据：Feature Request: Add Prefix to skills",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand",
"user_impact": "可能影响升级、迁移或版本选择。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix",
"category": "安装坑",
"evidence": [
"community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v1.9.0 — image skill, video skill, plugin fix",
"user_impact": "可能增加新用户试用和生产接入成本。"
},
{
"body": "项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。",
"category": "配置坑",
"evidence": [
"capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code"
],
"severity": "medium",
"suggested_check": "列出会写入的配置文件、目录和卸载/回滚步骤。",
"title": "可能修改宿主 AI 配置",
"user_impact": "安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。"
},
{
"body": "README/documentation is current enough for a first validation pass.",
"category": "能力坑",
"evidence": [
"capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass."
],
"severity": "medium",
"suggested_check": "将假设转成下游验证清单。",
"title": "能力判断依赖假设",
"user_impact": "假设不成立时，用户拿不到承诺的能力。"
},
{
"body": "未记录 last_activity_observed。",
"category": "维护坑",
"evidence": [
"evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing"
],
"severity": "medium",
"suggested_check": "补 GitHub 最近 commit、release、issue/PR 响应信号。",
"title": "维护活跃度未知",
"user_impact": "新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "进入安全/权限治理复核队列。",
"title": "下游验证发现风险项",
"user_impact": "下游已经要求复核，不能在页面中弱化。"
},
{
"body": "No sandbox install has been executed yet; downstream must verify before user use.",
"category": "安全/权限坑",
"evidence": [
"risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use."
],
"severity": "medium",
"suggested_check": "转成明确权限清单和安全审查提示。",
"title": "存在安全注意事项",
"user_impact": "用户安装前需要知道权限边界和敏感操作。"
},
{
"body": "no_demo",
"category": "安全/权限坑",
"evidence": [
"risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium"
],
"severity": "medium",
"suggested_check": "把风险写入边界卡，并确认是否需要人工复核。",
"title": "存在评分风险",
"user_impact": "风险会影响是否适合普通用户安装。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More",
"user_impact": "可能影响授权、密钥配置或安全边界。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools",
"user_impact": "可能影响授权、密钥配置或安全边界。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw",
"user_impact": "可能影响授权、密钥配置或安全边界。"
},
{
"body": "GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK",
"category": "安全/权限坑",
"evidence": [
"community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。"
],
"severity": "medium",
"suggested_check": "来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。",
"title": "来源证据：v1.7.0 — ASO audit skill, Zapier SDK",
"user_impact": "可能影响授权、密钥配置或安全边界。"
}
],
"source": "ProjectPitfallLog + ProjectHitPacket + validation + community signals",
"summary": "发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。",
"title": "踩坑日志"
},
"snapshot": {
"contributors": 16,
"forks": 4473,
"license": "unknown",
"note": "站点快照，非实时质量证明；用于开工前背景判断。",
"stars": 27852
},
"source_url": "https://github.com/coreyhaines31/marketingskills",
"steps": [
{
"body": "不安装项目，先体验能力节奏。",
"code": "preview",
"title": "先试 Prompt"
},
{
"body": "理解输入、输出、失败模式和边界。",
"code": "manual",
"title": "读说明书"
},
{
"body": "把上下文交给宿主 AI 继续工作。",
"code": "context",
"title": "带给 AI"
},
{
"body": "进入主力环境前先完成安装入口与风险边界验证。",
"code": "verify",
"title": "沙箱验证"
}
],
"subtitle": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.",
"title": "marketingskills 能力包",
"trial_prompt": "# marketingskills - Prompt Preview\n\n> Copy the prompt below into your AI host before installing anything.\n> Its purpose is to let you safely feel the project's workflow, not to claim the project has already run.\n\n## Copy this prompt\n\n```text\nYou are using an independent Doramagic capability pack for coreyhaines31/marketingskills.\n\nProject:\n- Name: marketingskills\n- Repository: https://github.com/coreyhaines31/marketingskills\n- Summary: Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.\n- Host target: claude, claude_code\n\nGoal:\nHelp me evaluate this project for the following task without installing it yet: Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.\n\nBefore taking action:\n1. Restate my task, success standard, and boundary.\n2. Identify whether the next step requires tools, browser access, network access, filesystem access, credentials, package installation, or host configuration.\n3. Use only the Doramagic Project Pack, the upstream repository, and the source-linked evidence listed below.\n4. If a real command, install step, API call, file write, or host integration is required, mark it as \"requires post-install verification\" and ask for approval first.\n5. If evidence is missing, say \"evidence is missing\" instead of filling the gap.\n\nPreviewable capabilities:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n\nCapabilities that require post-install verification:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n- Capability 2: Use the source-backed project context to guide one small, checkable workflow step.\n\nCore service flow:\n1. getting-started: Getting Started. Produce one small intermediate artifact and wait for confirmation.\n2. skills-architecture: Skills Architecture. Produce one small intermediate artifact and wait for confirmation.\n3. conversion-skills: Conversion Optimization Skills. Produce one small intermediate artifact and wait for confirmation.\n4. content-copy-skills: Content and Copy Skills. Produce one small intermediate artifact and wait for confirmation.\n5. seo-discovery-skills: SEO and Discovery Skills. Produce one small intermediate artifact and wait for confirmation.\n\nSource-backed evidence to keep in mind:\n- https://github.com/coreyhaines31/marketingskills\n- https://github.com/coreyhaines31/marketingskills#readme\n- skills/ab-testing/SKILL.md\n- skills/ad-creative/SKILL.md\n- skills/ads/SKILL.md\n- skills/ai-seo/SKILL.md\n- skills/analytics/SKILL.md\n- skills/aso/SKILL.md\n- skills/churn-prevention/SKILL.md\n- skills/co-marketing/SKILL.md\n\nFirst response rules:\n1. Start Step 1 only.\n2. Explain the one service action you will perform first.\n3. Ask exactly three questions about my target workflow, success standard, and sandbox boundary.\n4. Stop and wait for my answers.\n\nStep 1 follow-up protocol:\n- After I answer the first three questions, stay in Step 1.\n- Produce six parts only: clarified task, success standard, boundary conditions, two or three options, tradeoffs for each option, and one recommendation.\n- End by asking whether I confirm the recommendation.\n- Do not move to Step 2 until I explicitly confirm.\n\nConversation rules:\n- Advance one step at a time and wait for confirmation after each small artifact.\n- Write outputs as recommendations or planned checks, not as completed execution.\n- Do not claim tests passed, files changed, commands ran, APIs were called, or the project was installed.\n- If the user asks for execution, first provide the sandbox setup, expected output, rollback, and approval checkpoint.\n```\n",
"voices": [
{
"body": "来源平台：github。github/github_issue: Add OpenAI Codex plugin support（https://github.com/coreyhaines31/marketingskills/issues/295）；github/github_issue: Create official marketing skills plugin for Claude Code plugin marketpla（https://github.com/coreyhaines31/marketingskills/issues/229）；github/github_issue: Feature Request: Add Prefix to skills（https://github.com/coreyhaines31/marketingskills/issues/279）；github/github_release: v1.9.0 — image skill, video skill, plugin fix（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0）；github/github_release: v1.8.0 — 2 new skills, security hardening, plugin fix（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0）；github/github_release: v1.7.0 — ASO audit skill, Zapier SDK（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0）；github/github_release: v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0）；github/github_release: v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0）；github/github_release: v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0）；github/github_release: v1.1.0 — Tools Registry, Progressive Disclosure & More（https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0）。这些是项目级外部声音，不作为单独质量证明。",
"items": [
{
"kind": "github_issue",
"source": "github",
"title": "Add OpenAI Codex plugin support",
"url": "https://github.com/coreyhaines31/marketingskills/issues/295"
},
{
"kind": "github_issue",
"source": "github",
"title": "Create official marketing skills plugin for Claude Code plugin marketpla",
"url": "https://github.com/coreyhaines31/marketingskills/issues/229"
},
{
"kind": "github_issue",
"source": "github",
"title": "Feature Request: Add Prefix to skills",
"url": "https://github.com/coreyhaines31/marketingskills/issues/279"
},
{
"kind": "github_release",
"source": "github",
"title": "v1.9.0 — image skill, video skill, plugin fix",
"url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v1.8.0 — 2 new skills, security hardening, plugin fix",
"url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v1.7.0 — ASO audit skill, Zapier SDK",
"url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw",
"url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand",
"url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools",
"url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0"
},
{
"kind": "github_release",
"source": "github",
"title": "v1.1.0 — Tools Registry, Progressive Disclosure & More",
"url": "https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0"
}
],
"status": "已收录 10 条来源",
"title": "社区讨论"
}
]
},
"homepage_card": {
"category": "内容营销与增长",
"desc": "Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.",
"effort": "安装已验证",
"forks": 4473,
"icon": "megaphone",
"name": "marketingskills 能力包",
"risk": "可发布",
"slug": "marketingskills",
"stars": 27852,
"tags": [
"浏览器 Agent",
"网页任务自动化",
"结构化数据提取",
"多角色协作流程",
"开源工具"
],
"thumb": "coral",
"type": "Skill Pack"
},
"manual": {
"markdown": "# https://github.com/coreyhaines31/marketingskills 项目说明书\n\n生成时间：2026-05-15 15:47:54 UTC\n\n## 目录\n\n- [Home](#home)\n- [Getting Started](#getting-started)\n- [Skills Architecture](#skills-architecture)\n- [Conversion Optimization Skills](#conversion-skills)\n- [Content and Copy Skills](#content-copy-skills)\n- [SEO and Discovery Skills](#seo-discovery-skills)\n- [Paid Advertising Skills](#paid-advertising-skills)\n- [Analytics and Testing Skills](#analytics-testing-skills)\n- [Retention and Growth Skills](#retention-growth-skills)\n- [Sales and RevOps Skills](#sales-revops-skills)\n\n\n\n## Home\n\n### 相关页面\n\n相关主题：[Getting Started](#getting-started), [Skills Architecture](#skills-architecture)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/schema/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema/references/schema-examples.md)\n\n\n# Home\n\nMarketing Skills is a comprehensive collection of reusable AI agent skills designed for marketing automation, campaign management, and growth engineering tasks. This repository serves as the central hub for marketing-related capabilities that can be integrated into AI agent workflows.\n\n## Overview\n\nThe repository provides pre-built skills for various marketing disciplines including conversion rate optimization, email marketing, SEO, analytics, content creation, and more. Each skill is self-contained with instructions, references, and scripts that enable AI agents to perform marketing-specific tasks.\n\n资料来源：[README.md:1-15]()\n\n## Repository Structure\n\nThe repository follows a modular architecture with three main components:\n\n| Component | Location | Purpose |\n|-----------|----------|---------|\n| Skills | `skills/` | Marketing task instructions for AI agents |\n| CLI Tools | `tools/clis/` | Zero-dependency Node.js scripts for integrations |\n| Integrations | `tools/integrations/` | API documentation and references |\n\n资料来源：[CLAUDE.md:1-20]()\n\n```mermaid\ngraph TD\n subgraph \"Marketing Skills Repository\"\n subgraph \"skills/\"\n CRO[\"CRO Skills\"]\n EMAIL[\"Email Marketing\"]\n SEO[\"SEO & Discovery\"]\n ADS[\"Paid Advertising\"]\n ANALYTICS[\"Analytics & Testing\"]\n CONTENT[\"Content & Copy\"]\n end\n \n subgraph \"tools/\"\n CLIS[\"CLI Tools\"]\n INTEGRATIONS[\"Integration Docs\"]\n end\n \n subgraph \"Documentation\"\n README[\"README.md\"]\n CLAUDE[\"CLAUDE.md\"]\n AGENTS[\"AGENTS.md\"]\n CONTRIBUTING[\"CONTRIBUTING.md\"]\n end\n end\n \n AI_AGENT[\"AI Agent\"] --> SKILLS\n AI_AGENT --> CLIS\n CLIS --> INTEGRATIONS\n```\n\n## Skills Categories\n\nThe repository contains skills organized by marketing discipline:\n\n### Conversion & User Experience\n\n| Skill | Description |\n|-------|-------------|\n| `cro` | Conversion rate optimization for pages, modals, overlays, and paywalls |\n| `form-cro` | Form optimization and behavior analysis |\n\n资料来源：[README.md:45-52]()\n\n### Content & Copywriting\n\n| Skill | Description |\n|-------|-------------|\n| `copywriting` | Marketing page copy generation |\n| `copy-editing` | Edit and polish existing copy |\n| `cold-email` | B2B cold outreach emails and sequences |\n| `emails` | Automated email flows |\n| `social` | Social media content creation |\n| `image` | AI image generation and design optimization |\n\n资料来源：[README.md:53-60]()\n\n### SEO & Discovery\n\n| Skill | Description |\n|-------|-------------|\n| `seo-audit` | Technical and on-page SEO analysis |\n| `ai-seo` | AI search optimization (AEO, GEO, LLMO) |\n| `programmatic-seo` | Scaled page generation |\n| `site-architecture` | Page hierarchy, navigation, URL structure |\n| `competitors` | Comparison and alternative pages |\n| `schema` | Structured data implementation |\n\n资料来源：[README.md:61-68]()\n\n### Paid & Distribution\n\n| Skill | Description |\n|-------|-------------|\n| `ads` | Google, Meta, LinkedIn ad campaigns |\n| `ad-creative` | Bulk ad creative generation and iteration |\n\n资料来源：[README.md:69-72]()\n\n### Measurement & Retention\n\n| Skill | Description |\n|-------|-------------|\n| `analytics` | Event tracking setup |\n| `ab-testing` | Experiment design |\n| `churn-prevention` | Cancel flows, save offers, dunning |\n\n资料来源：[README.md:73-80]()\n\n### Growth Engineering\n\n| Skill | Description |\n|-------|-------------|\n| `co-marketing` | Partner identification and joint campaigns |\n| `free-tools` | Marketing tools and calculators |\n| `referrals` | Referral and affiliate programs |\n| `marketing-ideas` | 140 SaaS marketing ideas |\n| `marketing-psychology` | Mental models and psychology |\n| `launch` | Product launches |\n\n资料来源：[README.md:81-87]()\n\n## Skill Structure\n\nEach skill follows a standardized directory structure:\n\n```\nskills/your-skill-name/\n├── SKILL.md # Required - main instructions\n├── references/ # Optional - additional documentation\n│ └── guide.md\n├── scripts/ # Optional - executable code\n│ └── helper.py\n└── assets/ # Optional - templates, images, data\n └── template.json\n```\n\n资料来源：[CONTRIBUTING.md:18-27]()\n\n### SKILL.md Format\n\nEvery skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: your-skill-name\ndescription: When to use this skill. Include trigger phrases and keywords.\n---\n\n# Your Skill Name\n\nInstructions for the agent go here...\n```\n\n资料来源：[CONTRIBUTING.md:10-18]()\n\n### Frontmatter Requirements\n\n| Field | Required | Constraints |\n|-------|----------|-------------|\n| `name` | Yes | 1-64 chars, lowercase `a-z`, numbers, hyphens. Must match directory name |\n| `description` | Yes | 1-1024 chars. Include trigger phrases |\n| `license` | No | License name (default: MIT) |\n| `metadata` | No | Key-value pairs (author, version, etc.) |\n\n资料来源：[AGENTS.md:45-55]()\n\n## CLI Tools\n\nThe repository includes zero-dependency Node.js scripts (Node 18+) for interacting with various marketing platforms:\n\n| Tool | Purpose |\n|------|---------|\n| `livestorm.js` | Webinar and event management |\n| `optimizely.js` | Experimentation platform |\n\n资料来源：[CLAUDE.md:25-30]()\n\n### CLI Verification Commands\n\n```bash\n# Syntax check\nnode --check tools/clis/.js\n\n# Show usage\nnode tools/clis/.js\n\n# Dry run preview\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[CLAUDE.md:26-32]()\n\n## Integration Documentation\n\nAPI references are provided for various marketing platforms:\n\n### Supported Integrations\n\n| Platform | Documentation | Key Features |\n|----------|---------------|--------------|\n| Postmark | Email delivery, templates, bounces | Transactional email |\n| WordPress | Posts, pages, categories, media | CMS integration |\n| Sanity | Content management, datasets | Structured content |\n| Intercom | Articles, admins, events, contacts | Customer communication |\n| Livestorm | Events, sessions, registrations | Webinar management |\n| Hyperframes | Video generation, HTML frames | Motion content |\n\n资料来源：[tools/integrations/postmark.md:1-35]()\n资料来源：[tools/integrations/sanity.md:1-50]()\n资料来源：[tools/integrations/intercom.md:1-40]()\n资料来源：[tools/integrations/livestorm.md:1-30]()\n\n## Installation Methods\n\nMultiple installation options are available for integrating skills into AI agent projects:\n\n```mermaid\ngraph LR\n A[\"Choose Method\"] --> B[\"Manual Clone\"]\n A --> C[\"Git Submodule\"]\n A --> D[\"Plugin System\"]\n A --> E[\"SkillKit\"]\n A --> F[\"Fork & Customize\"]\n \n B --> B1[\"cp -r skills/* .agents/skills/\"]\n C --> C1[\"git submodule add ...\"]\n D --> D1[\"/plugin install marketing-skills\"]\n E --> E1[\"npx skillkit install coreyhaines31/marketingskills\"]\n F --> F1[\"Custom fork in project\"]\n```\n\n资料来源：[README.md:20-45]()\n\n### Installation Options\n\n| Method | Command | Use Case |\n|--------|---------|----------|\n| Manual Clone | `git clone` + copy | Full control, custom modifications |\n| Git Submodule | `git submodule add` | Easy updates across projects |\n| Plugin Install | `/plugin install marketing-skills` | Quick setup in agent platforms |\n| SkillKit | `npx skillkit install` | Multi-agent support |\n\n资料来源：[README.md:20-40]()\n\n### SkillKit Multi-Agent Support\n\nSkillKit allows installing skills across multiple AI agents:\n\n```bash\n# Install all skills\nnpx skillkit install coreyhaines31/marketingskills\n\n# Install specific skills\nnpx skillkit install coreyhaines31/marketingskills --skill cro copywriting\n\n# List available skills\nnpx skillkit install coreyhaines31/marketingskills --list\n```\n\n资料来源：[README.md:35-42]()\n\n## Contributing\n\nNew skills can be added by following the contribution guidelines:\n\n```mermaid\ngraph TD\n A[\"Create Skill Directory\"] --> B[\"Add SKILL.md\"]\n B --> C[\"Follow Naming Conventions\"]\n C --> D[\"Structure Skill\"]\n D --> E[\"Write Effective Instructions\"]\n E --> F[\"Submit via PR or Issue\"]\n```\n\n资料来源：[CONTRIBUTING.md:1-15]()\n\n### Naming Conventions\n\n- **Directory name**: lowercase, hyphens only (e.g., `emails`)\n- **Name field**: must match directory name exactly\n- **Description**: 1-1024 characters, include trigger phrases\n\n资料来源：[CONTRIBUTING.md:22-25]()\n\n## Version Migration\n\nv2.0 introduced breaking changes including:\n\n- 17 skills renamed\n- `page-cro` + `form-cro` consolidated into single `cro` skill\n\n资料来源：[README.md:48-52]()\n\n## Quick Reference\n\n| Resource | Description |\n|----------|-------------|\n| `skills/*/SKILL.md` | Main skill instructions |\n| `skills/*/references/*` | Additional documentation |\n| `tools/integrations/*.md` | API references |\n| `tools/clis/*.js` | CLI tools |\n\n---\n\n\n\n## Getting Started\n\n### 相关页面\n\n相关主题：[Home](#home), [Skills Architecture](#skills-architecture)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [tools/clis/livestorm.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/livestorm.js)\n\n\n# Getting Started\n\nMarketing Skills is a collection of AI agent skills designed to help with various marketing tasks including copywriting, SEO optimization, paid advertising, analytics, and more. This guide covers installation, verification, and contribution workflows.\n\n## Overview\n\nMarketing Skills provides agents with domain-specific instructions for executing marketing tasks. Skills are content-only files with YAML frontmatter that define when and how to use each capability.\n\n```mermaid\ngraph TD\n A[Marketing Skills Repository] --> B[Skills Directory]\n A --> C[CLI Tools]\n A --> D[Integration References]\n \n B --> B1[copywriting]\n B --> B2[seo-audit]\n B --> B3[ads]\n B --> B4[emails]\n B --> B5[analytics]\n \n C --> C1[Node.js Scripts]\n C --> C2[Zero Dependencies]\n \n D --> D1[Postmark]\n D --> D2[WordPress]\n D --> D3[Intercom]\n```\n\n## Installation\n\nThe repository supports multiple installation methods depending on your AI agent setup.\n\n### Method 1: Claude Desktop\n\nAdd the skills path to your Claude Desktop configuration file:\n\n```json\n{\n \"agent\": {\n \"skills\": {\n \"marketing-skills\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"agent\", \"skills\", \"install\", \"marketing-skills\"]\n }\n }\n }\n}\n```\n\n资料来源：[README.md:1-10]()\n\n### Method 2: MCP Plugin\n\nFor MCP-compatible agents, install via plugin command:\n\n```bash\n/plugin install marketing-skills\n```\n\n资料来源：[README.md:1-10]()\n\n### Method 3: Clone and Copy\n\nClone the repository and manually copy skills to your agent's skills directory:\n\n```bash\ngit clone https://github.com/coreyhaines31/marketingskills.git\ncp -r marketingskills/skills/* .agents/skills/\n```\n\n资料来源：[README.md:1-10]()\n\n### Method 4: Git Submodule\n\nFor projects requiring version control over dependencies:\n\n```bash\ngit submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills\n```\n\nReference skills from `.agents/marketingskills/skills/`.\n\n资料来源：[README.md:1-10]()\n\n### Method 5: SkillKit\n\nFor multi-agent environments (Claude Code, Cursor, Copilot):\n\n```bash\n# Install all skills\nnpx skillkit install coreyhaines31/marketingskills\n\n# Install specific skills\nnpx skillkit install coreyhaines31/marketingskills --skill cro copywriting\n\n# List available skills\nnpx skillkit install coreyhaines31/marketingskills --list\n```\n\n资料来源：[README.md:1-10]()\n\n## Available Skills\n\nMarketing Skills includes the following categories:\n\n| Category | Skills |\n|----------|--------|\n| **Conversion** | `cro`, `ab-testing` |\n| **Content & Copy** | `copywriting`, `copy-editing`, `cold-email`, `emails`, `social`, `image` |\n| **SEO & Discovery** | `seo-audit`, `ai-seo`, `programmatic-seo`, `site-architecture`, `competitors`, `schema` |\n| **Paid & Distribution** | `ads`, `ad-creative` |\n| **Measurement** | `analytics` |\n| **Retention** | `churn-prevention` |\n| **Growth Engineering** | `co-marketing`, `free-tools`, `referrals` |\n| **Strategy** | `marketing-ideas`, `marketing-psychology`, `launch` |\n\n资料来源：[README.md:1-10]()\n\n## Skill Structure\n\nEach skill resides in its own directory with a standardized structure:\n\n```\nskills/your-skill-name/\n├── SKILL.md # Required - main instructions\n├── references/ # Optional - additional documentation\n│ └── guide.md\n├── scripts/ # Optional - executable code\n│ └── helper.py\n└── assets/ # Optional - templates, images, data\n └── template.json\n```\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n### SKILL.md Format\n\nEvery skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: your-skill-name\ndescription: When to use this skill. Include trigger phrases and keywords that help agents identify relevant tasks.\n---\n\n# Your Skill Name\n\nInstructions for the agent go here...\n```\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n### Frontmatter Field Constraints\n\n| Field | Required | Constraints |\n|-------|----------|-------------|\n| `name` | Yes | 1-64 chars, lowercase `a-z`, numbers, hyphens. Must match directory name. |\n| `description` | Yes | 1-1024 chars. Describe what it does and when to use it. |\n| `license` | No | License name (default: MIT) |\n| `metadata` | No | Key-value pairs (author, version, etc.) |\n\n资料来源：[AGENTS.md:1-50]()\n\n## Verification and Testing\n\n### Skills Validation\n\nSkills are content-only with no build step. Verify manually:\n\n| Check | Command/Action |\n|-------|----------------|\n| YAML frontmatter validity | Parse YAML syntax |\n| `name` field matches directory | Compare values |\n| `name` length constraints | 1-64 chars |\n| `description` length | 1-1024 chars |\n\n资料来源：[AGENTS.md:1-50]()\n\n### CLI Tools Verification\n\nCLI tools are zero-dependency Node.js scripts (Node 18+). Verify with:\n\n```bash\n# Syntax check\nnode --check tools/clis/.js\n\n# Show usage (no args = help)\nnode tools/clis/.js\n\n# Preview request without sending\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[AGENTS.md:1-50]()\n\n### Available CLI Tools\n\n| Tool | Purpose |\n|------|---------|\n| `livestorm.js` | Events, sessions, people, webhooks management |\n| `optimizely.js` | Experiments, pages, projects management |\n\n资料来源：[tools/clis/livestorm.js:1-50]()\n资料来源：[tools/clis/optimizely.js:1-50]()\n\n### CLI Tool Usage Example\n\n```bash\n# Show all available commands\nnode tools/clis/livestorm.js\n\n# Output structure\n{\n commands: {\n ping: 'ping',\n events: 'events [list | get --id | create --title | ...]',\n sessions: 'sessions [...]',\n people: 'people [list --email | get --id ]',\n webhooks: 'webhooks [...]',\n organization: 'organization'\n },\n usage: {\n options: '--page --per-page '\n }\n}\n```\n\n## Adding New Skills\n\n### Step 1: Create the Skill Directory\n\n```bash\nmkdir -p skills/your-skill-name\n```\n\n### Step 2: Create the SKILL.md File\n\nFollow the frontmatter format with required `name` and `description` fields.\n\n### Step 3: Follow Naming Conventions\n\n| Convention | Rule |\n|------------|------|\n| Directory name | lowercase, hyphens only (e.g., `emails`) |\n| Name field | Must match directory name exactly |\n| Description | 1-1024 characters, include trigger phrases |\n\n### Step 4: Structure Your Skill\n\nPlace supporting files in appropriate subdirectories:\n\n- `references/` - Additional documentation\n- `scripts/` - Executable code\n- `assets/` - Templates, images, data files\n\n### Step 5: Write Effective Instructions\n\n- Keep instructions clear and agent-executable\n- Include trigger phrases for skill discovery\n- Provide examples where applicable\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n## Requesting New Skills\n\nYou can suggest new skills by opening a skill request on GitHub:\n\n```bash\nhttps://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml\n```\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n## Upgrading from v1.x\n\nv2.0 introduces breaking changes:\n\n- 17 skills were renamed\n- `page-cro` and `form-cro` consolidated into single `cro` skill\n- Old v1.x skill folders become stale after upgrade\n\nIf upgrading, remove old skill directories before installing v2.0.\n\n资料来源：[README.md:1-10]()\n\n## Quick Reference\n\n```mermaid\ngraph LR\n A[Install] --> B[Copy to Skills Dir]\n B --> C[Validate Frontmatter]\n C --> D[Agent Ready]\n \n E[Contribute] --> F[Create Skill Dir]\n F --> G[Write SKILL.md]\n G --> H[Add References]\n H --> I[Submit PR]\n```\n\n| Task | Command |\n|------|---------|\n| Clone repository | `git clone https://github.com/coreyhaines31/marketingskills.git` |\n| List skills | `npx skillkit install coreyhaines31/marketingskills --list` |\n| Install specific | `npx skillkit install coreyhaines31/marketingskills --skill ` |\n| Verify CLI syntax | `node --check tools/clis/.js` |\n\n---\n\n\n\n## Skills Architecture\n\n### 相关页面\n\n相关主题：[Home](#home), [Conversion Optimization Skills](#conversion-skills), [Content and Copy Skills](#content-copy-skills), [SEO and Discovery Skills](#seo-discovery-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)\n- [skills/cro/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/SKILL.md)\n\n\n# Skills Architecture\n\n## Overview\n\nThe **Marketing Skills** repository is a collection of modular, AI-agent-compatible skills designed to automate and standardize marketing tasks across different platforms and workflows. Each skill is a self-contained unit that provides instructions, references, and optional scripts for AI agents to execute specific marketing functions.\n\nThe architecture follows a content-first approach where skills are defined as markdown files with YAML frontmatter, making them platform-agnostic and easily distributable across different AI agent frameworks including Claude Code, Cursor, Copilot, and custom implementations via SkillKit.\n\n资料来源：[README.md:1-15]()\n\n## Core Concepts\n\n### What is a Skill?\n\nA skill is the fundamental unit of functionality in the Marketing Skills architecture. It consists of:\n\n| Component | Type | Description |\n|-----------|------|-------------|\n| `SKILL.md` | Required | Main instruction file with YAML frontmatter |\n| `references/` | Optional | Additional documentation and guides |\n| `scripts/` | Optional | Executable code (Node.js scripts) |\n| `assets/` | Optional | Templates, images, and data files |\n\n资料来源：[CONTRIBUTING.md:18-26]()\n\n### Skill Hierarchy\n\nThe skills are organized into a hierarchical taxonomy based on marketing function:\n\n```mermaid\ngraph TD\n ROOT[\"Marketing Skills\"]\n ROOT --> CONTENT[\"Content & Copy\"]\n ROOT --> SEO[\"SEO & Discovery\"]\n ROOT --> PAID[\"Paid & Distribution\"]\n ROOT --> MEASURE[\"Measurement & Testing\"]\n ROOT --> RETENTION[\"Retention\"]\n ROOT --> GROWTH[\"Growth Engineering\"]\n ROOT --> STRATEGY[\"Strategy & Monetization\"]\n \n CONTENT --> COPY[\"copywriting\"]\n CONTENT --> EMAILS[\"emails\"]\n CONTENT --> SOCIAL[\"social\"]\n CONTENT --> IMAGE[\"image\"]\n \n SEO --> SEOAUDIT[\"seo-audit\"]\n SEO --> AI[\"ai-seo\"]\n SEO --> ARCH[\"site-architecture\"]\n SEO --> SCHEMA[\"schema\"]\n \n PAID --> ADS[\"ads\"]\n PAID --> ADCREATIVE[\"ad-creative\"]\n \n MEASURE --> ANALYTICS[\"analytics\"]\n MEASURE --> AB[\"ab-testing\"]\n \n RETENTION --> CHURN[\"churn-prevention\"]\n \n GROWTH --> COMARKETING[\"co-marketing\"]\n GROWTH --> REFERRALS[\"referrals\"]\n GROWTH --> FREETOOLS[\"free-tools\"]\n \n STRATEGY --> IDEAS[\"marketing-ideas\"]\n STRATEGY --> PSYCH[\"marketing-psychology\"]\n STRATEGY --> LAUNCH[\"launch\"]\n```\n\n资料来源：[README.md:35-60]()\n\n## Skill Structure Specification\n\n### Directory Naming Conventions\n\nAll skill directories must follow strict naming rules:\n\n| Rule | Requirement | Example |\n|------|-------------|---------|\n| Case | Lowercase only | `emails`, not `Emails` |\n| Separators | Hyphens only | `site-architecture`, not `site_architecture` |\n| Characters | Alphanumeric + hyphens | No spaces, underscores, or special characters |\n| Match | Must match `name` field exactly | Directory `cro` → name: `cro` |\n\n资料来源：[CONTRIBUTING.md:28-32]()\n\n### SKILL.md File Format\n\nEach skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: skill-name\ndescription: When to use this skill. Include trigger phrases and keywords that help agents identify relevant tasks.\n---\n\n# Skill Title\n\nInstructions for the agent go here...\n```\n\n#### Required Frontmatter Fields\n\n| Field | Required | Constraints |\n|-------|----------|-------------|\n| `name` | Yes | 1-64 characters, lowercase `a-z`, numbers, hyphens. Must match directory name exactly |\n| `description` | Yes | 1-1024 characters. Describe what it does and when to use it |\n\n#### Optional Frontmatter Fields\n\n| Field | Default | Description |\n|-------|---------|-------------|\n| `license` | MIT | License name for the skill content |\n| `metadata` | None | Key-value pairs for author, version, etc. |\n\n资料来源：[AGENTS.md:35-50]()\n\n### Skill Directory Structure\n\n```\nskills/your-skill-name/\n├── SKILL.md # Required - main instructions\n├── references/ # Optional - additional documentation\n│ └── guide.md\n├── scripts/ # Optional - executable code\n│ └── helper.py\n└── assets/ # Optional - templates, images, data\n └── template.json\n```\n\n资料来源：[CONTRIBUTING.md:20-27]()\n\n## Skill Categories\n\n### Content & Copy\n\nSkills focused on written content and messaging.\n\n| Skill | Purpose |\n|-------|---------|\n| `copywriting` | Marketing page copy generation |\n| `copy-editing` | Edit and polish existing copy |\n| `cold-email` | B2B cold outreach emails and sequences |\n| `emails` | Automated email flows |\n| `social` | Social media content |\n| `image` | AI image generation, design tools, and optimization |\n\n资料来源：[README.md:38-44]()\n\n### SEO & Discovery\n\nSkills for organic search and content discoverability.\n\n| Skill | Purpose |\n|-------|---------|\n| `seo-audit` | Technical and on-page SEO analysis |\n| `ai-seo` | AI search optimization (AEO, GEO, LLMO) |\n| `programmatic-seo` | Scaled page generation |\n| `site-architecture` | Page hierarchy, navigation, URL structure |\n| `competitors` | Comparison and alternative pages |\n| `schema` | Structured data implementation |\n\n资料来源：[README.md:46-52]()\n\n### Measurement & Testing\n\nSkills for analytics and experimentation.\n\n| Skill | Purpose |\n|-------|---------|\n| `analytics` | Event tracking setup |\n| `ab-testing` | Experiment design and analysis |\n\n资料来源：[README.md:56-58]()\n\n### Retention & Growth\n\nSkills focused on user retention and expansion.\n\n| Category | Skill | Purpose |\n|----------|-------|---------|\n| Retention | `churn-prevention` | Cancel flows, save offers, dunning, payment recovery |\n| Growth | `co-marketing` | Partner identification and joint campaigns |\n| Growth | `free-tools` | Marketing tools and calculators |\n| Growth | `referrals` | Referral and affiliate programs |\n\n资料来源：[README.md:60-66]()\n\n## Integration Architecture\n\n### Installation Methods\n\nThe Marketing Skills architecture supports multiple installation approaches:\n\n```mermaid\ngraph LR\n USER[\"User\"] --> REPO[\"Repository\"]\n REPO --> M1[\"Plugin Install\"]\n REPO --> M2[\"Clone & Copy\"]\n REPO --> M3[\"Git Submodule\"]\n REPO --> M4[\"SkillKit\"]\n \n M1 --> AGENTS[\"Agent Skills Folder\"]\n M2 --> AGENTS\n M3 --> AGENTS\n M4 --> AGENTS\n```\n\n| Method | Command | Best For |\n|--------|---------|----------|\n| Plugin | `/plugin install marketing-skills` | Built-in agent plugin systems |\n| Clone | `git clone` + copy | Manual installation |\n| Submodule | `git submodule add` | Version-controlled projects |\n| SkillKit | `npx skillkit install` | Multi-agent environments |\n\n资料来源：[README.md:8-25]()\n\n### SkillKit Integration\n\nFor multi-agent environments, SkillKit provides unified installation:\n\n```bash\n# Install all skills\nnpx skillkit install coreyhaines31/marketingskills\n\n# Install specific skills\nnpx skillkit install coreyhaines31/marketingskills --skill cro copywriting\n\n# List available skills\nnpx skillkit install coreyhaines31/marketingskills --list\n```\n\n资料来源：[README.md:22-28]()\n\n## Validation & Quality Standards\n\n### Manual Verification Checklist\n\nSince skills are content-only (no build step), manual verification is required:\n\n| Check | Requirement |\n|-------|-------------|\n| YAML frontmatter | Must be valid YAML syntax |\n| Name field | Must match directory name exactly |\n| Name format | 1-64 chars, lowercase alphanumeric and hyphens only |\n| Description | 1-1024 characters |\n\n资料来源：[AGENTS.md:30-35]()\n\n### CLI Tool Validation\n\nCLI tools in `tools/clis/*.js` are zero-dependency Node.js scripts (Node 18+). Verify with:\n\n```bash\n# Syntax check\nnode --check tools/clis/.js\n\n# Show usage (no args = help)\nnode tools/clis/.js\n\n# Preview request without sending\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[CLAUDE.md:28-34]()\n\n## Version Compatibility\n\n### v1.x to v2.0 Migration\n\nv2.0 introduces breaking changes that require migration attention:\n\n| Change Type | Details |\n|-------------|---------|\n| Renamed skills | 17 skills were renamed |\n| Consolidated skills | `page-cro` + `form-cro` merged into single `cro` skill |\n\nIf upgrading from v1.x, stale old-name folders must be removed to avoid conflicts.\n\n资料来源：[README.md:30-35]()\n\n## Tooling & Integrations\n\n### Integration Layer\n\nThe architecture includes a `tools/integrations/` directory for third-party service integrations:\n\n| Integration | Purpose |\n|-------------|---------|\n| `postmark.md` | Email delivery and tracking API |\n| `zoominfo.md` | Contact and company enrichment |\n| `sanity.md` | CMS content management |\n| `wordpress.md` | WordPress REST API |\n| `optimizely.js` | Experimentation platform CLI |\n| `livestorm.js` | Event and session management CLI |\n\nThese integrations follow a consistent documentation pattern with API endpoints, example payloads, and key object descriptions.\n\n资料来源：[tools/integrations/*.md](https://github.com/coreyhaines31/marketingskills/tree/main/tools/integrations)\n\n## Contributing Workflow\n\n### Adding a New Skill\n\n```mermaid\ngraph TD\n START[\"Create skill directory\"] --> YAML[\"Create SKILL.md with frontmatter\"]\n YAML --> STRUCTURE[\"Structure skill contents\"]\n STRUCTURE --> VALIDATE[\"Validate naming conventions\"]\n VALIDATE --> TEST[\"Test with AI agent\"]\n TEST --> SUBMIT[\"Submit via PR or issue\"]\n```\n\n1. Create the skill directory: `mkdir -p skills/your-skill-name`\n2. Create the `SKILL.md` file with required YAML frontmatter\n3. Follow naming conventions (lowercase, hyphens only)\n4. Structure with optional `references/`, `scripts/`, and `assets/` directories\n5. Write clear instructions with trigger phrases for agent activation\n\n资料来源：[CONTRIBUTING.md:10-40]()\n\n## References\n\n- [Agent Skills Specification](https://agentskills.io/specification.md) - Industry standard for skill definitions\n- [SkillKit Repository](https://github.com/rohitg00/skillkit) - Multi-agent skill management\n\n---\n\n\n\n## Conversion Optimization Skills\n\n### 相关页面\n\n相关主题：[Analytics and Testing Skills](#analytics-testing-skills), [Content and Copy Skills](#content-copy-skills), [Retention and Growth Skills](#retention-growth-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/cro/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/SKILL.md)\n- [skills/cro/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/references/experiments.md)\n- [skills/cro/references/form.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/references/form.md)\n- [skills/signup/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/signup/SKILL.md)\n- [skills/onboarding/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/onboarding/SKILL.md)\n- [skills/onboarding/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/onboarding/references/experiments.md)\n- [skills/popups/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/popups/SKILL.md)\n- [skills/paywalls/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/paywalls/SKILL.md)\n- [skills/paywalls/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/paywalls/references/experiments.md)\n\n\n# Conversion Optimization Skills\n\n## Overview\n\nConversion Optimization Skills (CRO) in the marketingskills repository encompass a suite of specialized skills designed to maximize user conversion rates across different touchpoints in the customer journey. These skills focus on optimizing key conversion moments including signup flows, onboarding sequences, popup interactions, and paywall presentations.\n\n## Skill Architecture\n\nThe conversion optimization module is structured around several interconnected skills that address different stages of the user conversion funnel:\n\n```mermaid\ngraph TD\n CRO[Conversion Rate Optimization] --> SIGNUP[Signup Flow]\n CRO --> ONBOARDING[Onboarding Sequences]\n CRO --> POPUPS[Popup Strategy]\n CRO --> PAYWALLS[Paywall Optimization]\n \n SIGNUP --> FORM[Form Optimization]\n ONBOARDING --> EXP[Experimentation]\n POPUPS --> EXP\n PAYWALLS --> EXP\n \n EXP --> DATA[Analytics & Measurement]\n```\n\n## Core Conversion Optimization Skill (cro)\n\nThe central `cro` skill provides foundational methodologies for improving conversion rates across any touchpoint. It consolidates previously separate `page-cro` and `form-cro` skills into a unified approach.\n\n### Experimentation Framework\n\nThe CRO skill emphasizes systematic experimentation to validate optimization hypotheses. The experimentation methodology follows a structured approach:\n\n1. **Hypothesis Formation** - Define specific, measurable hypotheses about user behavior\n2. **Variant Design** - Create alternative versions with single variable changes\n3. **Traffic Allocation** - Distribute visitors across control and variant groups\n4. **Statistical Validation** - Determine significance using appropriate statistical methods\n5. **Iteration Cycle** - Apply learnings to subsequent optimization rounds\n\n### Form Optimization\n\nForm optimization represents a critical subset of CRO, focusing on reducing friction in data collection touchpoints:\n\n| Optimization Area | Key Principles | Impact |\n|------------------|----------------|--------|\n| Field Count | Minimize required fields to essential data only | Reduces cognitive load |\n| Field Order | Place easiest fields first | Builds momentum |\n| Labels | Use clear, descriptive labels | Reduces confusion |\n| Validation | Real-time inline validation | Prevents frustration |\n| Autocomplete | Enable browser autocomplete where appropriate | Speeds completion |\n\n## Signup Flow Skill\n\nThe `signup` skill addresses the critical first conversion point where visitors become registered users. It provides templates and best practices for:\n\n- **Progressive disclosure** - Reveal additional fields only when needed\n- **Social signup integration** - OAuth flows for Google, GitHub, and other providers\n- **Email verification flows** - Handle verification states gracefully\n- **Error recovery** - Guide users through validation failures\n\n## Onboarding Sequences\n\nThe `onboarding` skill focuses on post-signup engagement and activation. Effective onboarding directly impacts:\n\n- Time to first value (TTFV)\n- Day-7 and Day-30 retention rates\n- Feature adoption breadth\n\n### Onboarding Experiment Patterns\n\nOnboarding optimization benefits from continuous experimentation. Common experiment categories include:\n\n| Experiment Type | Description | Success Metric |\n|----------------|-------------|----------------|\n| Tooltip placement | Where and when guidance appears | Feature discovery rate |\n| Walkthrough length | Number of steps in initial tour | Completion rate |\n| Skip options | Immediate access to product vs. forced tour | Long-term engagement |\n| Checklist style | Gamified vs. straightforward checklists | Activation rate |\n\n## Popup Strategy\n\nThe `popups` skill provides guidance on leveraging modals and overlays for conversion without degrading user experience. Key principles include:\n\n- **Trigger timing** - Exit intent, scroll depth, time on page\n- **Frequency capping** - Prevent popup fatigue\n- **Personalization** - Match content to user segments\n- **Mobile considerations** - Full-screen overlays vs. banners\n\n## Paywall Optimization\n\nThe `paywalls` skill addresses conversion moments where users encounter monetization barriers. Optimization strategies include:\n\n- **Metered paywall calibration** - Free article limits that balance traffic and conversion\n- **Upgrade prompts** - When and how to present upgrade opportunities\n- **Feature differentiation** - Clearly communicating free vs. paid tier capabilities\n- **Dunning sequences** - Recovering failed payments and reducing churn\n\n### Paywall Experiment Variables\n\n| Variable | Options | Considerations |\n|----------|---------|----------------|\n| Display trigger | Scroll %, time on site, exit intent | User intent signals |\n| Hard vs. soft | Complete block vs. partial preview | Revenue vs. engagement |\n| Pricing presentation | Monthly vs. annual emphasis | Perceived value |\n| CTA copy | Action-oriented vs. benefit-oriented | Conversion psychology |\n\n## Integration with Analytics\n\nConversion optimization skills integrate with the broader analytics skill to enable data-driven decisions:\n\n- **Event tracking** - Capture micro-conversions throughout flows\n- **Funnel analysis** - Identify drop-off points\n- **A/B testing infrastructure** - Support for controlled experiments\n- **Attribution modeling** - Understand which touchpoints drive conversions\n\n## Skill Metadata Schema\n\nConversion optimization skills follow the standard skill metadata schema:\n\n```yaml\n---\nname: cro\ndescription: Conversion rate optimization methodologies for improving conversion rates across signup, onboarding, and monetization touchpoints.\nlicense: MIT\nmetadata:\n version: 2.0\n author: marketingskills\n---\n```\n\n## Related Skills\n\nThe conversion optimization ecosystem connects to several adjacent skills:\n\n- **seo-audit** - Technical optimization supporting conversion\n- **ab-testing** - Experimental methodology foundation\n- **analytics** - Measurement and data infrastructure\n- **emails** - Post-conversion nurture sequences\n- **schema** - Structured data for search appearance optimization\n\n## Best Practices Summary\n\n1. **Start with analysis** - Identify drop-off points before implementing changes\n2. **One variable at a time** - Isolate changes to understand impact\n3. **Respect statistical significance** - Avoid decisions based on insufficient sample sizes\n4. **Mobile-first** - Optimize for mobile conversion flows first\n5. **Continuous iteration** - Treat optimization as an ongoing process, not a one-time effort\n\n---\n\n\n\n## Content and Copy Skills\n\n### 相关页面\n\n相关主题：[Conversion Optimization Skills](#conversion-skills), [SEO and Discovery Skills](#seo-discovery-skills), [Sales and RevOps Skills](#sales-revops-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/copywriting/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/SKILL.md)\n- [skills/copywriting/references/copy-frameworks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/references/copy-frameworks.md)\n- [skills/copywriting/references/natural-transitions.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/references/natural-transitions.md)\n- [skills/copy-editing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skkills/copy-editing/SKILL.md)\n- [skills/cold-email/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/SKILL.md)\n- [skills/cold-email/references/frameworks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/frameworks.md)\n- [skills/cold-email/references/subject-lines.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/subject-lines.md)\n- [skills/cold-email/references/personalization.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/personalization.md)\n- [skills/emails/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/emails/SKILL.md)\n- [skills/emails/references/sequence-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/emails/references/sequence-templates.md)\n- [skills/social/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social/SKILL.md)\n- [skills/social/references/post-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social/references/post-templates.md)\n\n\n# Content and Copy Skills\n\nThe Content and Copy Skills module within the Marketing Skills repository encompasses a comprehensive suite of skills designed to generate, refine, and distribute marketing copy across multiple channels. These skills form the core communication layer of any marketing operation, enabling AI agents to produce professional-grade content that spans marketing pages, email campaigns, cold outreach, and social media.\n\n## Overview and Architecture\n\nThe Content and Copy Skills are organized into six distinct but interconnected skill areas, each addressing a specific content creation or refinement use case. The skills work both independently and in combination to support complete content workflows from initial drafting through final publication.\n\n```mermaid\ngraph TD\n COPY[\"Copywriting Marketing Page Copy\"] --> EDIT[\"Copy-Editing Polish & Refine\"]\n COPY --> EMAIL[\"Automated Emails Email Flows\"]\n COLD[\"Cold Email B2B Outreach\"] --> EMAIL\n EMAIL --> SOCIAL[\"Social Media Content Distribution\"]\n COPY --> SOCIAL\n \n style COPY fill:#e1f5fe\n style EDIT fill:#fff3e0\n style EMAIL fill:#e8f5e9\n style COLD fill:#fce4ec\n style SOCIAL fill:#f3e5f5\n```\n\nThe primary skills in this module include:\n\n| Skill | Directory | Purpose |\n|-------|-----------|---------|\n| **Copywriting** | `skills/copywriting/` | Generate marketing page copy and promotional content |\n| **Copy-Editing** | `skills/copy-editing/` | Edit and polish existing copy to professional standards |\n| **Cold Email** | `skills/cold-email/` | B2B cold outreach emails and multi-step sequences |\n| **Emails** | `skills/emails/` | Automated email flows and drip campaigns |\n| **Social** | `skills/social/` | Social media content creation and posting strategy |\n\n资料来源：[README.md:1-20]()\n\n## Copywriting Skill\n\nThe copywriting skill specializes in generating persuasive marketing copy for web pages, landing pages, and promotional materials. It provides AI agents with the frameworks and techniques needed to produce compelling marketing narratives that drive conversions.\n\n### Skill Structure\n\nEach copywriting skill implementation follows a standardized directory structure:\n\n```\nskills/copywriting/\n├── SKILL.md # Main instructions and usage guidelines\n├── references/\n│ ├── copy-frameworks.md # Proven copywriting frameworks\n│ └── natural-transitions.md # Smooth copy transition techniques\n├── scripts/ # Optional automation helpers\n└── assets/ # Templates and example data\n```\n\n资料来源：[CONTRIBUTING.md:1-20]()\n\n### Core Copywriting Frameworks\n\nThe copywriting skill provides access to several proven frameworks for structuring marketing copy. These frameworks help ensure that generated content follows established best practices for persuasion and conversion optimization.\n\n**Problem-Agitate-Solve (PAS)** is the foundational framework that identifies customer pain points, amplifies the emotional impact of those problems, and then introduces the product or service as the solution.\n\n**Before-After-Bridge** presents the customer's current painful state, shows the desired future state after solving the problem, and positions the product as the bridge between these two states.\n\n**Feature-Benefit Bridge** transforms technical product features into tangible benefits that resonate with customer needs and desires.\n\n资料来源：[skills/copywriting/references/copy-frameworks.md](skills/copywriting/references/copy-frameworks.md)\n\n### Natural Transitions\n\nEffective marketing copy requires smooth transitions between sections to maintain reader engagement and logical flow. The natural transitions reference guide provides techniques for connecting:\n\n- Headlines to subheadings\n- Benefits to proof points\n- Objections to responses\n- CTAs to supporting context\n\nThese transitions prevent jarring shifts in tone or topic that can cause readers to disengage from the content.\n\n资料来源：[skills/copywriting/references/natural-transitions.md](skills/copywriting/references/natural-transitions.md)\n\n## Copy-Editing Skill\n\nThe copy-editing skill focuses on refining and polishing existing marketing copy to professional standards. Unlike copywriting which creates new content, copy-editing improves material that has already been drafted.\n\n### Editorial Standards\n\nThe skill enforces several key editorial standards:\n\n- **Grammar and Syntax**: Ensures proper sentence structure, verb agreement, and punctuation usage\n- **Consistency**: Maintains uniform tone, style, and terminology throughout the document\n- **Clarity**: Removes ambiguous phrases and complex jargon that may confuse readers\n- **Pacing**: Adjusts sentence length and paragraph structure for optimal readability\n- **Voice**: Ensures the copy maintains consistent brand voice and tone\n\n### Editing Workflow\n\nThe copy-editing process follows a systematic approach:\n\n1. **Structural Review**: Examine overall document organization and logical flow\n2. **Line Editing**: Refine individual sentences for clarity and impact\n3. **Copy Editing**: Check grammar, punctuation, and style consistency\n4. **Final Polish**: Verify formatting, spacing, and visual presentation\n\n资料来源：[skills/copy-editing/SKILL.md](skills/copy-editing/SKILL.md)\n\n## Cold Email Skill\n\nThe cold email skill enables AI agents to craft effective B2B cold outreach campaigns. This skill addresses the unique challenges of reaching prospects who have no prior relationship with the sender and must be convinced to engage.\n\n### Cold Email Components\n\nEach cold email follows a structured format that maximizes response rates:\n\n```mermaid\ngraph LR\n A[\"Subject Line Personalized Hook\"] --> B[\"Opening Immediate Value\"]\n B --> C[\"Body Problem/Solution\"]\n C --> D[\"CTA Clear Next Step\"]\n D --> E[\"Signature Credibility\"]\n \n style A fill:#ffcdd2\n style B fill:#c8e6c9\n style C fill:#bbdefb\n style D fill:#fff9c4\n style E fill:#e1bee7\n```\n\n### Subject Line Strategies\n\nSubject lines determine whether cold emails get opened. The skill provides multiple approaches:\n\n- **Curiosity Gap**: Creates intrigue by implying missing information\n- **Personalization**: Uses recipient's name, company, or recent activity\n- **Value Proposition**: Clearly states the benefit of reading\n- **Question Format**: Engages through rhetorical or genuine questions\n- **Social Proof**: References mutual connections or recognizable companies\n\n资料来源：[skills/cold-email/references/subject-lines.md](skills/cold-email/references/subject-lines.md)\n\n### Personalization Techniques\n\nEffective cold emails feel personalized rather than mass-sent. The skill teaches several personalization dimensions:\n\n- **Company Research**: Reference recent news, funding rounds, or product launches\n- **Role-Based Messaging**: Tailor content to the recipient's job function\n- **Industry Context**: Reference challenges specific to their sector\n- **Mutual Connections**: Mention shared contacts or associations\n- **Behavioral Triggers**: Reference actions like conference attendance or content consumption\n\n资料来源：[skills/cold-email/references/personalization.md](skills/cold-email/references/personalization.md)\n\n### Cold Email Frameworks\n\nThe skill implements several proven outreach frameworks:\n\n**AIDA (Attention-Interest-Desire-Action)** guides the prospect through a logical progression from initial awareness to taking action.\n\n**The 4Ps (Problem-Preview-Proof-Promise)** opens with the prospect's problem, offers a preview of the solution, provides proof through social proof or case studies, and promises a specific outcome.\n\n**The 5-Step Icebreaker** uses a series of low-commitment questions or observations to establish rapport before making an ask.\n\n资料来源：[skills/cold-email/references/frameworks.md](skills/cold-email/references/frameworks.md)\n\n## Automated Emails Skill\n\nThe emails skill handles the creation of automated email flows, including welcome sequences, nurture campaigns, onboarding series, and re-engagement sequences. These automated communications operate without direct human intervention once initially configured.\n\n### Email Sequence Types\n\n| Sequence Type | Purpose | Typical Length | Primary Goal |\n|--------------|---------|----------------|---------------|\n| Welcome Series | Introduce new subscribers to the brand | 3-5 emails | Engagement, education |\n| Nurture Sequence | Build relationships with leads | 5-10 emails | Trust building |\n| Onboarding | Help customers use the product | 5-15 emails | Activation, adoption |\n| Re-engagement | Win back inactive subscribers | 3-5 emails | Retention |\n| Post-Purchase | Follow up after transactions | 2-5 emails | Satisfaction, upsells |\n\n资料来源：[skills/emails/SKILL.md](skills/emails/SKILL.md)\n\n### Sequence Templates\n\nThe skill includes pre-built sequence templates that can be customized for specific use cases. Each template includes:\n\n- Email subject line variations\n- Optimal send timing between emails\n- Content structure for each message\n- Fallback sequences for non-responders\n- Success metrics and milestones\n\n资料来源：[skills/emails/references/sequence-templates.md](skills/emails/references/sequence-templates.md)\n\n### Email Components\n\nAll emails generated by this skill follow a consistent structure:\n\n**Subject Line**: Optimized for inbox placement and open rates, incorporating personalization tokens and preview text optimization.\n\n**Preheader**: The preview text that appears after the subject line in most email clients, providing additional context.\n\n**Email Body**: The main content, formatted for readability with appropriate spacing, hierarchy, and visual elements.\n\n**Call to Action**: Clear, prominent CTAs with multiple variations for A/B testing.\n\n**Footer**: Required legal information, unsubscribe links, and physical address.\n\n## Social Media Skill\n\nThe social skill enables creation of social media content across multiple platforms. It handles the unique requirements of each platform while maintaining consistent brand messaging.\n\n### Platform Adaptations\n\nEach social platform has distinct characteristics that require content adaptation:\n\n| Platform | Content Style | Optimal Length | Best For |\n|----------|--------------|----------------|----------|\n| LinkedIn | Professional, thought leadership | 150-300 words | B2B content |\n| Twitter/X | Concise, timely, conversational | 100-280 characters | News, updates |\n| Instagram | Visual-first, story-driven | Caption 125-150 words | Lifestyle, products |\n| Facebook | Community-focused, varied format | 40-80 words | Engagement |\n\n资料来源：[skills/social/SKILL.md](skills/social/SKILL.md)\n\n### Post Templates\n\nThe skill provides templates for common social media post types:\n\n- **Educational Posts**: Tips, how-tos, and industry insights\n- **Promotional Posts**: Product features, offers, and announcements\n- **Engagement Posts**: Questions, polls, and discussion starters\n- **Social Proof Posts**: Testimonials, case studies, user-generated content\n- **Behind-the-Scenes**: Team features, company culture, process insights\n\n资料来源：[skills/social/references/post-templates.md](skills/social/references/post-templates.md)\n\n## Integration Workflows\n\nThe Content and Copy Skills are designed to work together in integrated workflows that span the entire content lifecycle.\n\n```mermaid\ngraph TD\n DRAFT[\"Draft Copy Copywriting\"] --> EDIT[\"Edit & Polish Copy-Editing\"]\n EDIT --> DIST[\"Distribute Content\"]\n \n DIST --> COLD[\"Cold Outreach Cold Email\"]\n DIST --> AUTO[\"Automated Flows Emails\"]\n DIST --> SOCIAL[\"Social Posts Social Media\"]\n \n COLD --> TRACK[\"Track & Optimize\"]\n AUTO --> TRACK\n SOCIAL --> TRACK\n \n TRACK --> INSIGHTS[\"Insights Analytics\"]\n INSIGHTS --> DRAFT\n \n style DRAFT fill:#e3f2fd\n style EDIT fill:#fff8e1\n style DIST fill:#f1f8e9\n style COLD fill:#fce4ec\n style AUTO fill:#e8f5e9\n style SOCIAL fill:#f3e5f5\n style TRACK fill:#eceff1\n style INSIGHTS fill:#e0f7fa\n```\n\n### Typical Content Pipeline\n\n1. **Initial Draft**: Use copywriting skill to generate initial marketing copy\n2. **Refinement**: Apply copy-editing skill to polish and professionalize the copy\n3. **Adaptation**: Transform the core copy into platform-specific variations for cold email, automated emails, and social posts\n4. **Personalization**: Apply personalization techniques from cold email and social skills\n5. **Scheduling**: Organize content into appropriate sending schedules\n6. **Measurement**: Track engagement metrics to inform future iterations\n\n## Quality Standards\n\nAll Content and Copy Skills adhere to consistent quality standards:\n\n### Voice and Tone Guidelines\n\n| Aspect | Standard |\n|--------|----------|\n| **Perspective** | Second person (\"you\") for reader focus |\n| **Tense** | Present tense for immediacy, future tense for promises |\n| **Complexity** | Plain language; avoid jargon unless appropriate |\n| **Sentence Length** | 15-25 words average; mix lengths for rhythm |\n| **Paragraph Length** | 2-4 sentences maximum for digital content |\n\n### SEO Considerations\n\nContent generated by these skills should incorporate basic SEO principles:\n\n- Primary keywords in headlines and early in content\n- Natural keyword density without stuffing\n- Clear hierarchical structure with H2 and H3 headings\n- Internal linking opportunities identified\n- Meta descriptions and title tags for web content\n\n### Compliance Requirements\n\nFor regulated industries or jurisdictions, skills include safeguards for:\n\n- Clear disclosure of paid promotions and sponsored content\n- Proper attribution for third-party claims\n- Accessibility standards (alt text, readable contrast)\n- Email unsubscribe compliance\n\n## Best Practices\n\n### Copywriting Best Practices\n\n- Lead with the customer's problem, not the product\n- Use specific numbers and statistics for credibility\n- Include social proof early in the copy\n- Make the CTA specific and action-oriented\n- Test multiple headline variations\n\n### Email Best Practices\n\n- Personalize subject lines and preview text\n- Send at optimal times for the target audience\n- Maintain consistent sender identity\n- Use a single clear CTA per email\n- Include plain text alternatives\n\n### Cold Email Best Practices\n\n- Research prospects before reaching out\n- Lead with value, not immediate asks\n- Keep emails short and scannable\n- Follow up multiple times with different angles\n- Track metrics and iterate based on results\n\n## Related Skills\n\nThe Content and Copy Skills connect to other marketing skills in the repository:\n\n- **CRO (Conversion Rate Optimization)**: Optimizes copy for conversions\n- **Analytics**: Measures content performance\n- **A/B Testing**: Tests copy variations\n- **SEO Audit**: Ensures content is discoverable\n- **Programmatic SEO**: Scales content production\n\n## Conclusion\n\nThe Content and Copy Skills module provides a comprehensive toolkit for generating, refining, and distributing marketing content across all major channels. By leveraging proven frameworks, templates, and best practices, AI agents can produce professional-grade copy that drives engagement and conversions. The modular design allows teams to use individual skills for specific needs or combine them into complete content workflows for maximum efficiency.\n\n---\n\n\n\n## SEO and Discovery Skills\n\n### 相关页面\n\n相关主题：[Content and Copy Skills](#content-copy-skills), [Paid Advertising Skills](#paid-advertising-skills)\n\n\nRelated Source Files\n\n以下源码文件用于生成本页说明：\n\n- [skills/seo-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/SKILL.md)\n- [skills/seo-audit/references/ai-writing-detection.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/references/ai-writing-detection.md)\n- [skills/ai-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/SKILL.md)\n- [skills/ai-seo/references/platform-ranking-factors.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/platform-ranking-factors.md)\n- [skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md)\n- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/competitors/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitors/SKILL.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/schema/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema/SKILL.md)\n- [skills/content-strategy/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/content-strategy/SKILL.md)\n\n\n# SEO and Discovery Skills\n\nThe SEO and Discovery Skills module encompasses a comprehensive suite of marketing automation capabilities designed to optimize organic search visibility, enhance content discoverability, and improve overall site architecture for search engines and AI-powered platforms.\n\n## Overview\n\nThis skill set addresses the complete spectrum of search engine optimization and content discovery requirements, from technical site audits to AI-driven content optimization. The skills are designed to work both independently and as an integrated system, enabling marketing teams to implement data-driven SEO strategies at scale.\n\n### Skill Categories\n\n| Category | Primary Skills | Purpose |\n|----------|---------------|---------|\n| **Technical SEO** | `seo-audit` | Technical and on-page SEO analysis |\n| **AI Optimization** | `ai-seo` | AI search optimization (AEO, GEO, LLMO) |\n| **Scale SEO** | `programmatic-seo` | Scaled page generation |\n| **Site Structure** | `site-architecture` | Page hierarchy, navigation, URL structure |\n| **Competitor Analysis** | `competitors`, `competitor-profiling` | Comparison and alternative pages |\n| **Structured Data** | `schema` | Structured data implementation |\n\n## Architecture\n\n```mermaid\ngraph TD\n A[SEO Strategy] --> B[Site Architecture]\n A --> C[Content Strategy]\n B --> D[Navigation Patterns]\n B --> E[URL Structure]\n C --> F[Programmatic SEO]\n C --> G[Schema Markup]\n A --> H[Competitor Analysis]\n H --> I[Competitor Profiling]\n H --> J[Competitor Comparison]\n F --> K[AI SEO Optimization]\n G --> K\n K --> L[AI Writing Detection]\n A --> M[SEO Audit]\n M --> N[Technical Analysis]\n M --> O[On-Page Analysis]\n```\n\n## Site Architecture Skill\n\nThe `site-architecture` skill focuses on establishing optimal page hierarchies, navigation systems, and URL structures that both users and search engines can efficiently navigate.\n\n### Hub-and-Spoke Content Model\n\nThis model demonstrates the relationship between a central hub page connecting to multiple spoke articles, with spokes linking to each other for cross-navigation.\n\n```mermaid\ngraph TD\n HUB[\"SEO Guide (Hub Page)\"]\n HUB --> S1[\"Keyword Research\"]\n HUB --> S2[\"On-Page SEO\"]\n HUB --> S3[\"Technical SEO\"]\n HUB --> S4[\"Link Building\"]\n S1 -.-> S2\n S2 -.-> S3\n S3 -.-> S4\n \n style HUB fill:#f9f,stroke:#333,stroke-width:2px\n```\n\nLegend:\n- Solid lines indicate primary hub-spoke links\n- Dashed lines indicate cross-links between spokes\n\n### Internal Linking Flow\n\nThe internal linking structure connects different site sections to distribute page authority effectively.\n\n```mermaid\ngraph LR\n subgraph \"Marketing\"\n HOME[\"Homepage\"]\n FEAT[\"Features\"]\n PRICE[\"Pricing\"]\n end\n \n subgraph \"Content\"\n BLOG[\"Blog\"]\n GUIDE[\"Guides\"]\n CASE[\"Case Studies\"]\n end\n \n subgraph \"Product\"\n DOCS[\"Docs\"]\n API[\"API Ref\"]\n CHANGE[\"Changelog\"]\n end\n \n HOME --> FEAT\n HOME --> BLOG\n BLOG --> FEAT\n BLOG --> CASE\n CASE --> FEAT\n CASE --> PRICE\n FEAT --> DOCS\n GUIDE --> BLOG\n GUIDE --> DOCS\n```\n\n### Navigation Patterns\n\n#### Breadcrumb Standards\n\nBreadcrumbs provide users with a clear path back to the site root and help search engines understand page hierarchy.\n\n**Standard Format:**\n```\nHome > Features > Analytics\nHome > Blog > SEO Category > How to Do Keyword Research\nHome > Docs > API Reference > Authentication\n```\n\n**Rules:**\n- Use `>` or `/` as separators consistently\n- Every segment must be a link except the current page\n- Current page appears as plain text (not linked)\n- Omit the current page if the title is already visible as an H1\n\n#### Schema Markup Implementation\n\nBreadcrumb schema markup improves search result appearance through rich snippets.\n\n```html\n\n```\n\n## SEO Audit Skill\n\nThe `seo-audit` skill provides comprehensive technical and on-page SEO analysis capabilities to identify optimization opportunities and technical issues.\n\n### AI Writing Detection\n\nThe SEO audit system includes mechanisms for detecting AI-generated content, which has become increasingly important as search engines refine their algorithms to evaluate content quality.\n\n**Key Detection Areas:**\n- Linguistic pattern analysis\n- Uniqueness scoring\n- Content authenticity verification\n\n资料来源：[skills/seo-audit/references/ai-writing-detection.md]()\n\n### Technical SEO Components\n\n| Component | Description |\n|-----------|-------------|\n| Crawlability Analysis | Site structure accessibility for search bots |\n| Indexability Assessment | Page indexing status and coverage |\n| Meta Tag Evaluation | Title, description, and Open Graph tags |\n| Content Quality | Duplicate content, thin content identification |\n| Performance Metrics | Core Web Vitals alignment |\n\n## AI SEO Skill\n\nThe `ai-seo` skill addresses the emerging discipline of optimizing content for AI-powered search platforms and generative engines.\n\n### Generative Engine Optimization (GEO)\n\nGEO focuses on optimizing content for citation by AI assistants including ChatGPT, Claude, Perplexity, and Gemini.\n\n### GEO Content Patterns\n\n#### E-E-A-T Emphasis Block\n\nE-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) serves as the cornerstone of Google's content quality evaluation.\n\n```markdown\nE-E-A-T is the cornerstone of Google's content quality evaluation. Google's Search Quality Rater Guidelines confirm that trust is the most critical factor, stating that \"untrustworthy pages have low E-E-A-T no matter how experienced, expert, or authoritative they may seem.\" This means content creators must prioritize transparency and accuracy above all other optimization tactics.\n```\n\n#### Statistic Citation Block\n\nStatistics increase AI citation rates by 15-30%. Always include sources.\n\n```markdown\nMobile optimization is no longer optional for SEO success. According to Google's 2024 Core Web Vitals report, 70% of web traffic now comes from mobile devices, and pages failing mobile usability standards see 24% higher bounce rates.\n```\n\n#### Self-Contained Answer Block\n\nCreate quotable, standalone statements that AI systems can extract directly.\n\n```markdown\n**[Topic/Question]**: [Complete, self-contained answer that makes sense without additional context. Include specific details, numbers, or examples in 2-3 sentences.]\n```\n\n**Example:**\n```markdown\n**Ideal blog post length for SEO**: The optimal length for SEO blog posts is 1,500-2,500 words for competitive topics. This range allows comprehensive topic coverage while maintaining reader engagement. HubSpot research shows long-form content earns 77% more backlinks than short articles, directly impacting search rankings.\n```\n\n#### Evidence Sandwich Block\n\nStructure claims with evidence for maximum credibility.\n\n```markdown\n[Opening claim statement].\n\nEvidence supporting this includes:\n- [Data point 1 with source]\n- [Data point 2 with source]\n- [Data point 3 with source]\n\n[Concluding statement connecting evidence to actionable insight].\n```\n\n### Domain-Specific GEO Tactics\n\nDifferent content domains benefit from different authority signals:\n\n| Domain | Authority Signals |\n|--------|------------------|\n| **Technology** | Technical precision, version numbers, official documentation, code examples |\n| **Health/Medical** | Peer-reviewed studies with publication details |\n| **Finance** | Regulatory compliance, expert credentials, data sources |\n| **E-commerce** | Product specifications, user reviews, pricing transparency |\n\n### FAQ Block Pattern\n\nUse for \"How do I...\", \"What is...\", and \"Why...\" queries that commonly appear in featured snippets.\n\n```markdown\n**[Question]**: [Direct answer in the first sentence]. [Supporting context in 2-3 additional sentences].\n```\n\n**Tips for FAQ questions:**\n- Use natural question phrasing (\"How do I...\" not \"How does one...\")\n- Include question words: what, how, why, when, where, who, which\n- Match \"People Also Ask\" queries from search results\n- Keep answers between 50-100 words\n\n### Listicle Block Pattern\n\nUse for \"Best [X]\", \"Top [X]\", \"[Number] ways to [X]\" queries.\n\n```markdown\n## [Number] Best [Items] for [Goal/Purpose]\n\n[1-2 sentence intro establishing context and selection criteria]\n\n### 1. [Item Name]\n\n[Why it's included in 2-3 sentences with specific benefits]\n```\n\n## Programmatic SEO Skill\n\nThe `programmatic-seo` skill enables scaled page generation for targeting long-tail keywords and creating comprehensive content at scale.\n\n### When to Use Programmatic SEO\n\n- High-intent keywords with commercial value\n- Template-based content with consistent structure\n- Resource pages, location pages, or comparison pages\n- Integration with product databases or data sources\n\n### Content Types\n\n| Type | Use Case | Example |\n|------|----------|---------|\n| **Location Pages** | Local SEO targeting | `/locations/city-name` |\n| **Comparison Pages** | Product comparisons | `/compare/product-a-vs-product-b` |\n| **Resource Hubs** | Curated resource collections | `/resources/best-tools` |\n| **Template Libraries** | Downloadable resources | `/templates/marketing-plan` |\n\n## Schema Skill\n\nThe `schema` skill provides structured data implementation guidelines for enhancing search result appearance through rich snippets.\n\n### Article / BlogPosting Schema\n\n```json\n{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Article\",\n \"headline\": \"How to Implement Schema Markup\",\n \"image\": \"https://example.com/image.jpg\",\n \"datePublished\": \"2024-01-15T08:00:00+00:00\",\n \"dateModified\": \"2024-01-20T10:00:00+00:00\",\n \"author\": {\n \"@type\": \"Person\",\n \"name\": \"Jane Doe\",\n \"url\": \"https://example.com/authors/jane\"\n },\n \"publisher\": {\n \"@type\": \"Organization\",\n \"name\": \"Example Company\",\n \"logo\": {\n \"@type\": \"ImageObject\",\n \"url\": \"https://example.com/logo.png\"\n }\n },\n \"description\": \"A complete guide to implementing schema markup...\",\n \"mainEntityOfPage\": {\n \"@type\": \"WebPage\",\n \"@id\": \"https://example.com/schema-guide\"\n }\n}\n```\n\n### Product Schema\n\n```json\n{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Product\",\n \"name\": \"Premium Widget\",\n \"image\": \"https://example.com/widget.jpg\",\n \"description\": \"High-quality widget for professional use\",\n \"sku\": \"WIDGET-001\",\n \"brand\": {\n \"@type\": \"Brand\",\n \"name\": \"ExampleCorp\"\n },\n \"offers\": {\n \"@type\": \"Offer\",\n \"price\": \"99.99\",\n \"priceCurrency\": \"USD\",\n \"availability\": \"https://schema.org/InStock\"\n }\n}\n```\n\n### SearchAction Schema\n\n```json\n{\n \"@type\": \"WebSite\",\n \"name\": \"Example Site\",\n \"url\": \"https://example.com\",\n \"potentialAction\": {\n \"@type\": \"SearchAction\",\n \"target\": {\n \"@type\": \"EntryPoint\",\n \"urlTemplate\": \"https://example.com/search?q={search_term_string}\"\n },\n \"query-input\": \"required name=search_term_string\"\n }\n}\n```\n\n## Competitor Profiling Skill\n\nThe `competitor-profiling` skill enables systematic analysis of competitor websites to extract positioning, features, pricing, and messaging intelligence.\n\n### Research Process\n\n#### Phase 1: Site Scraping (Firecrawl)\n\n##### Step 1: Map the Site\n\nUse **Firecrawl Map** to discover the competitor's site structure and identify key pages:\n\n```\nfirecrawl_map → competitor URL\n```\n\nFrom the map, identify and prioritize these page types:\n\n| Page Type | Priority Content |\n|-----------|-----------------|\n| Homepage | Headline, subheadline, value proposition, primary CTA |\n| Pricing | Tiers, prices, feature breakdown, billing options |\n| Features | Feature categories, key capabilities |\n| About | Company positioning, team, culture |\n| Blog | Content strategy signals |\n| Customers | Case studies, testimonials |\n| Integrations | Partnership ecosystem |\n| Changelog | Product development direction |\n\n##### Step 2: Scrape Key Pages\n\n```\nfirecrawl_scrape → each key page URL\n```\n\nSave results to `competitor-profiles/raw///scrapes/.md` before extracting fields.\n\n### Data Extraction Matrix\n\n| Page | What to Extract |\n|------|----------------|\n| Homepage | Headline, subheadline, value proposition, primary CTA, social proof claims, target audience signals |\n| Pricing | Tiers, prices, feature breakdown per tier, billing options, free tier/trial details |\n| Features | Feature categories, key capabilities, how they describe each feature |\n\n### Competitor Comparison Skill\n\nThe `competitors` skill focuses on creating comparison and alternative pages that position your offering against competitors.\n\n## Content Strategy Integration\n\nThe `content-strategy` skill provides the foundational content planning that supports all SEO activities.\n\n### SEO Fields Checklist\n\nEvery page-level content type needs:\n\n| Field | Description | Character Limit |\n|-------|-------------|-----------------|\n| `metaTitle` | Page title for search results | 50-60 characters |\n| `metaDescription` | Meta description for snippets | 150-160 characters |\n| `ogImage` | Social preview image | 1200x630px |\n| `slug` | URL path segment | Short, descriptive |\n| `canonicalUrl` | Optional override for duplicate content | — |\n| `noIndex` | Boolean for excluding from search | — |\n| `structuredData` | Optional JSON-LD override | Valid schema |\n\n### Editorial Workflow\n\n```mermaid\ngraph LR\n A[Draft] --> B[Review]\n B --> C[Approve]\n C --> D[Schedule]\n D --> E[Publish]\n \n style A fill:#f9f\n style E fill:#9f9\n```\n\n### Preview APIs\n\nAll major headless CMS platforms support draft previews:\n\n| Platform | Preview Method |\n|----------|---------------|\n| Sanity | Real-time preview with `useLiveQuery` or Presentation tool |\n| Contentful | Preview API (`preview.contentful.com`) with separate access token |\n| Strapi | Draft & Publish system with `status=draft` query parameter (v5) |\n\n### Content Pillars\n\nContent pillars are the 3-5 core topics your brand will own. Each pillar spawns a cluster of related content.\n\n**Types of Shareable Content:**\n- **Thought Leadership**: Articulate concepts everyone feels but hasn't named\n- **Data-Driven Content**: Product data analysis, public data analysis, original research\n- **Expert Roundups**: 15-30 experts answering one specific question\n- **Case Studies**: Challenge → Solution → Results → Key learnings\n- **Meta Content**: Behind-the-scenes transparency\n\n## Tool Integrations\n\n### Google Search Console API\n\n**Rate Limits:**\n- 200 queries per minute\n- 1,200 requests per minute\n\n**Available Dimensions:**\n- `query` - Search query\n- `page` - Page URL\n- `country` - Country code\n- `device` - Device type (MOBILE, DESKTOP, TABLET)\n- `date` - Date\n- `searchAppearance` - Search result type\n\n**Key Metrics:**\n| Metric | Description |\n|--------|-------------|\n| `clicks` | Clicks from search |\n| `impressions` | Search impressions |\n| `ctr` | Click-through rate |\n| `position` | Average position |\n\n**Search Analytics Query Example:**\n```bash\nPOST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query\n\n{\n \"startDate\": \"2024-01-01\",\n \"endDate\": \"2024-01-31\",\n \"dimensions\": [\"country\", \"query\"],\n \"rowLimit\": 100\n}\n```\n\n### Firecrawl Tools\n\n| Tool | Purpose | Best For |\n|------|---------|----------|\n| `firecrawl_map` | Discover site structure | Initial competitor research |\n| `firecrawl_scrape` | Extract content from pages | Detailed page analysis |\n| `firecrawl_crawl` | Crawl multiple pages | Deep profiles, many pages |\n| `firecrawl_extract` | Extract structured data | Consistent data format |\n\n### DataForSEO Tools\n\n**Domain-Level Intelligence:**\n| Tool | Purpose | Key Metrics |\n|------|---------|-------------|\n| `backlinks_summary` | Domain authority overview | `domain_rank`, `total_backlinks`, `referring_domains` |\n| `backlinks_referring_domains` | Top referring domains | Per-domain rank, backlinks, domain |\n| `dataforseo_labs_google_domain_rank_overview` | Organic search overview | `organic_count`, `organic_traffic`, `organic_cost` |\n\n## Workflow Summary\n\n```mermaid\ngraph TD\n A[Competitor Research] --> B[Site Architecture Planning]\n B --> C[Content Strategy Development]\n C --> D[Programmatic SEO Implementation]\n D --> E[Schema Markup]\n E --> F[AI SEO Optimization]\n F --> G[Technical SEO Audit]\n G --> H[Content Optimization]\n H --> I[Monitoring & Iteration]\n I --> A\n \n style A fill:#9f9\n style I fill:#9f9\n```\n\n## Key Performance Indicators\n\n| KPI | Tool Source | Target Range |\n|-----|-------------|--------------|\n| Organic Traffic Growth | Google Search Console | MoM increase |\n| Keyword Rankings | Ahrefs/DataForSEO | Top 10 positions |\n| Click-Through Rate | Google Search Console | >3% |\n| Index Coverage | Google Search Console | >95% |\n| Core Web Vitals | PageSpeed Insights | Pass status |\n| AI Citation Rate | Manual tracking | Industry benchmark |\n\n## Related Skills\n\n- **Analytics** (`analytics`) - Event tracking setup and performance measurement\n- **A/B Testing** (`ab-testing`) - Experiment design for SEO optimization\n- **Copywriting** (`copywriting`) - Marketing page copy optimization\n\n---\n\n\n\n## Paid Advertising Skills\n\n### 相关页面\n\n相关主题：[SEO and Discovery Skills](#seo-discovery-skills), [Analytics and Testing Skills](#analytics-testing-skills), [Content and Copy Skills](#content-copy-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/ads/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ads/SKILL.md)\n- [skills/ad-creative/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ad-creative/SKILL.md)\n- [skills/ad-creative/references/platform-specs.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ad-creative/references/platform-specs.md)\n- [skills/ads/references/ad-copy-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ads/references/ad-copy-templates.md)\n- [tools/integrations/linkedin-ads.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/linkedin-ads.md)\n\n\n# Paid Advertising Skills\n\n## Overview\n\nThe Paid Advertising Skills module provides AI agents with specialized knowledge and workflows for managing paid advertising campaigns across multiple platforms. This skill system enables agents to create, optimize, and manage advertising campaigns with platform-specific best practices, ad copy generation, audience targeting, and conversion tracking.\n\nThe skills are designed to work together as an integrated system, with `ads` handling campaign strategy, targeting, and optimization, while `ad-creative` focuses on generating high-performing ad copy at scale. 资料来源：[skills/ads/SKILL.md:1-10]()\n\n## Architecture\n\n### Skill Components\n\n```mermaid\ngraph TD\n subgraph \"Paid Advertising System\"\n ADS[ads Campaign Strategy & Optimization]\n AD_CREATIVE[ad-creative Ad Copy Generation]\n PLATFORM_SPECS[platform-specs Platform Specifications]\n COPY_TEMPLATES[ad-copy-templates Copy Formulas]\n end\n \n subgraph \"External Integrations\"\n GOOGLE[Google Ads]\n META[Meta Ads]\n LINKEDIN[LinkedIn Ads]\n TIKTOK[TikTok Ads]\n end\n \n ADS --> AD_CREATIVE\n AD_CREATIVE --> PLATFORM_SPECS\n AD_CREATIVE --> COPY_TEMPLATES\n ADS --> GOOGLE\n ADS --> META\n ADS --> LINKEDIN\n ADS --> TIKTOK\n```\n\n### Relationship to Other Skills\n\nThe `ads` skill serves as the foundation for paid advertising operations and references other skills for complementary functionality:\n\n- **copywriting**: For landing page copy where ad traffic lands\n- **ab-testing**: For structuring creative tests with statistical rigor\n- **marketing-psychology**: For psychological principles behind high-performing creative\n- **copy-editing**: For polishing ad copy before launch\n- **analytics**: For measuring and interpreting campaign performance\n\n资料来源：[skills/ads/SKILL.md:180-195]()\n\n## Campaign Structure Best Practices\n\n### Account Organization Hierarchy\n\n```mermaid\ngraph TD\n ACCOUNT[Account] --> CAMPAIGN1[Campaign 1 Objective - Audience/Product]\n ACCOUNT --> CAMPAIGN2[Campaign 2 Objective - Audience/Product]\n \n CAMPAIGN1 --> ADSET1[Ad Set 1 Targeting Variation]\n CAMPAIGN1 --> ADSET2[Ad Set 2 Targeting Variation]\n \n ADSET1 --> AD1[Ad 1 Creative Variation A]\n ADSET1 --> AD2[Ad 2 Creative Variation B]\n ADSET1 --> AD3[Ad 3 Creative Variation C]\n \n ADSET2 --> AD4[Ad 4 Creative Variation D]\n```\n\n### Naming Conventions\n\n| Element | Format | Example |\n|---------|--------|---------|\n| Campaign | `[Platform]_[Objective]_[Audience]_[Offer]_[Date]` | `META_Conv_Lookalike-Customers_FreeTrial_2024Q1` |\n| Ad Set | `[Platform]_[Objective]_[Targeting]` | `GOOG_Search_BrandTerms` |\n| Ad | `[Platform]_[CreativeType]_[Angle]_[Variant]` | `LI_Text_Problem-Solution_A` |\n\n资料来源：[skills/ads/SKILL.md:85-110]()\n\n### Budget Allocation Strategy\n\n| Phase | Duration | Budget Split | Notes |\n|-------|----------|--------------|-------|\n| **Testing** | 2-4 weeks | 70% proven / 30% new tests | Validate hypotheses |\n| **Scaling** | Ongoing | Consolidate winners | Increase 20-30% at a time |\n\n资料来源：[skills/ads/SKILL.md:111-125]()\n\n## Ad Copy Frameworks\n\n### Primary Text Formulas\n\nThe system provides five core copywriting frameworks for generating compelling ad copy:\n\n#### 1. Problem-Agitate-Solve (PAS)\n\n```\n[Problem statement] → [Agitate the pain] → [Introduce solution] → [CTA]\n```\n\n**Example:**\n> Spending hours on manual reporting every week?\n> While you're buried in spreadsheets, your competitors are making decisions.\n> [Product] automates your reports in minutes.\n> Start your free trial →\n\n资料来源：[skills/ads/references/ad-copy-templates.md:1-20]()\n\n#### 2. Before-After-Bridge (BAB)\n\n```\n[Current painful state] → [Desired future state] → [Your product as the bridge]\n```\n\n**Example:**\n> Before: Chasing down approvals across email, Slack, and spreadsheets.\n> After: Every approval tracked, automated, and on time.\n> [Product] connects your tools and keeps projects moving.\n\n资料来源：[skills/ads/references/ad-copy-templates.md:30-40]()\n\n#### 3. Social Proof Lead\n\n```\n[Impressive stat or testimonial] → [What you do] → [CTA]\n```\n\n**Example:**\n> \"We cut our reporting time by 75%.\" — Sarah K., Marketing Director\n> [Product] automates the reports you hate building.\n> See how it works →\n\n资料来源：[skills/ads/references/ad-copy-templates.md:50-60]()\n\n#### 4. Feature-Benefit Bridge\n\nConverts product features into customer benefits by connecting what it does to why it matters.\n\n#### 5. Direct Response\n\nCreates immediate action through urgency and clear next steps.\n\n### Headline Formulas\n\n#### For Search Ads\n\nFocus on intent-matching headlines with clear value propositions.\n\n#### For Social Ads\n\nEmotionally engaging headlines designed for scroll-stopping impact.\n\n### CTA Variations\n\n| Category | Examples |\n|----------|----------|\n| **Soft CTAs** | Learn more, Discover, Explore |\n| **Hard CTAs** | Buy now, Sign up, Get started |\n| **Urgency CTAs** | Limited time, Don't miss out, Today only |\n| **Action-Oriented** | Start free trial, Book a demo, Download now |\n\n资料来源：[skills/ads/references/ad-copy-templates.md:60-90]()\n\n## Platform Specifications\n\n### Google Ads - Responsive Search Ads\n\n| Element | Character Limit | Required | Notes |\n|---------|----------------|----------|-------|\n| Headline | 30 chars | 3-15 | Any 3 may be shown together |\n| Description | 90 chars | 2-4 | Any 2 may be shown together |\n| Display Path 1 | 15 chars | Optional | Appears after domain |\n| Display Path 2 | 15 chars | Optional | Appears after path 1 |\n\n资料来源：[skills/ad-creative/references/platform-specs.md:1-25]()\n\n### Google Ads Headline Mix Recommendation (15 headlines)\n\n| Category | Count | Purpose |\n|----------|-------|---------|\n| Keyword-focused | 3-4 | Match search intent |\n| Benefit-focused | 3-4 | What they get |\n| Social proof | 2-3 | Numbers, awards, customers |\n| CTA-focused | 2-3 | Action to take |\n| Differentiators | 2-3 | Why you over competitors |\n| Brand name | 1 | Brand visibility |\n\n资料来源：[skills/ad-creative/references/platform-specs.md:26-40]()\n\n### Platform Selection Guide\n\n| Platform | Best For | Audience Characteristics |\n|----------|----------|-------------------------|\n| **Google Search** | High intent, direct response | Active problem-solvers, ready to buy |\n| **Meta (FB/IG)** | Awareness, consideration, lookalikes | Broad demographics, interest-based |\n| **LinkedIn** | B2B, professional services | Decision-makers, job titles, senior roles |\n| **TikTok** | Viral reach, younger demographics | 18-34, video-forward content |\n\n资料来源：[skills/ads/SKILL.md:50-75]()\n\n## Workflow: Pull Data, Analyze, Generate\n\n```mermaid\ngraph LR\n A[Pull Recent Ad Performance] --> B[Analyze Output Identify Winners]\n B --> C[Feed Winning Patterns Into Skill]\n C --> D[Generate New Variations]\n D --> E[Upload to Platform]\n \n subgraph \"CLI Commands\"\n A --> A1[node tools/clis/google-ads.js reports get]\n end\n```\n\n### Implementation\n\n```bash\n# 1. Pull recent ad performance\nnode tools/clis/google-ads.js reports get --type ad_performance --date-range last_30_days\n\n# 2. Analyze output (identify top/bottom performers)\n# 3. Feed winning patterns into this skill\n# 4. Generate new variations\n# 5. Upload to platform\n```\n\n资料来源：[skills/ad-creative/SKILL.md:45-65]()\n\n## Output Format Standards\n\n### Standard Output Structure\n\nOrganize output by angle with character counts:\n\n```\n## Angle: [Pain Point — Manual Reporting]\n\n### Headlines (30 char max)\n1. \"Stop Building Reports by Hand\" (29)\n2. \"Automate Your Weekly Reports\" (28)\n3. \"Reports Done in 5 Min, Not 5 Hr\" (31) <- OVER LIMIT, trimmed below\n -> \"Reports in 5 Min, Not 5 Hrs\" (27)\n\n### Descriptions (90 char max)\n1. \"Marketing teams save 5 hrs/week...\"\n```\n\n### Writing Quality Standards\n\n**Strong headlines:**\n- Specific (\"Cut reporting time 75%\") over vague (\"Save time\")\n- Benefits (\"Ship code faster\") over features (\"CI/CD pipeline\")\n- Active voice (\"Automate your reports\") over passive (\"Reports are automated\")\n- Include numbers when possible (\"3x faster,\" \"in 5 minutes,\" \"10,000+ teams\")\n\n**Avoid:**\n- Jargon the audience won't recognize\n- Claims without specificity (\"Best,\" \"Leading,\" \"Top\")\n- All caps or excessive punctuation\n- Clickbait that the landing page can't deliver on\n\n资料来源：[skills/ad-creative/SKILL.md:95-130]()\n\n## Platform Integration Reference\n\n### LinkedIn Ads\n\n#### Campaign Types\n\n| Type | Description |\n|------|-------------|\n| `SPONSORED_UPDATES` | Sponsored content in feed |\n| `TEXT_AD` | Traditional text ads |\n| `SPONSORED_INMAILS` | Message ads |\n| `DYNAMIC` | Dynamic ads with personalization |\n\n#### Key Metrics\n\n| Metric | Description |\n|--------|-------------|\n| `impressions` | Ad impressions |\n| `clicks` | Total clicks |\n| `costInLocalCurrency` | Spend |\n| `conversions` | Conversion count |\n| `leadGenerationMailContactInfoShares` | Lead form submissions |\n\n#### Targeting Options\n\n- **Job-Based**: Job titles, job functions, seniority levels, years of experience\n- **Company-Based**: Company names, industries, company size, company followers\n- **Professional**: Skills, groups, schools, degrees\n\n#### Rate Limits\n\n| Access Level | Limit |\n|--------------|-------|\n| Basic | 100 requests/day |\n| Marketing Developer Platform | 10,000 requests/day |\n\n资料来源：[tools/integrations/linkedin-ads.md:1-60]()\n\n## Usage Triggers\n\nThe ad-creative skill should be activated when users mention:\n\n- \"ad copy variations\"\n- \"ad creative\"\n- \"generate headlines\"\n- \"RSA headlines\"\n- \"bulk ad copy\"\n- \"ad iterations\"\n- \"creative testing\"\n- \"ad performance optimization\"\n- \"write me some ads\"\n- \"Facebook ad copy\"\n- \"Google ad headlines\"\n- \"LinkedIn ad text\"\n- \"I need more ad variations\"\n\nThe ads skill should be used for:\n\n- Campaign strategy\n- Targeting setup\n- Budget allocation\n- Campaign optimization\n- Platform account structure\n\n资料来源：[skills/ad-creative/SKILL.md:1-20]()\n\n## Related Documentation\n\n| Document | Purpose |\n|----------|---------|\n| `skills/ads/references/ad-copy-templates.md` | Complete copy templates and formulas |\n| `skills/ad-creative/references/platform-specs.md` | Platform-specific character limits and requirements |\n| `skills/ads/references/audience-targeting.md` | Audience targeting strategies |\n| `skills/ads/references/conversion-tracking.md` | Conversion tracking implementation |\n| `tools/integrations/linkedin-ads.md` | LinkedIn Ads API integration |\n\n---\n\n\n\n## Analytics and Testing Skills\n\n### 相关页面\n\n相关主题：[Conversion Optimization Skills](#conversion-skills), [Paid Advertising Skills](#paid-advertising-skills)\n\n\nRelevant Source Files\n\nThe following source files were used to generate this page:\n\n- [tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n- [tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)\n- [tools/integrations/optimizely.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/optimizely.md)\n- [tools/integrations/keywords-everywhere.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/keywords-everywhere.md)\n- [tools/integrations/semrush.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/semrush.md)\n- [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)\n- [tools/clis/optimizely.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/optimizely.js)\n\n\n# Analytics and Testing Skills\n\nThe Analytics and Testing Skills module provides a comprehensive framework for measuring marketing performance, understanding user behavior, and conducting systematic experimentation. These skills enable marketing teams to make data-driven decisions through proper implementation of analytics tools, A/B testing infrastructure, and conversion rate optimization workflows.\n\n## Overview\n\nThe skill system is designed to integrate with multiple analytics and testing platforms, providing standardized approaches for data collection, event tracking, and experimentation. The ecosystem supports both quantitative analytics (GA4, Google Search Console, SEMrush) and qualitative analysis (Hotjar), along with experimentation tools (Optimizely).\n\n### Supported Platforms\n\n| Category | Tools | Primary Use |\n|----------|-------|-------------|\n| Web Analytics | Google Analytics 4, Google Search Console | Traffic analysis, user behavior |\n| Heatmaps & Recordings | Hotjar | Session replay, click/scroll tracking |\n| SEO Intelligence | SEMrush, Keywords Everywhere | Keyword research, rank tracking |\n| Experimentation | Optimizely | A/B testing, feature flags |\n| CLI Tools | dub.js, optimizely.js | Command-line interface operations |\n\n## Architecture\n\n### Integration Architecture\n\nThe analytics and testing infrastructure follows a layered integration pattern where tools connect through standardized APIs and CLI interfaces.\n\n```mermaid\ngraph TD\n subgraph \"Data Collection Layer\"\n GA4[\"Google Analytics 4\"]\n GTM[\"Google Tag Manager\"]\n HOTJAR[\"Hotjar\"]\n end\n \n subgraph \"Intelligence Layer\"\n GSC[\"Google Search Console\"]\n SEMRUSH[\"SEMrush\"]\n KEYWORDS[\"Keywords Everywhere\"]\n end\n \n subgraph \"Experimentation Layer\"\n OPTIMIZELY[\"Optimizely\"]\n end\n \n subgraph \"CLI Layer\"\n DUB[\"dub.js CLI\"]\n OPTCLI[\"optimizely.js CLI\"]\n end\n \n GTM --> GA4\n GSC --> INTEL[\"Analytics Intelligence\"]\n SEMRUSH --> INTEL\n KEYWORDS --> INTEL\n OPTIMIZELY --> EXP[\"Experimentation Engine\"]\n \n DUB --> DASH[\"Dashboard / Reports\"]\n OPTCLI --> EXP\n```\n\n资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n资料来源：[tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)\n\n## Google Analytics 4 Integration\n\nGoogle Analytics 4 provides the foundation for web analytics implementation, offering event-based tracking with enhanced measurement capabilities.\n\n### Implementation Pattern\n\nThe GA4 implementation follows a structured approach with proper configuration of measurement protocols and event schemas. Implementation documentation specifies standard event categories and parameters for consistent data collection across marketing touchpoints.\n\n### Event Tracking\n\nGA4 supports custom event tracking with parameters for:\n\n- **User Properties**: Demographic and behavioral attributes\n- **Event Parameters**: Contextual data about user actions\n- **Items**: Product and inventory information for e-commerce\n\n资料来源：[skills/analytics/references/ga4-implementation.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/ga4-implementation.md)\n\n## Google Tag Manager Implementation\n\nGoogle Tag Manager serves as the tag management system for implementing analytics and marketing tags without direct code deployment.\n\n### Container Structure\n\n```mermaid\ngraph TD\n GTM[\"GTM Container\"] --> TRIGGERS[\"Triggers\"]\n GTM --> TAGS[\"Tags\"]\n GTM --> VARIABLES[\"Variables\"]\n \n TRIGGERS --> PAGEVIEW[\"Pageview Trigger\"]\n TRIGGERS --> CLICK[\"Click Trigger\"]\n TRIGGERS --> CUSTOM[\"Custom Event\"]\n \n TAGS --> GA4TAG[\"GA4 Tag\"]\n TAGS --> ADWORDS[\"Google Ads Tag\"]\n TAGS --> CUSTOMTAG[\"Custom HTML\"]\n \n VARIABLES --> DOM[\"DOM Variables\"]\n VARIABLES --> DATA[\"Data Layer\"]\n VARIABLES --> CONST[\"Constants\"]\n```\n\n资料来源：[skills/analytics/references/gtm-implementation.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/gtm-implementation.md)\n\n## Event Library\n\nThe event library defines a standardized vocabulary for tracking user interactions across marketing properties.\n\n### Standard Event Categories\n\n| Category | Events | Purpose |\n|----------|--------|---------|\n| Page | `page_view`, `page_exit` | Navigation analysis |\n| Engagement | `scroll`, `click`, `video_*` | User interaction tracking |\n| Conversion | `purchase`, `sign_up`, `lead` | Goal completion |\n| Commerce | `view_item`, `add_to_cart`, `checkout` | E-commerce tracking |\n| Search | `search`, `refine_search` | Site search analysis |\n\n### Event Schema\n\nEach event follows a consistent schema structure:\n\n```\nevent_name\n├── timestamp\n├── user_id (if authenticated)\n├── session_id\n├── page_location\n├── page_referrer\n└── event_parameters (custom)\n```\n\n资料来源：[skills/analytics/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/event-library.md)\n\n## A/B Testing Framework\n\nThe A/B testing module provides infrastructure for systematic experimentation to optimize conversion rates and user experience.\n\n### Research Process\n\n```mermaid\ngraph TD\n START[\"Hypothesis Formation\"] --> DESIGN[\"Test Design\"]\n DESIGN --> SAMPLE[\"Sample Size Calculation\"]\n SAMPLE --> IMPLEMENT[\"Implement Variations\"]\n IMPLEMENT --> LAUNCH[\"Launch Test\"]\n LAUNCH --> MONITOR[\"Monitor Results\"]\n MONITOR --> ANALYZE[\"Statistical Analysis\"]\n ANALYZE --> DECISION[\"Winner Declaration\"]\n DECISION --> ITERATE[\"Iterate\"]\n```\n\n资料来源：[skills/ab-testing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/SKILL.md)\n\n### Sample Size Determination\n\nProper sample size calculation ensures statistical validity of test results.\n\n| Factor | Impact | Consideration |\n|--------|--------|---------------|\n| Baseline Conversion | Determines effect size | Historical data required |\n| Minimum Detectable Effect | Smaller effects need larger samples | Business context dependent |\n| Statistical Power | Typically 80% | Affects Type II error rate |\n| Significance Level | Typically 95% | Affects Type I error rate |\n\n资料来源：[skills/ab-testing/references/sample-size-guide.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/references/sample-size-guide.md)\n\n### Test Templates\n\nStandardized templates accelerate test implementation:\n\n```mermaid\ngraph LR\n A[Control] -->|Original| B[Baseline Metrics]\n C[Variation A] -->|Treatment| D[Variant Metrics]\n E[Variation B] -->|Treatment| D\n D --> F{Compare}\n F -->|Significant| G[Declare Winner]\n F -->|Not Significant| H[Extend Test]\n```\n\n资料来源：[skills/ab-testing/references/test-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/references/test-templates.md)\n\n## Optimizely Integration\n\nOptimizely provides enterprise experimentation capabilities including A/B testing, feature flags, and personalization.\n\n### API Capabilities\n\n| Endpoint | Purpose | Parameters |\n|----------|---------|------------|\n| `projects.list` | List experimentation projects | `page`, `per_page` |\n| `experiments.list` | List experiments in project | `project_id`, `status` |\n| `experiments.create` | Create new experiment | `name`, `variations`, `metrics` |\n| `results.get` | Retrieve experiment results | `experiment_id`, `start_time`, `end_time` |\n\n### Rate Limits\n\n- **50 requests/second** per personal token\n- Pagination via `page` and `per_page` parameters\n- OpenAPI specification available at `https://api.optimizely.com/v2/swagger.json`\n\n### CLI Commands\n\nThe Optimizely CLI provides command-line access to experimentation features:\n\n```bash\n# List projects\noptimizely projects list\n\n# List experiments\noptimizely experiments list --project-id \n\n# List pages\noptimizely pages list --project-id \n\n# List options with pagination\noptimizely options --page --per-page --status \n```\n\n资料来源：[tools/integrations/optimizely.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/optimizely.md)\n资料来源：[tools/clis/optimizely.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/optimizely.js)\n\n## Google Search Console Integration\n\nGoogle Search Console provides organic search performance data essential for SEO analytics.\n\n### API Operations\n\n| Operation | Endpoint | Purpose |\n|-----------|----------|---------|\n| Query Analysis | `searchAnalytics.query` | Search performance data |\n| URL Inspection | `urlInspection.index:inspect` | Index status check |\n| Sitemap Management | `sites/{siteUrl}/sitemaps` | Sitemap submission |\n| Index Request | `urlNotifications:publish` | Request indexing |\n\n### Dimensions and Metrics\n\n**Available Dimensions:**\n\n- `query` — Search query\n- `page` — Page URL\n- `country` — Country code\n- `device` — Device type (MOBILE, DESKTOP, TABLET)\n- `date` — Date\n- `searchAppearance` — Search result type\n\n**Metrics:**\n\n| Metric | Description |\n|--------|-------------|\n| `clicks` | Clicks from search results |\n| `impressions` | Search impressions |\n| `ctr` | Click-through rate |\n| `position` | Average search position |\n\n### Rate Limits\n\n- **200 queries per minute**\n- **1,200 requests per minute**\n\n### Query Example\n\n```bash\nPOST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query\n\n{\n \"startDate\": \"2024-01-01\",\n \"endDate\": \"2024-01-31\",\n \"dimensions\": [\"country\", \"query\"],\n \"rowLimit\": 100\n}\n```\n\n### Filter Configuration\n\n```json\n{\n \"dimensionFilterGroups\": [{\n \"filters\": [{\n \"dimension\": \"query\",\n \"operator\": \"contains\",\n \"expression\": \"keyword\"\n }]\n }]\n}\n```\n\n资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n\n## Hotjar Integration\n\nHotjar provides qualitative analytics through heatmaps, session recordings, and user surveys.\n\n### Data Types\n\n#### Heatmap Data\n\n| Field | Description |\n|-------|-------------|\n| `url` | Page URL |\n| `click_count` | Total clicks tracked |\n| `visitors` | Unique visitors |\n| `created_at` | Heatmap creation date |\n\n#### Recording Data\n\n| Field | Description |\n|-------|-------------|\n| `recording_id` | Unique recording identifier |\n| `duration` | Session duration |\n| `pages_visited` | Pages in session |\n| `device` | Device information |\n\n### API Parameters\n\n**Survey Responses:**\n\n| Parameter | Description |\n|-----------|-------------|\n| `limit` | Results per page (default: 100) |\n| `cursor` | Pagination cursor |\n| `sort` | Sort order (default: created_at desc) |\n\n**Recordings:**\n\n| Parameter | Description |\n|-----------|-------------|\n| `limit` | Results per page |\n| `cursor` | Pagination cursor |\n| `date_from` | Start date filter |\n| `date_to` | End date filter |\n\n### Rate Limits\n\n- **3,000 requests/minute** (50 per second)\n- Rate limited by source IP address\n- Cursor-based pagination for large result sets\n\n### Use Cases\n\n- Analyzing user behavior patterns on landing pages\n- Collecting qualitative feedback via on-site surveys\n- Identifying UX issues through session recordings\n- Understanding scroll depth and engagement via heatmaps\n- Validating CRO hypotheses with user behavior data\n- Form abandonment analysis\n\n资料来源：[tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)\n\n## SEO Analytics Tools\n\n### SEMrush Integration\n\nSEMrush provides comprehensive SEO intelligence including keyword research, competitive analysis, and backlink monitoring.\n\n#### Export Columns\n\n| Report Type | Key Columns |\n|-------------|-------------|\n| **Domain Report** | `Db`, `Dn`, `Rk`, `Or`, `Ot`, `Oc` |\n| **Keyword Report** | `Ph`, `Nq`, `Cp`, `Co`, `Kd`, `Nr` |\n| **Backlinks** | `source_url`, `target_url`, `anchor`, `source_title` |\n\n#### Database Coverage\n\nCountry codes supported: `us`, `uk`, `de`, `fr`, `ca`, `au`, and others.\n\n#### Rate Limits\n\n- Varies by plan (10-30K units/day)\n- Each API call consumes units\n\n资料来源：[tools/integrations/semrush.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/semrush.md)\n\n### Keywords Everywhere\n\nKeywords Everywhere provides keyword data including search volume, CPC, and competition scores.\n\n#### Key Metrics\n\n| Metric | Description |\n|--------|-------------|\n| `search_volume` | Monthly search volume |\n| `cpc.value` | Cost per click |\n| `competition` | Competition score |\n| `trend` | 12-month trend data |\n| `estimated_traffic` | Estimated monthly traffic |\n| `keywords_count` | Number of ranking keywords |\n\n#### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| `country` | Country code (us, uk, de, fr, etc.) |\n| `currency` | Currency code (USD, GBP, EUR, etc.) |\n| `dataSource` | Data source (default: `gkp` for Google Keyword Planner) |\n| `kw` | Array of keywords (max 100 per request) |\n\n#### Rate Limits\n\n- **100 keywords per request**\n- Credit-based pricing (1 credit per keyword)\n\n资料来源：[tools/integrations/keywords-everywhere.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/keywords-everywhere.md)\n\n## Workflow Integration\n\n### Analytics Workflow\n\n```mermaid\ngraph TD\n subgraph \"Collection\"\n WEB[\"Web Analytics\"]\n GSC[\"Search Console\"]\n SEO[\"SEO Tools\"]\n end\n \n subgraph \"Analysis\"\n PERFORMANCE[\"Performance Review\"]\n SEGMENT[\"Segmentation\"]\n FUNNEL[\"Funnel Analysis\"]\n end\n \n subgraph \"Optimization\"\n TEST[\"A/B Testing\"]\n PRIORITIZE[\"Prioritization\"]\n IMPLEMENT[\"Implementation\"]\n end\n \n WEB --> PERFORMANCE\n GSC --> PERFORMANCE\n SEO --> SEGMENT\n SEGMENT --> FUNNEL\n FUNNEL --> TEST\n TEST --> PRIORITIZE\n PRIORITIZE --> IMPLEMENT\n IMPLEMENT --> WEB\n```\n\n### Testing Workflow\n\n```mermaid\ngraph LR\n A[Idea] --> B[Hypothesis]\n B --> C[Test Design]\n C --> D[Build]\n D --> E[QA]\n E --> F[Launch]\n F --> G[Monitor]\n G --> H[Analysis]\n H --> I[Decision]\n I --> J[Ship Winner]\n J --> K[Archive]\n I --> L[Iterate]\n L --> C\n```\n\n## Related Skills\n\n| Skill | Relationship |\n|-------|--------------|\n| **CRO** | Conversion Rate Optimization leverages analytics for improvement identification |\n| **SEO Audit** | Uses Google Search Console and SEMrush data for technical analysis |\n| **Landing Page** | A/B testing targets for landing page optimization |\n| **Personalization** | User behavior data drives personalization rules |\n| **UX Audit** | Hotjar data informs UX improvement recommendations |\n| **Programmatic SEO** | Analytics data guides programmatic content strategy |\n\n## Best Practices\n\n### Data Quality\n\n1. Implement consistent event naming conventions\n2. Validate tracking across all platforms before launch\n3. Document custom dimensions and metrics\n4. Regular audit of data collection implementation\n\n### Experimentation\n\n1. Calculate sample size before launching tests\n2. Avoid peeking at results before statistical significance\n3. Document hypotheses and success criteria\n4. Test one variable per experiment when possible\n\n### Integration\n\n1. Use standardized API schemas across tools\n2. Implement proper rate limit handling\n3. Configure webhooks for real-time updates where available\n4. Maintain API key security and rotation policies\n\n## Tool Reference Summary\n\n| Tool | Primary Function | Rate Limit |\n|------|------------------|------------|\n| Google Analytics 4 | Web analytics | Platform dependent |\n| Google Search Console | Search performance | 200 queries/min |\n| Hotjar | Qualitative analysis | 3000 requests/min |\n| Optimizely | Experimentation | 50 requests/sec |\n| SEMrush | SEO intelligence | 10-30K units/day |\n| Keywords Everywhere | Keyword research | 100 keywords/request |\n\n## File Structure\n\n```\ntools/\n├── integrations/\n│ ├── google-search-console.md\n│ ├── hotjar.md\n│ ├── optimizely.md\n│ ├── semrush.md\n│ └── keywords-everywhere.md\n└── clis/\n ├── dub.js\n └── optimizely.js\n\nskills/\n├── analytics/\n│ ├── SKILL.md\n│ └── references/\n│ ├── ga4-implementation.md\n│ ├── gtm-implementation.md\n│ └── event-library.md\n└── ab-testing/\n ├── SKILL.md\n └── references/\n ├── sample-size-guide.md\n └── test-templates.md\n\n---\n\n\n\n## Retention and Growth Skills\n\n### 相关页面\n\n相关主题：[Conversion Optimization Skills](#conversion-skills), [Sales and RevOps Skills](#sales-revops-skills), [Content and Copy Skills](#content-copy-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/churn-prevention/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/SKILL.md)\n- [skills/churn-prevention/references/cancel-flow-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/references/cancel-flow-patterns.md)\n- [skills/churn-prevention/references/dunning-playbook.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/references/dunning-playbook.md)\n- [skills/referrals/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/referrals/SKILL.md)\n- [skills/referrals/references/program-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/referrals/references/program-examples.md)\n- [skills/co-marketing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/co-marketing/SKILL.md)\n- [skills/free-tools/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/free-tools/SKILL.md)\n- [skills/lead-magnets/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/lead-magnets/SKILL.md)\n- [skills/lead-magnets/references/benchmarks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/lead-magnets/references/benchmarks.md)\n- [skills/community-marketing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/community-marketing/SKILL.md)\n\n\n# Retention and Growth Skills\n\n## Overview\n\nRetention and Growth Skills constitute a specialized category within the Marketing Skills framework designed to help AI agents assist with customer retention, revenue recovery, and sustainable business growth strategies. These skills focus on preventing churn, maximizing customer lifetime value, and expanding revenue through referral programs, co-marketing partnerships, and lead generation tactics.\n\nThe skills in this category work together to create a comprehensive customer lifecycle management approach:\n\n```mermaid\ngraph TD\n A[Customer Lifecycle] --> B[Retention]\n A --> C[Growth]\n B --> D[Churn Prevention]\n B --> E[Dunning & Recovery]\n C --> F[Referral Programs]\n C --> G[Lead Magnets]\n C --> H[Co-Marketing]\n C --> I[Free Tools]\n C --> J[Community Marketing]\n \n D --> K[Cancel Flow Patterns]\n E --> L[Payment Recovery]\n F --> M[Viral Growth]\n G --> N[Lead Capture]\n H --> O[Partnership Expansion]\n I --> P[Tool-Led Acquisition]\n J --> Q[Community Engagement]\n```\n\n## Skill Categories\n\n| Skill | Primary Focus | Key Outcomes |\n|-------|--------------|---------------|\n| `churn-prevention` | Customer retention & cancellation prevention | Reduce churn rate, recover at-risk customers |\n| `referrals` | Word-of-mouth and viral growth | Acquire customers through existing user networks |\n| `lead-magnets` | Lead capture and qualification | Generate qualified leads with valuable content |\n| `co-marketing` | Strategic partnerships | Expand reach through joint marketing efforts |\n| `free-tools` | Tool-led acquisition | Attract users with free utility offerings |\n| `community-marketing` | Community-driven growth | Build engaged user communities for organic growth |\n\n## Churn Prevention Skill\n\nThe `churn-prevention` skill enables agents to help businesses reduce customer attrition through proactive intervention and strategic retention offers. It encompasses two key reference modules: cancel flow patterns and dunning playbooks.\n\n### Purpose and Scope\n\nChurn prevention focuses on identifying at-risk customers before they cancel and implementing recovery strategies during the cancellation process. The skill provides guidance on creating effective save flows, timing interventions, and crafting compelling retention offers.\n\n### Cancel Flow Patterns\n\nThe cancel flow patterns module provides structured approaches to handling customer cancellation requests. It emphasizes understanding the customer's reason for leaving and offering appropriate alternatives.\n\n**Key Components:**\n\n1. **Exit Survey Integration** - Collect cancellation reasons to inform product improvements\n2. **Save Offer Tiers** - Provide escalating offers based on customer value\n3. **Pause Options** - Offer temporary suspension instead of cancellation\n4. **Downgrade Paths** - Allow migration to lower-tier plans\n\n```mermaid\ngraph TD\n A[Cancel Request] --> B[Exit Survey]\n B --> C{Reason Analysis}\n C -->|Price| D[Discount Offer]\n C -->|Value| E[Feature Highlight]\n C -->|Usage| F[Onboarding Help]\n C -->|Competitor| G[Competitive Analysis]\n C -->|Other| H[General Retention]\n \n D --> I[Save Flow]\n E --> I\n F --> I\n G --> I\n H --> I\n \n I --> J{Save Success?}\n J -->|Yes| K[Retained Customer]\n J -->|No| L[Grace Period Offer]\n L --> M[Final Save]\n M -->|No| N[Cancellation Complete]\n```\n\n资料来源：[skills/churn-prevention/references/cancel-flow-patterns.md]()\n\n### Dunning Playbook\n\nThe dunning module addresses failed payments and subscription recovery. It provides strategies for communicating payment failures, retry timing, and customer-friendly recovery processes.\n\n**Dunning Communication Strategy:**\n\n| Stage | Timing | Focus | Channels |\n|-------|--------|-------|----------|\n| First Notice | Day 1 | Gentle reminder | Email |\n| Second Notice | Day 3-5 | Urgent but helpful | Email + SMS |\n| Third Notice | Day 7-10 | Final warning | Email + SMS + Call |\n| Grace Period | Day 14-21 | Last chance | Email + Personal outreach |\n\n**Best Practices:**\n\n- Use friendly, non-threatening language\n- Clearly explain the issue and resolution steps\n- Offer multiple payment method updates\n- Include one-click payment update links\n- Provide clear timeline of consequences\n\n资料来源：[skills/churn-prevention/references/dunning-playbook.md]()\n\n## Referrals Skill\n\nThe `referrals` skill helps agents design and optimize referral marketing programs that leverage existing customers to acquire new ones. Referral programs are among the most cost-effective acquisition channels when properly structured.\n\n### Program Structure\n\nA referral program typically consists of four key elements:\n\n```mermaid\ngraph LR\n A[Referrer] -->|Makes Referral| B[Referral Program]\n B --> C{Eligibility Check}\n C -->|Qualified| D[Reward Triggered]\n C -->|Not Qualified| E[No Reward]\n D --> F[Referral Becomes Customer]\n F -->|Cycle| A\n \n style A fill:#bbf\n style F fill:#bbf\n style D fill:#dfd\n```\n\n### Program Examples\n\nThe program examples reference provides real-world templates for different referral scenarios:\n\n**Standard Referral:**\n- Referrer receives reward when referee completes purchase\n- Reward can be fixed amount, percentage, or credit\n- Suitable for e-commerce and SaaS businesses\n\n**Tiered Referral:**\n- Rewards increase with number of successful referrals\n- Encourages repeated advocacy\n- Example: Dropbox's early referral program\n\n**Viral Referral:**\n- Double-sided rewards (both parties get benefit)\n- Built-in sharing mechanics\n- Example: Uber's referral system\n\n**Milestone-Based Referral:**\n- Rewards at specific referral thresholds\n- Creates achievement motivation\n- Example: Referral milestones at 5, 10, 25 referrals\n\n| Program Type | Best For | Reward Structure | Key Metric |\n|--------------|----------|------------------|------------|\n| Standard | B2C e-commerce | Fixed discount | Conversion rate |\n| Double-sided | Growth stage SaaS | Equal reward both parties | Viral coefficient |\n| Tiered | Enterprise | Increasing rewards | Referrals per user |\n| Milestone | Gamified experience | Badge + reward | Engagement rate |\n\n资料来源：[skills/referrals/references/program-examples.md]()\n\n## Lead Magnets Skill\n\nThe `lead-magnets` skill enables agents to create effective lead capture mechanisms that provide value to prospects while qualifying them for sales follow-up.\n\n### Purpose and Strategy\n\nLead magnets are valuable content or tools offered in exchange for contact information. They serve as the bridge between top-of-funnel awareness and qualified lead conversion.\n\n**Common Lead Magnet Formats:**\n\n| Format | Example | Best For | Effort |\n|--------|---------|----------|--------|\n| Ebook/Guide | Industry report | Thought leadership | Medium |\n| Checklist | Launch checklist | Action-oriented buyers | Low |\n| Template | Email sequence template | DIY marketers | Medium |\n| Tool | ROI calculator | High-intent prospects | High |\n| Webinar | Training session | Engagement nurturing | Medium |\n| Free Trial | Product access | Product-qualified leads | High |\n\n### Lead Magnet Benchmarks\n\nThe benchmarks reference provides performance metrics for optimizing lead magnet effectiveness:\n\n**Conversion Benchmarks by Type:**\n\n- **Email signup forms**: 1-3% average conversion\n- **Lead magnets**: 10-20% conversion from visitor to lead\n- **Gated content**: 2-5% of website visitors\n- **Exit-intent popups**: 1-2% conversion\n\n**Best Practices:**\n\n1. Match lead magnet format to audience preference\n2. Create specific, actionable content over generic\n3. Use clear, benefit-driven headlines\n4. Optimize form fields (minimize friction)\n5. Implement progressive profiling for returning visitors\n\n资料来源：[skills/lead-magnets/references/benchmarks.md]()\n\n## Co-Marketing Skill\n\nThe `co-marketing` skill facilitates partnership-driven growth through joint marketing initiatives with complementary businesses.\n\n### Partnership Types\n\n| Type | Description | Example |\n|------|-------------|---------|\n| Content Co-creation | Joint blog posts, webinars, studies | Tech company + Analytics firm |\n| Event Co-marketing | Shared virtual summits, workshops | Industry associations |\n| Product Integration | Embedded referrals, shared tools | SaaS integrations |\n| Promotion Exchange | Cross-promotional campaigns | Complementary products |\n| Research Collaboration | Joint surveys, industry reports | Think tanks + Companies |\n\n### Implementation Checklist\n\n- Define mutual goals and success metrics\n- Establish clear value exchange\n- Create joint content calendar\n- Set up attribution tracking\n- Agree on lead sharing process\n\n资料来源：[skills/co-marketing/SKILL.md]()\n\n## Free Tools Skill\n\nThe `free-tools` skill focuses on tool-led acquisition strategies where valuable free utilities attract and convert potential customers.\n\n### Strategy Overview\n\nFree tools leverage the \"foot-in-the-door\" technique by providing immediate value that builds trust and demonstrates product capability.\n\n**Tool Categories:**\n\n| Category | Example | Conversion Mechanism |\n|----------|---------|---------------------|\n| Calculators | ROI, savings, estimates | Results-based upsell |\n| Generators | Logo, copy, images | Output requires paid features |\n| Analyzers | SEO, website, social | Recommendations link to paid |\n| Templates | Documents, spreadsheets | Premium versions available |\n| Checklists | Pre-flight, audit tools | Upgrade to full version |\n\n资料来源：[skills/free-tools/SKILL.md]()\n\n## Community Marketing Skill\n\nThe `community-marketing` skill helps build and leverage user communities for organic growth and customer retention.\n\n### Community Strategy\n\n**Community Building Framework:**\n\n```mermaid\ngraph TD\n A[Community Goal] --> B[Platform Selection]\n A --> C[Content Strategy]\n A --> D[Engagement Plan]\n \n B --> E[Slack/Discord/Facebook Groups]\n B --> F[Forum/Reddit]\n B --> G[Customer Community]\n \n C --> H[User-Generated Content]\n C --> I[AMAs and Q&A Sessions]\n C --> J[Knowledge Sharing]\n \n D --> K[Recognition Programs]\n D --> L[Exclusive Access]\n D --> M[Feedback Loops]\n \n H --> N[Brand Advocacy]\n I --> N\n J --> N\n K --> N\n L --> N\n M --> N\n```\n\n**Benefits of Community Marketing:**\n\n- Reduced support costs through peer-to-peer help\n- Increased customer retention through belonging\n- Valuable user feedback and feature ideas\n- Organic word-of-mouth promotion\n- Brand loyalty and advocacy\n\n**Platform Options:**\n\n| Platform | Best For | Features |\n|----------|----------|----------|\n| Slack | B2B SaaS | Channels, integrations |\n| Discord | Developers/Gamers | Voice, roles, bots |\n| Facebook Groups | Broad audiences | Native social features |\n| Circle | Content creators | Courses, memberships |\n\n资料来源：[skills/community-marketing/SKILL.md]()\n\n## Implementation Guidelines\n\n### Skill Selection Matrix\n\n| Business Goal | Primary Skill | Supporting Skills |\n|---------------|---------------|-------------------|\n| Reduce churn | `churn-prevention` | `community-marketing` |\n| Lower CAC | `referrals` | `lead-magnets` |\n| Lead volume | `lead-magnets` | `free-tools` |\n| Market expansion | `co-marketing` | `referrals` |\n| Product adoption | `free-tools` | `community-marketing` |\n\n### Integration Patterns\n\n```mermaid\ngraph LR\n subgraph \"Top of Funnel\"\n A[Free Tools]\n B[Lead Magnets]\n C[Co-Marketing]\n end\n \n subgraph \"Middle of Funnel\"\n D[Community Marketing]\n E[Lead Nurturing]\n end\n \n subgraph \"Bottom of Funnel\"\n F[Churn Prevention]\n G[Referrals]\n end\n \n A --> D\n B --> D\n C --> D\n D --> F\n F --> G\n G --> A\n```\n\n## Trigger Phrases for Agent Invocation\n\nThe following phrases indicate a user needs retention and growth skill assistance:\n\n| Skill | Trigger Phrases |\n|-------|-----------------|\n| Churn Prevention | \"reduce churn\", \"customer leaving\", \"canceling subscription\", \"failed payment\" |\n| Referrals | \"referral program\", \"word of mouth\", \"customer recommendations\", \"viral growth\" |\n| Lead Magnets | \"lead generation\", \"capture leads\", \"content upgrade\", \"gated content\" |\n| Co-Marketing | \"partnership\", \"joint marketing\", \"co-branded\", \"strategic alliance\" |\n| Free Tools | \"free tool\", \"calculator\", \"generator\", \"free utility\" |\n| Community | \"build community\", \"user community\", \"customer engagement\", \"brand advocates\" |\n\n## Related Skills\n\n- **CRO Skill** - Works with churn prevention for conversion optimization\n- **Analytics Skill** - Provides metrics tracking for all retention initiatives\n- **Emails Skill** - Supports communication for dunning and save flows\n- **Copywriting Skill** - Crafts compelling referral messages and offers\n\n---\n\n\n\n## Sales and RevOps Skills\n\n### 相关页面\n\n相关主题：[Retention and Growth Skills](#retention-growth-skills), [Content and Copy Skills](#content-copy-skills)\n\nThe source files for Sales and RevOps Skills are not included in the provided context. To generate this wiki page, I would need the following files:\n\n- `skills/revops/SKILL.md`\n- `skills/revops/references/lifecycle-definitions.md`\n- `skills/revops/references/scoring-models.md`\n- `skills/revops/references/routing-rules.md`\n- `skills/revops/references/automation-playbooks.md`\n- `skills/sales-enablement/SKILL.md`\n- `skills/sales-enablement/references/deck-frameworks.md`\n- `skills/sales-enablement/references/objection-library.md`\n- `skills/sales-enablement/references/demo-scripts.md`\n\n**Available context includes:** `README.md`, `AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING.md`, various skills under `skills/site-architecture/`, `skills/competitor-profiling/`, `skills/ai-seo/`, `skills/content-strategy/`, `skills/schema/`, and tools under `tools/integrations/` and `tools/clis/`.\n\nPlease provide the Sales and RevOps source files to generate the wiki page.\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：coreyhaines31/marketingskills\n\n摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令：`npx skills`\n- 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n\n## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 7. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n\n## 8. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\n\n## 9. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing\n\n## 10. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.\n\n## 12. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。\n\n## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。\n\n## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。\n\n## 18. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown\n\n## 19. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | release_recency=unknown\n\n\n",
"markdown_key": "marketingskills",
"pages": "draft",
"source_refs": [
{
"evidence_id": "github_repo:1135212071",
"kind": "repo",
"supports_claim_ids": [
"claim_identity",
"claim_distribution",
"claim_capability"
],
"url": "https://github.com/coreyhaines31/marketingskills"
},
{
"evidence_id": "art_d9af7090892945088ff3f7c4a813376e",
"kind": "docs",
"supports_claim_ids": [
"claim_identity",
"claim_distribution",
"claim_capability"
],
"url": "https://github.com/coreyhaines31/marketingskills#readme"
}
],
"summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
"title": "marketingskills 说明书",
"toc": [
"https://github.com/coreyhaines31/marketingskills 项目说明书",
"目录",
"Home",
"Overview",
"Repository Structure",
"Skills Categories",
"Skill Structure",
"Your Skill Name",
"Doramagic 踩坑日志"
]
}
},
"quality_gate": {
"blocking_gaps": [],
"category_confidence": "medium",
"compile_status": "ready_for_review",
"five_assets_present": true,
"install_sandbox_verified": true,
"missing_evidence": [],
"next_action": "publish to Doramagic.ai project surfaces",
"prompt_preview_boundary_ok": true,
"publish_status": "publishable",
"quick_start_verified": true,
"repo_clone_verified": true,
"repo_commit": "bd8eb1a0e5a82379537298c0570e85279ca27337",
"repo_inspection_error": null,
"repo_inspection_files": [
"README.md"
],
"repo_inspection_verified": true,
"review_reasons": [],
"tag_count_ok": true,
"unsupported_claims": []
},
"schema_version": "0.1",
"user_assets": {
"ai_context_pack": {
"asset_id": "ai_context_pack",
"filename": "AI_CONTEXT_PACK.md",
"markdown": "# marketingskills - Doramagic AI Context Pack\n\n> 定位：安装前体验与判断资产。它帮助宿主 AI 有一个好的开始，但不代表已经安装、执行或验证目标项目。\n\n## 充分原则\n\n- **充分原则，不是压缩原则**：AI Context Pack 应该充分到让宿主 AI 在开工前理解项目价值、能力边界、使用入口、风险和证据来源；它可以分层组织，但不以最短摘要为目标。\n- **压缩策略**：只压缩噪声和重复内容，不压缩会影响判断和开工质量的上下文。\n\n## 给宿主 AI 的使用方式\n\n你正在读取 Doramagic 为 marketingskills 编译的 AI Context Pack。请把它当作开工前上下文：帮助用户理解适合谁、能做什么、如何开始、哪些必须安装后验证、风险在哪里。不要声称你已经安装、运行或执行了目标项目。\n\n## Claim 消费规则\n\n- **事实来源**：Repo Evidence + Claim/Evidence Graph；Human Wiki 只提供显著性、术语和叙事结构。\n- **事实最低状态**：`supported`\n- `supported`：可以作为项目事实使用，但回答中必须引用 claim_id 和证据路径。\n- `weak`：只能作为低置信度线索，必须要求用户继续核实。\n- `inferred`：只能用于风险提示或待确认问题，不能包装成项目事实。\n- `unverified`：不得作为事实使用，应明确说证据不足。\n- `contradicted`：必须展示冲突来源，不得替用户强行选择一个版本。\n\n## 它最适合谁\n\n- **正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**：README 或插件配置提到多个宿主 AI。 证据：`README.md` Claim：`clm_0004` supported 0.86\n- **希望把专业流程带进宿主 AI 的用户**：仓库包含 Skill 文档。 证据：`skills/ab-testing/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ads/SKILL.md`, `skills/ai-seo/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n\n## 它能做什么\n\n- **AI Skill / Agent 指令资产库**（可做安装前预览）：项目包含可被宿主 AI 读取的 Skill 或 Agent 指令文件，可用于把专业流程带入 Claude、Codex、Cursor 等宿主。 证据：`skills/ab-testing/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ads/SKILL.md`, `skills/ai-seo/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**（需要安装后验证）：项目包含插件或 marketplace 配置，说明它面向一个或多个 AI 宿主的安装和分发。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **命令行启动或安装流程**（需要安装后验证）：项目文档中存在可执行命令，真实使用需要在本地或宿主环境中运行这些命令。 证据：`README.md` Claim：`clm_0003` supported 0.86\n\n## 怎么开始\n\n- `npx skills add coreyhaines31/marketingskills` 证据：`README.md` Claim：`clm_0006` supported 0.86, `clm_0007` supported 0.86, `clm_0008` supported 0.86\n- `npx skills add coreyhaines31/marketingskills --skill cro copywriting` 证据：`README.md` Claim：`clm_0007` supported 0.86\n- `npx skills add coreyhaines31/marketingskills --list` 证据：`README.md` Claim：`clm_0008` supported 0.86\n- `/plugin marketplace add coreyhaines31/marketingskills` 证据：`README.md` Claim：`clm_0009` supported 0.86\n- `/plugin install marketing-skills` 证据：`README.md` Claim：`clm_0010` supported 0.86\n- `git clone https://github.com/coreyhaines31/marketingskills.git` 证据：`README.md` Claim：`clm_0011` supported 0.86\n- `npx skillkit install coreyhaines31/marketingskills` 证据：`README.md` Claim：`clm_0012` supported 0.86, `clm_0013` supported 0.86, `clm_0014` supported 0.86\n- `npx skillkit install coreyhaines31/marketingskills --skill cro copywriting` 证据：`README.md` Claim：`clm_0013` supported 0.86\n- `npx skillkit install coreyhaines31/marketingskills --list` 证据：`README.md` Claim：`clm_0014` supported 0.86\n\n## 继续前判断卡\n\n- **当前建议**：先做研究框架试用\n- **为什么**：这个项目面向研究工作流，核心风险是资料可信度和输出质量；先用 Prompt Preview 验证研究框架，再在隔离环境试装。\n\n### 30 秒判断\n\n- **现在怎么做**：先做研究框架试用\n- **最小安全下一步**：先用 Prompt Preview 验证研究框架；满意后再隔离试装\n- **先别相信**：研究结论、引用和实验结果不能在安装前相信。\n- **继续会触碰**：研究判断、命令执行、宿主 AI 配置\n\n### 现在可以相信\n\n- **适合人群线索：正在使用 Claude/Codex/Cursor/Gemini 等宿主 AI 的开发者**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`README.md` Claim：`clm_0004` supported 0.86\n- **适合人群线索：希望把专业流程带进宿主 AI 的用户**（supported）：有 supported claim 或项目证据支撑，但仍不等于真实安装效果。 证据：`skills/ab-testing/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ads/SKILL.md`, `skills/ai-seo/SKILL.md` 等 Claim：`clm_0005` supported 0.86\n- **能力存在：AI Skill / Agent 指令资产库**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`skills/ab-testing/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ads/SKILL.md`, `skills/ai-seo/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **能力存在：多宿主安装与分发**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **能力存在：命令行启动或安装流程**（supported）：可以相信项目包含这类能力线索；是否适合你的具体任务仍要试用或安装后验证。 证据：`README.md` Claim：`clm_0003` supported 0.86\n- **存在 Quick Start / 安装命令线索**（supported）：可以相信项目文档出现过启动或安装入口；不要因此直接在主力环境运行。 证据：`README.md` Claim：`clm_0006` supported 0.86, `clm_0007` supported 0.86, `clm_0008` supported 0.86\n\n### 现在还不能相信\n\n- **研究结论、引用和实验结果不能在安装前相信。**（unverified）：研究 Skill 可以组织问题和路径，但不能替代真实资料检索、论文核验和实验复现。\n- **是否适合你的具体研究领域不能直接相信。**（unverified）：Skill 覆盖很多研究主题，不代表对你的领域、资料要求和可信度标准足够。\n- **真实输出质量不能在安装前相信。**（unverified）：Prompt Preview 只能展示引导方式，不能证明真实项目中的结果质量。\n- **宿主 AI 版本兼容性不能在安装前相信。**（unverified）：Claude、Cursor、Codex、Gemini 等宿主加载规则和版本差异必须在真实环境验证。\n- **不会污染现有宿主 AI 行为，不能直接相信。**（inferred）：Skill、plugin、AGENTS/CLAUDE/GEMINI 指令可能改变宿主 AI 的默认行为。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `AGENTS.md`, `skills/ab-testing/SKILL.md` 等\n- **可安全回滚不能默认相信。**（unverified）：除非项目明确提供卸载和恢复说明，否则必须先在隔离环境验证。\n- **真实安装后是否与用户当前宿主 AI 版本兼容？**（unverified）：兼容性只能通过实际宿主环境验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`\n- **项目输出质量是否满足用户具体任务？**（unverified）：安装前预览只能展示流程和边界，不能替代真实评测。\n\n### 继续会触碰什么\n\n- **研究判断**：问题拆解、资料路径、实验路径、结论结构和可信度判断。 原因：研究型 Skill 可能让输出看起来更专业，但不能替代真实证据核验。\n- **命令执行**：包管理器、网络下载、本地插件目录、项目配置或用户主目录。 原因：运行第一条命令就可能产生环境改动；必须先判断是否值得跑。 证据：`README.md`\n- **宿主 AI 配置**：Claude/Codex/Cursor/Gemini/OpenCode 等宿主的 plugin、Skill 或规则加载配置。 原因：宿主配置会改变 AI 后续工作方式，可能和用户已有规则冲突。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `AGENTS.md`, `skills/ab-testing/SKILL.md` 等\n- **本地环境或项目文件**：安装结果、插件缓存、项目配置或本地依赖目录。 原因：安装前无法证明写入范围和回滚方式，需要隔离验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json`, `README.md`\n- **宿主 AI 上下文**：AI Context Pack、Prompt Preview、Skill 路由、风险规则和项目事实。 原因：导入上下文会影响宿主 AI 后续判断，必须避免把未验证项包装成事实。\n\n### 最小安全下一步\n\n- **先跑 Prompt Preview**：先验证它能否正确界定研究问题和证据边界，不要先相信研究输出。（适用：任何项目都适用，尤其是输出质量未知时。）\n- **只在隔离目录或测试账号试装**：避免安装命令污染主力宿主 AI、真实项目或用户主目录。（适用：存在命令执行、插件配置或本地写入线索时。）\n- **先备份宿主 AI 配置**：Skill、plugin、规则文件可能改变 Claude/Cursor/Codex 的默认行为。（适用：存在插件 manifest、Skill 或宿主规则入口时。）\n- **安装后只验证一个最小任务**：先验证加载、兼容、输出质量和回滚，再决定是否深用。（适用：准备从试用进入真实工作流时。）\n\n### 退出方式\n\n- **保留安装前状态**：记录原始宿主配置和项目状态，后续才能判断是否可恢复。\n- **准备移除宿主 plugin / Skill / 规则入口**：如果试装后行为异常，可以把宿主 AI 恢复到试装前状态。\n- **保留资料和结论核验清单**：如果后续发现引用或实验路径不可靠，可以回到证据边界阶段重新校验。\n- **记录安装命令和写入路径**：没有明确卸载说明时，至少要知道哪些目录或配置需要手动清理。\n- **如果没有回滚路径，不进入主力环境**：不可回滚是继续前阻断项，不应靠信任或运气继续。\n\n## 哪些只能预览\n\n- 解释项目适合谁和能做什么\n- 基于项目文档演示典型对话流程\n- 帮助用户判断是否值得安装或继续研究\n\n## 哪些必须安装后验证\n\n- 真实安装 Skill、插件或 CLI\n- 执行脚本、修改本地文件或访问外部服务\n- 验证真实输出质量、性能和兼容性\n\n## 边界与风险判断卡\n\n- **把安装前预览误认为真实运行**：用户可能高估项目已经完成的配置、权限和兼容性验证。 处理方式：明确区分 prompt_preview_can_do 与 runtime_required。 Claim：`clm_0015` inferred 0.45\n- **宿主 AI 插件或 Skill 规则冲突**：新规则可能改变用户现有宿主 AI 的工作方式。 处理方式：安装前先检查插件 manifest 和 Skill 文件，必要时隔离测试。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0016` supported 0.86\n- **命令执行会修改本地环境**：安装命令可能写入用户主目录、宿主插件目录或项目配置。 处理方式：先在隔离环境或测试账号中运行。 证据：`README.md` Claim：`clm_0017` supported 0.86\n- **源文档冲突：skill_count**：项目文档中存在数量表述不一致，AI Context Pack 必须提示用户不要把单一数字当作已验证事实。 处理方式：在 Human Manual 和 AI Context Pack 中共同标记为待核实，而不是强行选择一个数字。 证据：`VERSIONS.md`, `VERSIONS.md` Claim：`clm_0018` supported 0.86, `clm_0019` contradicted 0.20\n- **源文件冲突 skill_count**：发现多个值 `32, 33`，应在真实使用前核实。\n- **待确认**：真实安装后是否与用户当前宿主 AI 版本兼容？。原因：兼容性只能通过实际宿主环境验证。\n- **待确认**：项目输出质量是否满足用户具体任务？。原因：安装前预览只能展示流程和边界，不能替代真实评测。\n- **待确认**：安装命令是否需要网络、权限或全局写入？。原因：这影响企业环境和个人环境的安装风险。\n\n## 开工前工作上下文\n\n### 加载顺序\n\n- 先读取 how_to_use.host_ai_instruction，建立安装前判断资产的边界。\n- 读取 claim_graph_summary，确认事实来自 Claim/Evidence Graph，而不是 Human Wiki 叙事。\n- 再读取 intended_users、capabilities 和 quick_start_candidates，判断用户是否匹配。\n- 需要执行具体任务时，优先查 role_skill_index，再查 evidence_index。\n- 遇到真实安装、文件修改、网络访问、性能或兼容性问题时，转入 risk_card 和 boundaries.runtime_required。\n\n### 任务路由\n\n- **AI Skill / Agent 指令资产库**：先基于 role_skill_index / evidence_index 帮用户挑选可用角色、Skill 或工作流。 边界：可做安装前 Prompt 体验。 证据：`skills/ab-testing/SKILL.md`, `skills/ad-creative/SKILL.md`, `skills/ads/SKILL.md`, `skills/ai-seo/SKILL.md` 等 Claim：`clm_0001` supported 0.86\n- **多宿主安装与分发**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`.claude-plugin/marketplace.json`, `.claude-plugin/plugin.json` Claim：`clm_0002` supported 0.86\n- **命令行启动或安装流程**：先说明这是安装后验证能力，再给出安装前检查清单。 边界：必须真实安装或运行后验证。 证据：`README.md` Claim：`clm_0003` supported 0.86\n\n### 上下文规模\n\n- 文件总数：320\n- 重要文件覆盖：40/320\n- 证据索引条目：80\n- 角色 / Skill 条目：40\n\n### 证据不足时的处理\n\n- **missing_evidence**：说明证据不足，要求用户提供目标文件、README 段落或安装后验证记录；不要补全事实。\n- **out_of_scope_request**：说明该任务超出当前 AI Context Pack 证据范围，并建议用户先查看 Human Manual 或真实安装后验证。\n- **runtime_request**：给出安装前检查清单和命令来源，但不要替用户执行命令或声称已执行。\n- **source_conflict**：同时展示冲突来源，标记为待核实，不要强行选择一个版本。\n\n## Prompt Recipes\n\n### 适配判断\n\n- 目标：判断这个项目是否适合用户当前任务。\n- 预期输出：适配结论、关键理由、证据引用、安装前可预览内容、必须安装后验证内容、下一步建议。\n\n```text\n请基于 marketingskills 的 AI Context Pack，先问我 3 个必要问题，然后判断它是否适合我的任务。回答必须包含：适合谁、能做什么、不能做什么、是否值得安装、证据来自哪里。所有项目事实必须引用 evidence_refs、source_paths 或 claim_id。\n```\n\n### 安装前体验\n\n- 目标：让用户在安装前感受核心工作流，同时避免把预览包装成真实能力或营销承诺。\n- 预期输出：一段带边界标签的体验剧本、安装后验证清单和谨慎建议；不含真实运行承诺或强营销表述。\n\n```text\n请把 marketingskills 当作安装前体验资产，而不是已安装工具或真实运行环境。\n\n请严格输出四段：\n1. 先问我 3 个必要问题。\n2. 给出一段“体验剧本”：用 [安装前可预览]、[必须安装后验证]、[证据不足] 三种标签展示它可能如何引导工作流。\n3. 给出安装后验证清单：列出哪些能力只有真实安装、真实宿主加载、真实项目运行后才能确认。\n4. 给出谨慎建议：只能说“值得继续研究/试装”“先补充信息后再判断”或“不建议继续”，不得替项目背书。\n\n硬性边界：\n- 不要声称已经安装、运行、执行测试、修改文件或产生真实结果。\n- 不要写“自动适配”“确保通过”“完美适配”“强烈建议安装”等承诺性表达。\n- 如果描述安装后的工作方式，必须使用“如果安装成功且宿主正确加载 Skill，它可能会……”这种条件句。\n- 体验剧本只能写成“示例台词/假设流程”：使用“可能会询问/可能会建议/可能会展示”，不要写“已写入、已生成、已通过、正在运行、正在生成”。\n- Prompt Preview 不负责给安装命令；如用户准备试装，只能提示先阅读 Quick Start 和 Risk Card，并在隔离环境验证。\n- 所有项目事实必须来自 supported claim、evidence_refs 或 source_paths；inferred/unverified 只能作风险或待确认项。\n\n```\n\n### 角色 / Skill 选择\n\n- 目标：从项目里的角色或 Skill 中挑选最匹配的资产。\n- 预期输出：候选角色或 Skill 列表，每项包含适用场景、证据路径、风险边界和是否需要安装后验证。\n\n```text\n请读取 role_skill_index，根据我的目标任务推荐 3-5 个最相关的角色或 Skill。每个推荐都要说明适用场景、可能输出、风险边界和 evidence_refs。\n```\n\n### 风险预检\n\n- 目标：安装或引入前识别环境、权限、规则冲突和质量风险。\n- 预期输出：环境、权限、依赖、许可、宿主冲突、质量风险和未知项的检查清单。\n\n```text\n请基于 risk_card、boundaries 和 quick_start_candidates，给我一份安装前风险预检清单。不要替我执行命令，只说明我应该检查什么、为什么检查、失败会有什么影响。\n```\n\n### 宿主 AI 开工指令\n\n- 目标：把项目上下文转成一次对话开始前的宿主 AI 指令。\n- 预期输出：一段边界明确、证据引用明确、适合复制给宿主 AI 的开工前指令。\n\n```text\n请基于 marketingskills 的 AI Context Pack，生成一段我可以粘贴给宿主 AI 的开工前指令。这段指令必须遵守 not_runtime=true，不能声称项目已经安装、运行或产生真实结果。\n```\n\n\n## 角色 / Skill 索引\n\n- 共索引 40 个角色 / Skill / 项目文档条目。\n\n- **ab-testing**（skill）：When the user wants to plan, design, or implement an A/B test or experiment, or build a growth experimentation program. Also use when the user mentions \"A/B test,\" \"split test,\" \"experiment,\" \"test this change,\" \"variant copy,\" \"multivariate test,\" \"hypothesis,\" \"should I test this,\" \"which version is better,\" \"test two versions,\" \"statistical significance,\" \"how long should I run this test,\" \"growth experiments,\" \"… 激活提示：当用户任务与“ab-testing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ab-testing/SKILL.md`\n- **ad-creative**（skill）：When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'ad performance optimization,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,'… 激活提示：当用户任务与“ad-creative”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ad-creative/SKILL.md`\n- **ads**（skill）：When the user wants help with paid advertising campaigns on Google Ads, Meta Facebook/Instagram , LinkedIn, Twitter/X, or other ad platforms. Also use when the user mentions 'PPC,' 'paid media,' 'ROAS,' 'CPA,' 'ad campaign,' 'retargeting,' 'audience targeting,' 'Google Ads,' 'Facebook ads,' 'LinkedIn ads,' 'ad budget,' 'cost per click,' 'ad spend,' or 'should I run ads.' Use this for campaign strategy, audience targ… 激活提示：当用户任务与“ads”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ads/SKILL.md`\n- **ai-seo**（skill）：When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,'… 激活提示：当用户任务与“ai-seo”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/ai-seo/SKILL.md`\n- **analytics**（skill）：When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions \"set up tracking,\" \"GA4,\" \"Google Analytics,\" \"conversion tracking,\" \"event tracking,\" \"UTM parameters,\" \"tag manager,\" \"GTM,\" \"analytics implementation,\" \"tracking plan,\" \"how do I measure this,\" \"track conversions,\" \"attribution,\" \"Mixpanel,\" \"Segment,\" \"are my events firing,\" or \"analytics isn't wo… 激活提示：当用户任务与“analytics”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/analytics/SKILL.md`\n- **aso**（skill）：When the user wants to audit or optimize an App Store or Google Play listing. Also use when the user mentions 'ASO audit,' 'app store optimization,' 'optimize my app listing,' 'improve app visibility,' 'app store ranking,' 'audit my listing,' 'why aren't people downloading my app,' 'improve my app conversion,' 'keyword optimization for app,' or 'compare my app to competitors.' Use when the user shares an App Store o… 激活提示：当用户任务与“aso”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/aso/SKILL.md`\n- **churn-prevention**（skill）：When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep user… 激活提示：当用户任务与“churn-prevention”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/churn-prevention/SKILL.md`\n- **co-marketing**（skill）：When the user wants to find co-marketing partners, plan joint campaigns, or brainstorm partnership opportunities. Use when the user says 'co-marketing,' 'partner marketing,' 'joint campaign,' 'who should we partner with,' 'integration marketing,' 'cross-promotion,' 'collaborate with another company,' 'partnership ideas,' or 'co-brand.' For customer referral programs, see referrals. For launch-specific partnerships,… 激活提示：当用户任务与“co-marketing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/co-marketing/SKILL.md`\n- **cold-email**（skill）：Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions \"cold outreach,\" \"prospecting email,\" \"outbound email,\" \"email to leads,\" \"reach out to prospects,\" \"sales email,\" \"follow-up email sequence,\" \"nobody's replying to my emails,\" or \"how… 激活提示：当用户任务与“cold-email”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/cold-email/SKILL.md`\n- **community-marketing**（skill）：Build and leverage online communities to drive product growth and brand loyalty. Use when the user wants to create a community strategy, grow a Discord or Slack community, manage a forum or subreddit, build brand advocates, increase word-of-mouth, drive community-led growth, engage users post-signup, or turn customers into evangelists. Trigger phrases: \\\"build a community,\\\" \\\"community strategy,\\\" \\\"Discord communi… 激活提示：当用户任务与“community-marketing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/community-marketing/SKILL.md`\n- **competitor-profiling**（skill）：When the user wants to research, profile, or analyze competitors from their URLs. Also use when the user mentions 'competitor profile,' 'competitor research,' 'competitor analysis,' 'profile this competitor,' 'analyze competitor,' 'competitive intelligence,' 'competitor deep dive,' 'who are my competitors,' 'competitor landscape,' 'competitor dossier,' 'competitive audit,' or 'research these competitors.' Input is a… 激活提示：当用户任务与“competitor-profiling”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/competitor-profiling/SKILL.md`\n- **competitors**（skill）：When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' ' Product vs Product ,' ' Product alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against comp… 激活提示：当用户任务与“competitors”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/competitors/SKILL.md`\n- **content-strategy**（skill）：When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions \"content strategy,\" \"what should I write about,\" \"content ideas,\" \"blog strategy,\" \"topic clusters,\" \"content planning,\" \"editorial calendar,\" \"content marketing,\" \"content roadmap,\" \"what content should I create,\" \"blog topics,\" \"content pillars,\" or \"I don't know what t… 激活提示：当用户任务与“content-strategy”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/content-strategy/SKILL.md`\n- **copy-editing**（skill）：When the user wants to edit, review, or improve existing marketing copy, or refresh outdated content. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' 'sharpen the messaging,' 'refresh this content,' 'update this page,' 'this content is outdat… 激活提示：当用户任务与“copy-editing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/copy-editing/SKILL.md`\n- **copywriting**（skill）：When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says \"write copy for,\" \"improve this copy,\" \"rewrite this page,\" \"marketing copy,\" \"headline help,\" \"CTA copy,\" \"value proposition,\" \"tagline,\" \"subheadline,\" \"hero section copy,\" \"above the fold,\" \"this copy is weak,\" \"… 激活提示：当用户任务与“copywriting”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/copywriting/SKILL.md`\n- **cro**（skill）：When the user wants to optimize, improve, or increase conversions on any marketing page or form — including homepage, landing pages, pricing pages, feature pages, lead capture forms, or contact forms. Also use when the user says 'CRO,' 'conversion rate optimization,' 'this page isn't converting,' 'improve conversions,' 'why isn't this page working,' 'my landing page sucks,' 'form abandonment,' 'nobody's converting,'… 激活提示：当用户任务与“cro”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/cro/SKILL.md`\n- **customer-research**（skill）：When the user wants to conduct, analyze, or synthesize customer research. Use when the user mentions \"customer research,\" \"ICP research,\" \"talk to customers,\" \"analyze transcripts,\" \"customer interviews,\" \"survey analysis,\" \"support ticket analysis,\" \"voice of customer,\" \"VOC,\" \"build personas,\" \"customer personas,\" \"jobs to be done,\" \"JTBD,\" \"what do customers say,\" \"what are customers struggling with,\" \"Reddit min… 激活提示：当用户任务与“customer-research”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/customer-research/SKILL.md`\n- **directory-submissions**（skill）：When the user wants to submit their product to startup, SaaS, AI, agent, MCP, no-code, or review directories for backlinks, domain rating, and discovery. Also use when the user mentions \"directory submissions,\" \"submit to directories,\" \"backlinks from directories,\" \"list my product,\" \"submit to Product Hunt,\" \"BetaList,\" \"TAAFT,\" \"Futurepedia,\" \"G2 listing,\" \"Capterra listing,\" \"AlternativeTo,\" \"SaaSHub,\" \"AI direct… 激活提示：当用户任务与“directory-submissions”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/directory-submissions/SKILL.md`\n- **emails**（skill）：When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions \"email sequence,\" \"drip campaign,\" \"nurture sequence,\" \"onboarding emails,\" \"welcome sequence,\" \"re-engagement emails,\" \"email automation,\" \"lifecycle emails,\" \"trigger-based emails,\" \"email funnel,\" \"email workflow,\" \"what emails should I send,\" \"welcome serie… 激活提示：当用户任务与“emails”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/emails/SKILL.md`\n- **free-tools**（skill）：When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions \"engineering as marketing,\" \"free tool,\" \"marketing tool,\" \"calculator,\" \"generator,\" \"interactive tool,\" \"lead gen tool,\" \"build a tool for leads,\" \"free resource,\" \"ROI calculator,\" \"grader tool,\" \"audit tool,\" \"should I build a free tool,\" or \"tools f… 激活提示：当用户任务与“free-tools”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/free-tools/SKILL.md`\n- **image**（skill）：When the user wants to create, generate, edit, or optimize images for marketing — blog heroes, social graphics, product mockups, profile banners, listing visuals, or brand assets. Also use when the user mentions 'AI image generation,' 'generate an image,' 'create a graphic,' 'product mockup,' 'hero image,' 'social media graphic,' 'banner image,' 'cover photo,' 'profile banner,' 'listing screenshot,' 'Flux,' 'Midjour… 激活提示：当用户任务与“image”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/image/SKILL.md`\n- **launch**（skill）：When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' 'product update,' 'how do I launch this,' 'launch checklist,' 'GTM plan,' or 'we're about to ship.' Use this whenever someone is preparing to release something publicly. For ongo… 激活提示：当用户任务与“launch”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/launch/SKILL.md`\n- **lead-magnets**（skill）：When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the user mentions \"lead magnet,\" \"gated content,\" \"content upgrade,\" \"downloadable,\" \"ebook,\" \"cheat sheet,\" \"checklist,\" \"template download,\" \"opt-in,\" \"freebie,\" \"PDF download,\" \"resource library,\" \"content offer,\" \"email capture content,\" \"Notion template,\" \"spreadsheet template,\" or \"what should I g… 激活提示：当用户任务与“lead-magnets”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/lead-magnets/SKILL.md`\n- **marketing-ideas**（skill）：When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' 'ideas to grow,' 'what else can I try,' 'I don't know how to market this,' 'brainstorm marketing,' or 'what marketing should I do.' Use this as a starting point whenever s… 激活提示：当用户任务与“marketing-ideas”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/marketing-ideas/SKILL.md`\n- **marketing-psychology**（skill）：When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' 'consumer behavior,' 'anchoring,' 'social proof,' 'scarcity,' 'loss aversion,' 'framing,' or 'nudge.' Use this whenever someone wants to understand or leverage… 激活提示：当用户任务与“marketing-psychology”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/marketing-psychology/SKILL.md`\n- **onboarding**（skill）：When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value. Also use when the user mentions \"onboarding flow,\" \"activation rate,\" \"user activation,\" \"first-run experience,\" \"empty states,\" \"onboarding checklist,\" \"aha moment,\" \"new user experience,\" \"users aren't activating,\" \"nobody completes setup,\" \"low activation rate,\" \"users sign up but don't use the product… 激活提示：当用户任务与“onboarding”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/onboarding/SKILL.md`\n- **paywalls**（skill）：When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use when the user mentions \"paywall,\" \"upgrade screen,\" \"upgrade modal,\" \"upsell,\" \"feature gate,\" \"convert free to paid,\" \"freemium conversion,\" \"trial expiration screen,\" \"limit reached screen,\" \"plan upgrade prompt,\" \"in-app pricing,\" \"free users won't upgrade,\" \"trial to paid conversion,\" or \"how do… 激活提示：当用户任务与“paywalls”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/paywalls/SKILL.md`\n- **popups**（skill）：When the user wants to create or optimize popups, modals, overlays, slide-ins, or banners for conversion purposes. Also use when the user mentions \"exit intent,\" \"popup conversions,\" \"modal optimization,\" \"lead capture popup,\" \"email popup,\" \"announcement banner,\" \"overlay,\" \"collect emails with a popup,\" \"exit popup,\" \"scroll trigger,\" \"sticky bar,\" or \"notification bar.\" Use this for any overlay or interrupt-style… 激活提示：当用户任务与“popups”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/popups/SKILL.md`\n- **pricing**（skill）：When the user wants help with pricing decisions, packaging, or monetization strategy. Also use when the user mentions 'pricing,' 'pricing tiers,' 'freemium,' 'free trial,' 'packaging,' 'price increase,' 'value metric,' 'Van Westendorp,' 'willingness to pay,' 'monetization,' 'how much should I charge,' 'my pricing is wrong,' 'pricing page,' 'annual vs monthly,' 'per seat pricing,' or 'should I offer a free plan.' Use… 激活提示：当用户任务与“pricing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/pricing/SKILL.md`\n- **product-marketing**（skill）：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… 激活提示：当用户任务与“product-marketing”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/product-marketing/SKILL.md`\n- **programmatic-seo**（skill）：When the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions \"programmatic SEO,\" \"template pages,\" \"pages at scale,\" \"directory pages,\" \"location pages,\" \" keyword + city pages,\" \"comparison pages,\" \"integration pages,\" \"building many pages for SEO,\" \"pSEO,\" \"generate 100 pages,\" \"data-driven pages,\" or \"templated landing pages.\" Use this whenever someone wants to… 激活提示：当用户任务与“programmatic-seo”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/programmatic-seo/SKILL.md`\n- **referrals**（skill）：When the user wants to create, optimize, or analyze a referral program, affiliate program, or word-of-mouth strategy. Also use when the user mentions 'referral,' 'affiliate,' 'ambassador,' 'word of mouth,' 'viral loop,' 'refer a friend,' 'partner program,' 'referral incentive,' 'how to get referrals,' 'customers referring customers,' or 'affiliate payout.' Use this whenever someone wants existing users or partners t… 激活提示：当用户任务与“referrals”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/referrals/SKILL.md`\n- **revops**（skill）：When the user wants help with revenue operations, lead lifecycle management, or marketing-to-sales handoff processes. Also use when the user mentions 'RevOps,' 'revenue operations,' 'lead scoring,' 'lead routing,' 'MQL,' 'SQL,' 'pipeline stages,' 'deal desk,' 'CRM automation,' 'marketing-to-sales handoff,' 'data hygiene,' 'leads aren't getting to sales,' 'pipeline management,' 'lead qualification,' or 'when should m… 激活提示：当用户任务与“revops”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/revops/SKILL.md`\n- **sales-enablement**（skill）：When the user wants to create sales collateral, pitch decks, one-pagers, objection handling docs, or demo scripts. Also use when the user mentions 'sales deck,' 'pitch deck,' 'one-pager,' 'leave-behind,' 'objection handling,' 'deal-specific ROI analysis,' 'demo script,' 'talk track,' 'sales playbook,' 'proposal template,' 'buyer persona card,' 'help my sales team,' 'sales materials,' or 'what should I give my sales… 激活提示：当用户任务与“sales-enablement”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/sales-enablement/SKILL.md`\n- **schema**（skill）：When the user wants to add, fix, or optimize schema markup and structured data on their site. Also use when the user mentions \"schema markup,\" \"structured data,\" \"JSON-LD,\" \"rich snippets,\" \"schema.org,\" \"FAQ schema,\" \"product schema,\" \"review schema,\" \"breadcrumb schema,\" \"Google rich results,\" \"knowledge panel,\" \"star ratings in search,\" or \"add structured data.\" Use this whenever someone wants their pages to show… 激活提示：当用户任务与“schema”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/schema/SKILL.md`\n- **seo-audit**（skill）：When the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions \"SEO audit,\" \"technical SEO,\" \"why am I not ranking,\" \"SEO issues,\" \"on-page SEO,\" \"meta tags review,\" \"SEO health check,\" \"my traffic dropped,\" \"lost rankings,\" \"not showing up in Google,\" \"site isn't ranking,\" \"Google update hit me,\" \"page speed,\" \"core web vitals,\" \"crawl errors,\" or \"indexing issues.\" Use… 激活提示：当用户任务与“seo-audit”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/seo-audit/SKILL.md`\n- **signup**（skill）：When the user wants to optimize signup, registration, account creation, or trial activation flows. Also use when the user mentions \"signup conversions,\" \"registration friction,\" \"signup form optimization,\" \"free trial signup,\" \"reduce signup dropoff,\" \"account creation flow,\" \"people aren't signing up,\" \"signup abandonment,\" \"trial conversion rate,\" \"nobody completes registration,\" \"too many steps to sign up,\" or \"s… 激活提示：当用户任务与“signup”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/signup/SKILL.md`\n- **site-architecture**（skill）：When the user wants to plan, map, or restructure their website's page hierarchy, navigation, URL structure, or internal linking. Also use when the user mentions \"sitemap,\" \"site map,\" \"visual sitemap,\" \"site structure,\" \"page hierarchy,\" \"information architecture,\" \"IA,\" \"navigation design,\" \"URL structure,\" \"breadcrumbs,\" \"internal linking strategy,\" \"website planning,\" \"what pages do I need,\" \"how should I organiz… 激活提示：当用户任务与“site-architecture”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/site-architecture/SKILL.md`\n- **social**（skill）：When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms. Also use when the user mentions 'LinkedIn post,' 'Twitter thread,' 'social media,' 'content calendar,' 'social scheduling,' 'engagement,' 'viral content,' 'what should I post,' 'repurpose this content,' 'tweet ideas,' 'LinkedIn carousel,' 'social media strategy,'… 激活提示：当用户任务与“social”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/social/SKILL.md`\n- **video**（skill）：When the user wants to create, generate, or produce video content using AI tools or programmatic frameworks. Also use when the user mentions 'video production,' 'AI video,' 'Remotion,' 'Hyperframes,' 'HeyGen,' 'Synthesia,' 'Veo,' 'Runway,' 'Kling,' 'Pika,' 'video generation,' 'AI avatar,' 'talking head video,' 'programmatic video,' 'video template,' 'explainer video,' 'product demo video,' 'video pipeline,' or 'make… 激活提示：当用户任务与“video”描述的流程高度相关时，先用它做安装前体验，再决定是否安装。 证据：`skills/video/SKILL.md`\n\n## 证据索引\n\n- 共索引 80 条证据。\n\n- **AGENTS.md**（documentation）：Guidelines for AI agents working in this repository. 证据：`AGENTS.md`\n- **Marketing Skills for AI Agents**（documentation）：A collection of AI agent skills focused on marketing tasks. Built for technical marketers and founders who want AI coding agents to help with conversion optimization, copywriting, SEO, analytics, and growth engineering. Works with Claude Code, OpenAI Codex, Cursor, Windsurf, and any agent that supports the Agent Skills spec https://agentskills.io . 证据：`README.md`\n- **Marketing CLIs**（documentation）：Zero-dependency, single-file CLI tools for marketing platforms that don't ship their own. 证据：`tools/clis/README.md`\n- **Composio Quick Start**（documentation）：Get MCP access to 500+ marketing tools through a single integration. 证据：`tools/composio/README.md`\n- **Contributing**（documentation）：Thanks for your interest in contributing to Marketing Skills! This guide will help you add new skills or improve existing ones. 证据：`CONTRIBUTING.md`\n- **A/B Test Setup**（skill_instruction）：You are an expert in experimentation and A/B testing. Your goal is to help design tests that produce statistically valid, actionable results. 证据：`skills/ab-testing/SKILL.md`\n- **Ad Creative**（skill_instruction）：You are an expert performance creative strategist. Your goal is to generate high-performing ad creative at scale — headlines, descriptions, and primary text that drive clicks and conversions — and iterate based on real performance data. 证据：`skills/ad-creative/SKILL.md`\n- **Paid Ads**（skill_instruction）：You are an expert performance marketer with direct access to ad platform accounts. Your goal is to help create, optimize, and scale paid advertising campaigns that drive efficient customer acquisition. 证据：`skills/ads/SKILL.md`\n- **AI SEO**（skill_instruction）：You are an expert in AI search optimization — the practice of making content discoverable, extractable, and citable by AI systems including Google AI Overviews, ChatGPT, Perplexity, Claude, Gemini, and Copilot. Your goal is to help users get their content cited as a source in AI-generated answers. 证据：`skills/ai-seo/SKILL.md`\n- **Analytics Tracking**（skill_instruction）：You are an expert in analytics implementation and measurement. Your goal is to help set up tracking that provides actionable insights for marketing and product decisions. 证据：`skills/analytics/SKILL.md`\n- **ASO Audit**（skill_instruction）：Analyze App Store and Google Play listings against ASO best practices. Fetches live listing data, scores metadata, visuals, and ratings, then produces a prioritized action plan. 证据：`skills/aso/SKILL.md`\n- **Churn Prevention**（skill_instruction）：You are an expert in SaaS retention and churn prevention. Your goal is to help reduce both voluntary churn customers choosing to cancel and involuntary churn failed payments through well-designed cancel flows, dynamic save offers, proactive retention, and dunning strategies. 证据：`skills/churn-prevention/SKILL.md`\n- **Before Starting**（skill_instruction）：You are a co-marketing strategist who helps SaaS companies identify ideal partners and brainstorm high-impact joint campaigns. 证据：`skills/co-marketing/SKILL.md`\n- **Cold Email Writing**（skill_instruction）：You are an expert cold email writer. Your goal is to write emails that sound like they came from a sharp, thoughtful human — not a sales machine following a template. 证据：`skills/cold-email/SKILL.md`\n- **Community Marketing**（skill_instruction）：You are an expert community builder and community-led growth strategist. Your goal is to help the user design, launch, and grow a community that creates genuine value for members while driving measurable business outcomes. 证据：`skills/community-marketing/SKILL.md`\n- **Competitor Profiling**（skill_instruction）：You are an expert competitive intelligence analyst. Your goal is to take a list of competitor URLs and produce comprehensive, structured competitor profile documents by combining live site scraping with SEO and market data. 证据：`skills/competitor-profiling/SKILL.md`\n- **Competitor & Alternative Pages**（skill_instruction）：You are an expert in creating competitor comparison and alternative pages. Your goal is to build pages that rank for competitive search terms, provide genuine value to evaluators, and position your product effectively. 证据：`skills/competitors/SKILL.md`\n- **Content Strategy**（skill_instruction）：You are a content strategist. Your goal is to help plan content that drives traffic, builds authority, and generates leads by being either searchable, shareable, or both. 证据：`skills/content-strategy/SKILL.md`\n- **Copy Editing**（skill_instruction）：You are an expert copy editor specializing in marketing and conversion copy. Your goal is to systematically improve existing copy through focused editing passes while preserving the core message. 证据：`skills/copy-editing/SKILL.md`\n- **Copywriting**（skill_instruction）：You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action. 证据：`skills/copywriting/SKILL.md`\n- **Conversion Rate Optimization CRO**（skill_instruction）：You are a conversion rate optimization expert. Your goal is to analyze marketing pages and provide actionable recommendations to improve conversion rates. 证据：`skills/cro/SKILL.md`\n- **Customer Research**（skill_instruction）：You are an expert customer researcher. Your goal is to help uncover what customers actually think, feel, say, and struggle with — so that everything from positioning to product to copy is grounded in reality rather than assumption. 证据：`skills/customer-research/SKILL.md`\n- **Directory Submissions**（skill_instruction）：You are an expert in directory-driven distribution for software products. Your goal is to help the user build a compounding backlink + discovery foundation by submitting to the right directories, in the right order, with the right positioning — and to make sure that foundation actually produces leads instead of vanity backlinks. 证据：`skills/directory-submissions/SKILL.md`\n- **Email Sequence Design**（skill_instruction）：You are an expert in email marketing and automation. Your goal is to create email sequences that nurture relationships, drive action, and move people toward conversion. 证据：`skills/emails/SKILL.md`\n- **Free Tool Strategy Engineering as Marketing**（skill_instruction）：Free Tool Strategy Engineering as Marketing 证据：`skills/free-tools/SKILL.md`\n- **Image**（skill_instruction）：You are an expert visual content producer who helps create marketing images using AI generation models, design tools, and optimization best practices. Your goal is to help users produce professional visual assets efficiently — from blog heroes and social graphics to product mockups and profile banners. 证据：`skills/image/SKILL.md`\n- **Launch Strategy**（skill_instruction）：You are an expert in SaaS product launches and feature announcements. Your goal is to help users plan launches that build momentum, capture attention, and convert interest into users. 证据：`skills/launch/SKILL.md`\n- **Lead Magnets**（skill_instruction）：You are an expert in lead magnet strategy. Your goal is to help plan lead magnets that capture emails, generate qualified leads, and naturally lead to product adoption. 证据：`skills/lead-magnets/SKILL.md`\n- **Marketing Ideas for SaaS**（skill_instruction）：You are a marketing strategist with a library of 139 proven marketing ideas. Your goal is to help users find the right marketing strategies for their specific situation, stage, and resources. 证据：`skills/marketing-ideas/SKILL.md`\n- **Marketing Psychology & Mental Models**（skill_instruction）：Marketing Psychology & Mental Models 证据：`skills/marketing-psychology/SKILL.md`\n- **Onboarding CRO**（skill_instruction）：You are an expert in user onboarding and activation. Your goal is to help users reach their \"aha moment\" as quickly as possible and establish habits that lead to long-term retention. 证据：`skills/onboarding/SKILL.md`\n- **Paywall and Upgrade Screen CRO**（skill_instruction）：You are an expert in in-app paywalls and upgrade flows. Your goal is to convert free users to paid, or upgrade users to higher tiers, at moments when they've experienced enough value to justify the commitment. 证据：`skills/paywalls/SKILL.md`\n- **Popup CRO**（skill_instruction）：You are an expert in popup and modal optimization. Your goal is to create popups that convert without annoying users or damaging brand perception. 证据：`skills/popups/SKILL.md`\n- **Pricing Strategy**（skill_instruction）：You are an expert in SaaS pricing and monetization strategy. Your goal is to help design pricing that captures value, drives growth, and aligns with customer willingness to pay. 证据：`skills/pricing/SKILL.md`\n- **Product Marketing Context**（skill_instruction）：You help users create and maintain a product marketing context document. This captures foundational positioning and messaging information that other marketing skills reference, so users don't repeat themselves. 证据：`skills/product-marketing/SKILL.md`\n- **Programmatic SEO**（skill_instruction）：You are an expert in programmatic SEO—building SEO-optimized pages at scale using templates and data. Your goal is to create pages that rank, provide value, and avoid thin content penalties. 证据：`skills/programmatic-seo/SKILL.md`\n- **Referral & Affiliate Programs**（skill_instruction）：You are an expert in viral growth and referral marketing. Your goal is to help design and optimize programs that turn customers into growth engines. 证据：`skills/referrals/SKILL.md`\n- **RevOps**（skill_instruction）：You are an expert in revenue operations. Your goal is to help design and optimize the systems that connect marketing, sales, and customer success into a unified revenue engine. 证据：`skills/revops/SKILL.md`\n- **Sales Enablement**（skill_instruction）：You are an expert in B2B sales enablement. Your goal is to create sales collateral that reps actually use — decks, one-pagers, objection docs, demo scripts, and playbooks that help close deals. 证据：`skills/sales-enablement/SKILL.md`\n- **Schema Markup**（skill_instruction）：You are an expert in structured data and schema markup. Your goal is to implement schema.org markup that helps search engines understand content and enables rich results in search. 证据：`skills/schema/SKILL.md`\n- **SEO Audit**（skill_instruction）：You are an expert in search engine optimization. Your goal is to identify SEO issues and provide actionable recommendations to improve organic search performance. 证据：`skills/seo-audit/SKILL.md`\n- **Signup Flow CRO**（skill_instruction）：You are an expert in optimizing signup and registration flows. Your goal is to reduce friction, increase completion rates, and set users up for successful activation. 证据：`skills/signup/SKILL.md`\n- **Site Architecture**（skill_instruction）：You are an information architecture expert. Your goal is to help plan website structure — page hierarchy, navigation, URL patterns, and internal linking — so the site is intuitive for users and optimized for search engines. 证据：`skills/site-architecture/SKILL.md`\n- **Social Content**（skill_instruction）：You are an expert social media strategist. Your goal is to help create engaging content that builds audience, drives engagement, and supports business goals. 证据：`skills/social/SKILL.md`\n- **Video**（skill_instruction）：You are an expert video producer who helps create marketing videos using AI generation models, AI avatars, and programmatic video frameworks. Your goal is to help users produce professional video content efficiently — from product demos and explainers to social clips and ads. 证据：`skills/video/SKILL.md`\n- **Marketplace**（structured_config）：{ \"name\": \"marketingskills\", \"owner\": { \"name\": \"Corey Haines\", \"url\": \"https://corey.co\" }, \"metadata\": { \"description\": \"Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, and growth\", \"version\": \"2.0.0\", \"repository\": \"https://github.com/coreyhaines31/marketingskills\" }, \"plugins\": { \"name\": \"marketing-skills\", \"description\": \"40 marketing skills for technical marketers and founders: CRO, copywriting, cold email, SEO, AI SEO, paid ads, ad creative, video production, image generation, co-marketing, churn prevention, pricing, referrals, revenue operations, sales enablement, customer research, site architecture, and more\", \"source\": \"./\" } } 证据：`.claude-plugin/marketplace.json`\n- **Plugin**（structured_config）：{ \"name\": \"marketing-skills\", \"description\": \"Marketing skills for AI agents — conversion optimization, copywriting, SEO, paid ads, ad creative, and growth\", \"version\": \"1.9.0\", \"author\": { \"name\": \"Corey Haines\" }, \"homepage\": \"https://github.com/coreyhaines31/marketingskills\", \"repository\": \"https://github.com/coreyhaines31/marketingskills\", \"license\": \"MIT\", \"skills\": \"./skills\" } 证据：`.claude-plugin/plugin.json`\n- **License**（source_file）：Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files the \"Software\" , to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: 证据：`LICENSE`\n- **Marketing Skills Versions**（documentation）：Current versions of all skills. Agents can compare against local versions to check for updates. 证据：`VERSIONS.md`\n- **Marketing Tools Registry**（documentation）：Quick reference for AI agents to discover tool capabilities and integration methods. 证据：`tools/REGISTRY.md`\n- **Documentation**（documentation）：- Links are valid - Formatting is consistent with existing docs - No sensitive data or credentials 证据：`.github/PULL_REQUEST_TEMPLATE/documentation.md`\n- **New Skill**（skill_instruction）：- name matches directory name exactly - name follows naming rules lowercase, hyphens, no -- - description is 1-1024 chars with trigger phrases - SKILL.md is under 500 lines - No sensitive data or credentials - Tested locally with AI agent 证据：`.github/PULL_REQUEST_TEMPLATE/new-skill.md`\n- **Skill Update**（documentation）：- Bug fix - Improved instructions - Added references/scripts - Other 证据：`.github/PULL_REQUEST_TEMPLATE/skill-update.md`\n- **Sample Size Guide**（documentation）：Reference for calculating sample sizes and test duration. 证据：`skills/ab-testing/references/sample-size-guide.md`\n- **Generative AI Tools for Ad Creative**（documentation）：Generative AI Tools for Ad Creative 证据：`skills/ad-creative/references/generative-tools.md`\n- **Platform Specs Reference**（documentation）：Complete character limits, format requirements, and best practices for each ad platform. 证据：`skills/ad-creative/references/platform-specs.md`\n- **Ad Copy Templates Reference**（documentation）：Detailed formulas and templates for writing high-converting ad copy. 证据：`skills/ads/references/ad-copy-templates.md`\n- **Audience Targeting Reference**（documentation）：Detailed targeting strategies for each major ad platform. 证据：`skills/ads/references/audience-targeting.md`\n- **Conversion Tracking Setup**（documentation）：How to set up conversion tracking pixels across ad platforms. This guide covers installation, event configuration, and validation — everything a marketer needs to ensure ad spend is properly attributed. 证据：`skills/ads/references/conversion-tracking.md`\n- **Platform Setup Checklists**（documentation）：Complete setup checklists for major ad platforms. 证据：`skills/ads/references/platform-setup-checklists.md`\n- 其余 20 条证据见 `AI_CONTEXT_PACK.json` 或 `EVIDENCE_INDEX.json`。\n\n## 宿主 AI 必须遵守的规则\n\n- **把本资产当作开工前上下文，而不是运行环境。**：AI Context Pack 只包含证据化项目理解，不包含目标项目的可执行状态。 证据：`AGENTS.md`, `README.md`, `tools/clis/README.md`\n- **回答用户时区分可预览内容与必须安装后才能验证的内容。**：安装前体验的消费者价值来自降低误装和误判，而不是伪装成真实运行。 证据：`AGENTS.md`, `README.md`, `tools/clis/README.md`\n\n## 用户开工前应该回答的问题\n\n- 你准备在哪个宿主 AI 或本地环境中使用它？\n- 你只是想先体验工作流，还是准备真实安装？\n- 你最在意的是安装成本、输出质量、还是和现有规则的冲突？\n\n## 验收标准\n\n- 所有能力声明都能回指到 evidence_refs 中的文件路径。\n- AI_CONTEXT_PACK.md 没有把预览包装成真实运行。\n- 用户能在 3 分钟内看懂适合谁、能做什么、如何开始和风险边界。\n\n---\n\n## Doramagic Context Augmentation\n\n下面内容用于强化 Repomix/AI Context Pack 主体。Human Manual 只提供阅读骨架；踩坑日志会被转成宿主 AI 必须遵守的工作约束。\n\n## Human Manual 骨架\n\n使用规则：这里只是项目阅读路线和显著性信号，不是事实权威。具体事实仍必须回到 repo evidence / Claim Graph。\n\n宿主 AI 硬性规则：\n- 不得把页标题、章节顺序、摘要或 importance 当作项目事实证据。\n- 解释 Human Manual 骨架时，必须明确说它只是阅读路线/显著性信号。\n- 能力、安装、兼容性、运行状态和风险判断必须引用 repo evidence、source path 或 Claim Graph。\n\n- **Home**：importance `high`\n - source_paths: README.md, AGENTS.md, CLAUDE.md\n- **Getting Started**：importance `high`\n - source_paths: README.md, AGENTS.md\n- **Skills Architecture**：importance `high`\n - source_paths: README.md, AGENTS.md, skills/product-marketing/SKILL.md, skills/cro/SKILL.md\n- **Conversion Optimization Skills**：importance `high`\n - source_paths: skills/cro/SKILL.md, skills/cro/references/experiments.md, skills/cro/references/form.md, skills/signup/SKILL.md, skills/onboarding/SKILL.md\n- **Content and Copy Skills**：importance `high`\n - source_paths: skills/copywriting/SKILL.md, skills/copywriting/references/copy-frameworks.md, skills/copywriting/references/natural-transitions.md, skills/copy-editing/SKILL.md, skills/cold-email/SKILL.md\n- **SEO and Discovery Skills**：importance `high`\n - source_paths: skills/seo-audit/SKILL.md, skills/seo-audit/references/ai-writing-detection.md, skills/ai-seo/SKILL.md, skills/ai-seo/references/platform-ranking-factors.md, skills/programmatic-seo/SKILL.md\n- **Paid Advertising Skills**：importance `high`\n - source_paths: skills/ads/SKILL.md, skills/ads/references/platform-setup-checklists.md, skills/ads/references/audience-targeting.md, skills/ads/references/conversion-tracking.md, skills/ad-creative/SKILL.md\n- **Analytics and Testing Skills**：importance `high`\n - source_paths: skills/analytics/SKILL.md, skills/analytics/references/ga4-implementation.md, skills/analytics/references/gtm-implementation.md, skills/analytics/references/event-library.md, skills/ab-testing/SKILL.md\n\n## Repo Inspection Evidence / 源码检查证据\n\n- repo_clone_verified: true\n- repo_inspection_verified: true\n- repo_commit: `bd8eb1a0e5a82379537298c0570e85279ca27337`\n- inspected_files: `README.md`\n\n宿主 AI 硬性规则：\n- 没有 repo_clone_verified=true 时，不得声称已经读过源码。\n- 没有 repo_inspection_verified=true 时，不得把 README/docs/package 文件判断写成事实。\n- 没有 quick_start_verified=true 时，不得声称 Quick Start 已跑通。\n\n## Doramagic Pitfall Constraints / 踩坑约束\n\n这些规则来自 Doramagic 发现、验证或编译过程中的项目专属坑点。宿主 AI 必须把它们当作工作约束，而不是普通说明文字。\n\n### Constraint 1: 仓库名和安装名不一致\n\n- Trigger: 仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- Host AI rule: 在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- Why it matters: 用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- Evidence: identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 2: 来源证据：Add OpenAI Codex plugin support\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- Host AI rule: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 3: 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 4: 来源证据：Feature Request: Add Prefix to skills\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- Host AI rule: 来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 5: 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能影响升级、迁移或版本选择。\n- Evidence: community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 6: 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- Trigger: GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- Host AI rule: 来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- Why it matters: 可能增加新用户试用和生产接入成本。\n- Evidence: community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 7: 可能修改宿主 AI 配置\n\n- Trigger: 项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- Host AI rule: 列出会写入的配置文件、目录和卸载/回滚步骤。\n- Why it matters: 安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- Evidence: capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 8: 能力判断依赖假设\n\n- Trigger: README/documentation is current enough for a first validation pass.\n- Host AI rule: 将假设转成下游验证清单。\n- Why it matters: 假设不成立时，用户拿不到承诺的能力。\n- Evidence: capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 9: 维护活跃度未知\n\n- Trigger: 未记录 last_activity_observed。\n- Host AI rule: 补 GitHub 最近 commit、release、issue/PR 响应信号。\n- Why it matters: 新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- Evidence: evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n\n### Constraint 10: 下游验证发现风险项\n\n- Trigger: no_demo\n- Host AI rule: 进入安全/权限治理复核队列。\n- Why it matters: 下游已经要求复核，不能在页面中弱化。\n- Evidence: downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n- Hard boundary: 不要把这个坑点包装成已解决、已验证或可忽略，除非后续验证证据明确证明它已经关闭。\n",
"summary": "给宿主 AI 的上下文和工作边界。",
"title": "AI Context Pack / 带给我的 AI"
},
"boundary_risk_card": {
"asset_id": "boundary_risk_card",
"filename": "BOUNDARY_RISK_CARD.md",
"markdown": "# Boundary & Risk Card / 安装前决策卡\n\n项目：coreyhaines31/marketingskills\n\n## Doramagic 试用结论\n\n当前结论：可以进入发布前推荐检查；首次使用仍应从最小权限、临时目录和可回滚配置开始。\n\n## 用户现在可以做\n\n- 可以先阅读 Human Manual，理解项目目的和主要工作流。\n- 可以复制 Prompt Preview 做安装前体验；这只验证交互感，不代表真实运行。\n- 可以把官方 Quick Start 命令放到隔离环境中验证，不要直接进主力环境。\n\n## 现在不要做\n\n- 不要把 Prompt Preview 当成项目实际运行结果。\n- 不要把 metadata-only validation 当成沙箱安装验证。\n- 不要把未验证能力写成“已支持、已跑通、可放心安装”。\n- 不要在首次试用时交出生产数据、私人文件、真实密钥或主力配置目录。\n\n## 安装前检查\n\n- 宿主 AI 是否匹配：claude, claude_code\n- 官方安装入口状态：已发现官方入口\n- 是否在临时目录、临时宿主或容器中验证：必须是\n- 是否能回滚配置改动：必须能\n- 是否需要 API Key、网络访问、读写文件或修改宿主配置：未确认前按高风险处理\n- 是否记录了安装命令、实际输出和失败日志：必须记录\n\n## 当前阻塞项\n\n- 无阻塞项。\n\n## 项目专属踩坑\n\n- 仓库名和安装名不一致（medium）：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 来源证据：Add OpenAI Codex plugin support（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 来源证据：Feature Request: Add Prefix to skills（medium）：可能增加新用户试用和生产接入成本。 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand（medium）：可能影响升级、迁移或版本选择。 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n\n## 风险与权限提示\n\n- no_demo: medium\n\n## 证据缺口\n\n- 暂未发现结构化证据缺口。\n",
"summary": "安装、权限、验证和推荐前风险。",
"title": "Boundary & Risk Card / 边界与风险卡"
},
"human_manual": {
"asset_id": "human_manual",
"filename": "HUMAN_MANUAL.md",
"markdown": "# https://github.com/coreyhaines31/marketingskills 项目说明书\n\n生成时间：2026-05-15 15:47:54 UTC\n\n## 目录\n\n- [Home](#home)\n- [Getting Started](#getting-started)\n- [Skills Architecture](#skills-architecture)\n- [Conversion Optimization Skills](#conversion-skills)\n- [Content and Copy Skills](#content-copy-skills)\n- [SEO and Discovery Skills](#seo-discovery-skills)\n- [Paid Advertising Skills](#paid-advertising-skills)\n- [Analytics and Testing Skills](#analytics-testing-skills)\n- [Retention and Growth Skills](#retention-growth-skills)\n- [Sales and RevOps Skills](#sales-revops-skills)\n\n\n\n## Home\n\n### 相关页面\n\n相关主题：[Getting Started](#getting-started), [Skills Architecture](#skills-architecture)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)\n- [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/schema/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema/references/schema-examples.md)\n\n\n# Home\n\nMarketing Skills is a comprehensive collection of reusable AI agent skills designed for marketing automation, campaign management, and growth engineering tasks. This repository serves as the central hub for marketing-related capabilities that can be integrated into AI agent workflows.\n\n## Overview\n\nThe repository provides pre-built skills for various marketing disciplines including conversion rate optimization, email marketing, SEO, analytics, content creation, and more. Each skill is self-contained with instructions, references, and scripts that enable AI agents to perform marketing-specific tasks.\n\n资料来源：[README.md:1-15]()\n\n## Repository Structure\n\nThe repository follows a modular architecture with three main components:\n\n| Component | Location | Purpose |\n|-----------|----------|---------|\n| Skills | `skills/` | Marketing task instructions for AI agents |\n| CLI Tools | `tools/clis/` | Zero-dependency Node.js scripts for integrations |\n| Integrations | `tools/integrations/` | API documentation and references |\n\n资料来源：[CLAUDE.md:1-20]()\n\n```mermaid\ngraph TD\n subgraph \"Marketing Skills Repository\"\n subgraph \"skills/\"\n CRO[\"CRO Skills\"]\n EMAIL[\"Email Marketing\"]\n SEO[\"SEO & Discovery\"]\n ADS[\"Paid Advertising\"]\n ANALYTICS[\"Analytics & Testing\"]\n CONTENT[\"Content & Copy\"]\n end\n \n subgraph \"tools/\"\n CLIS[\"CLI Tools\"]\n INTEGRATIONS[\"Integration Docs\"]\n end\n \n subgraph \"Documentation\"\n README[\"README.md\"]\n CLAUDE[\"CLAUDE.md\"]\n AGENTS[\"AGENTS.md\"]\n CONTRIBUTING[\"CONTRIBUTING.md\"]\n end\n end\n \n AI_AGENT[\"AI Agent\"] --> SKILLS\n AI_AGENT --> CLIS\n CLIS --> INTEGRATIONS\n```\n\n## Skills Categories\n\nThe repository contains skills organized by marketing discipline:\n\n### Conversion & User Experience\n\n| Skill | Description |\n|-------|-------------|\n| `cro` | Conversion rate optimization for pages, modals, overlays, and paywalls |\n| `form-cro` | Form optimization and behavior analysis |\n\n资料来源：[README.md:45-52]()\n\n### Content & Copywriting\n\n| Skill | Description |\n|-------|-------------|\n| `copywriting` | Marketing page copy generation |\n| `copy-editing` | Edit and polish existing copy |\n| `cold-email` | B2B cold outreach emails and sequences |\n| `emails` | Automated email flows |\n| `social` | Social media content creation |\n| `image` | AI image generation and design optimization |\n\n资料来源：[README.md:53-60]()\n\n### SEO & Discovery\n\n| Skill | Description |\n|-------|-------------|\n| `seo-audit` | Technical and on-page SEO analysis |\n| `ai-seo` | AI search optimization (AEO, GEO, LLMO) |\n| `programmatic-seo` | Scaled page generation |\n| `site-architecture` | Page hierarchy, navigation, URL structure |\n| `competitors` | Comparison and alternative pages |\n| `schema` | Structured data implementation |\n\n资料来源：[README.md:61-68]()\n\n### Paid & Distribution\n\n| Skill | Description |\n|-------|-------------|\n| `ads` | Google, Meta, LinkedIn ad campaigns |\n| `ad-creative` | Bulk ad creative generation and iteration |\n\n资料来源：[README.md:69-72]()\n\n### Measurement & Retention\n\n| Skill | Description |\n|-------|-------------|\n| `analytics` | Event tracking setup |\n| `ab-testing` | Experiment design |\n| `churn-prevention` | Cancel flows, save offers, dunning |\n\n资料来源：[README.md:73-80]()\n\n### Growth Engineering\n\n| Skill | Description |\n|-------|-------------|\n| `co-marketing` | Partner identification and joint campaigns |\n| `free-tools` | Marketing tools and calculators |\n| `referrals` | Referral and affiliate programs |\n| `marketing-ideas` | 140 SaaS marketing ideas |\n| `marketing-psychology` | Mental models and psychology |\n| `launch` | Product launches |\n\n资料来源：[README.md:81-87]()\n\n## Skill Structure\n\nEach skill follows a standardized directory structure:\n\n```\nskills/your-skill-name/\n├── SKILL.md # Required - main instructions\n├── references/ # Optional - additional documentation\n│ └── guide.md\n├── scripts/ # Optional - executable code\n│ └── helper.py\n└── assets/ # Optional - templates, images, data\n └── template.json\n```\n\n资料来源：[CONTRIBUTING.md:18-27]()\n\n### SKILL.md Format\n\nEvery skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: your-skill-name\ndescription: When to use this skill. Include trigger phrases and keywords.\n---\n\n# Your Skill Name\n\nInstructions for the agent go here...\n```\n\n资料来源：[CONTRIBUTING.md:10-18]()\n\n### Frontmatter Requirements\n\n| Field | Required | Constraints |\n|-------|----------|-------------|\n| `name` | Yes | 1-64 chars, lowercase `a-z`, numbers, hyphens. Must match directory name |\n| `description` | Yes | 1-1024 chars. Include trigger phrases |\n| `license` | No | License name (default: MIT) |\n| `metadata` | No | Key-value pairs (author, version, etc.) |\n\n资料来源：[AGENTS.md:45-55]()\n\n## CLI Tools\n\nThe repository includes zero-dependency Node.js scripts (Node 18+) for interacting with various marketing platforms:\n\n| Tool | Purpose |\n|------|---------|\n| `livestorm.js` | Webinar and event management |\n| `optimizely.js` | Experimentation platform |\n\n资料来源：[CLAUDE.md:25-30]()\n\n### CLI Verification Commands\n\n```bash\n# Syntax check\nnode --check tools/clis/.js\n\n# Show usage\nnode tools/clis/.js\n\n# Dry run preview\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[CLAUDE.md:26-32]()\n\n## Integration Documentation\n\nAPI references are provided for various marketing platforms:\n\n### Supported Integrations\n\n| Platform | Documentation | Key Features |\n|----------|---------------|--------------|\n| Postmark | Email delivery, templates, bounces | Transactional email |\n| WordPress | Posts, pages, categories, media | CMS integration |\n| Sanity | Content management, datasets | Structured content |\n| Intercom | Articles, admins, events, contacts | Customer communication |\n| Livestorm | Events, sessions, registrations | Webinar management |\n| Hyperframes | Video generation, HTML frames | Motion content |\n\n资料来源：[tools/integrations/postmark.md:1-35]()\n资料来源：[tools/integrations/sanity.md:1-50]()\n资料来源：[tools/integrations/intercom.md:1-40]()\n资料来源：[tools/integrations/livestorm.md:1-30]()\n\n## Installation Methods\n\nMultiple installation options are available for integrating skills into AI agent projects:\n\n```mermaid\ngraph LR\n A[\"Choose Method\"] --> B[\"Manual Clone\"]\n A --> C[\"Git Submodule\"]\n A --> D[\"Plugin System\"]\n A --> E[\"SkillKit\"]\n A --> F[\"Fork & Customize\"]\n \n B --> B1[\"cp -r skills/* .agents/skills/\"]\n C --> C1[\"git submodule add ...\"]\n D --> D1[\"/plugin install marketing-skills\"]\n E --> E1[\"npx skillkit install coreyhaines31/marketingskills\"]\n F --> F1[\"Custom fork in project\"]\n```\n\n资料来源：[README.md:20-45]()\n\n### Installation Options\n\n| Method | Command | Use Case |\n|--------|---------|----------|\n| Manual Clone | `git clone` + copy | Full control, custom modifications |\n| Git Submodule | `git submodule add` | Easy updates across projects |\n| Plugin Install | `/plugin install marketing-skills` | Quick setup in agent platforms |\n| SkillKit | `npx skillkit install` | Multi-agent support |\n\n资料来源：[README.md:20-40]()\n\n### SkillKit Multi-Agent Support\n\nSkillKit allows installing skills across multiple AI agents:\n\n```bash\n# Install all skills\nnpx skillkit install coreyhaines31/marketingskills\n\n# Install specific skills\nnpx skillkit install coreyhaines31/marketingskills --skill cro copywriting\n\n# List available skills\nnpx skillkit install coreyhaines31/marketingskills --list\n```\n\n资料来源：[README.md:35-42]()\n\n## Contributing\n\nNew skills can be added by following the contribution guidelines:\n\n```mermaid\ngraph TD\n A[\"Create Skill Directory\"] --> B[\"Add SKILL.md\"]\n B --> C[\"Follow Naming Conventions\"]\n C --> D[\"Structure Skill\"]\n D --> E[\"Write Effective Instructions\"]\n E --> F[\"Submit via PR or Issue\"]\n```\n\n资料来源：[CONTRIBUTING.md:1-15]()\n\n### Naming Conventions\n\n- **Directory name**: lowercase, hyphens only (e.g., `emails`)\n- **Name field**: must match directory name exactly\n- **Description**: 1-1024 characters, include trigger phrases\n\n资料来源：[CONTRIBUTING.md:22-25]()\n\n## Version Migration\n\nv2.0 introduced breaking changes including:\n\n- 17 skills renamed\n- `page-cro` + `form-cro` consolidated into single `cro` skill\n\n资料来源：[README.md:48-52]()\n\n## Quick Reference\n\n| Resource | Description |\n|----------|-------------|\n| `skills/*/SKILL.md` | Main skill instructions |\n| `skills/*/references/*` | Additional documentation |\n| `tools/integrations/*.md` | API references |\n| `tools/clis/*.js` | CLI tools |\n\n---\n\n\n\n## Getting Started\n\n### 相关页面\n\n相关主题：[Home](#home), [Skills Architecture](#skills-architecture)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [tools/clis/livestorm.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/livestorm.js)\n\n\n# Getting Started\n\nMarketing Skills is a collection of AI agent skills designed to help with various marketing tasks including copywriting, SEO optimization, paid advertising, analytics, and more. This guide covers installation, verification, and contribution workflows.\n\n## Overview\n\nMarketing Skills provides agents with domain-specific instructions for executing marketing tasks. Skills are content-only files with YAML frontmatter that define when and how to use each capability.\n\n```mermaid\ngraph TD\n A[Marketing Skills Repository] --> B[Skills Directory]\n A --> C[CLI Tools]\n A --> D[Integration References]\n \n B --> B1[copywriting]\n B --> B2[seo-audit]\n B --> B3[ads]\n B --> B4[emails]\n B --> B5[analytics]\n \n C --> C1[Node.js Scripts]\n C --> C2[Zero Dependencies]\n \n D --> D1[Postmark]\n D --> D2[WordPress]\n D --> D3[Intercom]\n```\n\n## Installation\n\nThe repository supports multiple installation methods depending on your AI agent setup.\n\n### Method 1: Claude Desktop\n\nAdd the skills path to your Claude Desktop configuration file:\n\n```json\n{\n \"agent\": {\n \"skills\": {\n \"marketing-skills\": {\n \"command\": \"python\",\n \"args\": [\"-m\", \"agent\", \"skills\", \"install\", \"marketing-skills\"]\n }\n }\n }\n}\n```\n\n资料来源：[README.md:1-10]()\n\n### Method 2: MCP Plugin\n\nFor MCP-compatible agents, install via plugin command:\n\n```bash\n/plugin install marketing-skills\n```\n\n资料来源：[README.md:1-10]()\n\n### Method 3: Clone and Copy\n\nClone the repository and manually copy skills to your agent's skills directory:\n\n```bash\ngit clone https://github.com/coreyhaines31/marketingskills.git\ncp -r marketingskills/skills/* .agents/skills/\n```\n\n资料来源：[README.md:1-10]()\n\n### Method 4: Git Submodule\n\nFor projects requiring version control over dependencies:\n\n```bash\ngit submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills\n```\n\nReference skills from `.agents/marketingskills/skills/`.\n\n资料来源：[README.md:1-10]()\n\n### Method 5: SkillKit\n\nFor multi-agent environments (Claude Code, Cursor, Copilot):\n\n```bash\n# Install all skills\nnpx skillkit install coreyhaines31/marketingskills\n\n# Install specific skills\nnpx skillkit install coreyhaines31/marketingskills --skill cro copywriting\n\n# List available skills\nnpx skillkit install coreyhaines31/marketingskills --list\n```\n\n资料来源：[README.md:1-10]()\n\n## Available Skills\n\nMarketing Skills includes the following categories:\n\n| Category | Skills |\n|----------|--------|\n| **Conversion** | `cro`, `ab-testing` |\n| **Content & Copy** | `copywriting`, `copy-editing`, `cold-email`, `emails`, `social`, `image` |\n| **SEO & Discovery** | `seo-audit`, `ai-seo`, `programmatic-seo`, `site-architecture`, `competitors`, `schema` |\n| **Paid & Distribution** | `ads`, `ad-creative` |\n| **Measurement** | `analytics` |\n| **Retention** | `churn-prevention` |\n| **Growth Engineering** | `co-marketing`, `free-tools`, `referrals` |\n| **Strategy** | `marketing-ideas`, `marketing-psychology`, `launch` |\n\n资料来源：[README.md:1-10]()\n\n## Skill Structure\n\nEach skill resides in its own directory with a standardized structure:\n\n```\nskills/your-skill-name/\n├── SKILL.md # Required - main instructions\n├── references/ # Optional - additional documentation\n│ └── guide.md\n├── scripts/ # Optional - executable code\n│ └── helper.py\n└── assets/ # Optional - templates, images, data\n └── template.json\n```\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n### SKILL.md Format\n\nEvery skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: your-skill-name\ndescription: When to use this skill. Include trigger phrases and keywords that help agents identify relevant tasks.\n---\n\n# Your Skill Name\n\nInstructions for the agent go here...\n```\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n### Frontmatter Field Constraints\n\n| Field | Required | Constraints |\n|-------|----------|-------------|\n| `name` | Yes | 1-64 chars, lowercase `a-z`, numbers, hyphens. Must match directory name. |\n| `description` | Yes | 1-1024 chars. Describe what it does and when to use it. |\n| `license` | No | License name (default: MIT) |\n| `metadata` | No | Key-value pairs (author, version, etc.) |\n\n资料来源：[AGENTS.md:1-50]()\n\n## Verification and Testing\n\n### Skills Validation\n\nSkills are content-only with no build step. Verify manually:\n\n| Check | Command/Action |\n|-------|----------------|\n| YAML frontmatter validity | Parse YAML syntax |\n| `name` field matches directory | Compare values |\n| `name` length constraints | 1-64 chars |\n| `description` length | 1-1024 chars |\n\n资料来源：[AGENTS.md:1-50]()\n\n### CLI Tools Verification\n\nCLI tools are zero-dependency Node.js scripts (Node 18+). Verify with:\n\n```bash\n# Syntax check\nnode --check tools/clis/.js\n\n# Show usage (no args = help)\nnode tools/clis/.js\n\n# Preview request without sending\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[AGENTS.md:1-50]()\n\n### Available CLI Tools\n\n| Tool | Purpose |\n|------|---------|\n| `livestorm.js` | Events, sessions, people, webhooks management |\n| `optimizely.js` | Experiments, pages, projects management |\n\n资料来源：[tools/clis/livestorm.js:1-50]()\n资料来源：[tools/clis/optimizely.js:1-50]()\n\n### CLI Tool Usage Example\n\n```bash\n# Show all available commands\nnode tools/clis/livestorm.js\n\n# Output structure\n{\n commands: {\n ping: 'ping',\n events: 'events [list | get --id | create --title | ...]',\n sessions: 'sessions [...]',\n people: 'people [list --email | get --id ]',\n webhooks: 'webhooks [...]',\n organization: 'organization'\n },\n usage: {\n options: '--page --per-page '\n }\n}\n```\n\n## Adding New Skills\n\n### Step 1: Create the Skill Directory\n\n```bash\nmkdir -p skills/your-skill-name\n```\n\n### Step 2: Create the SKILL.md File\n\nFollow the frontmatter format with required `name` and `description` fields.\n\n### Step 3: Follow Naming Conventions\n\n| Convention | Rule |\n|------------|------|\n| Directory name | lowercase, hyphens only (e.g., `emails`) |\n| Name field | Must match directory name exactly |\n| Description | 1-1024 characters, include trigger phrases |\n\n### Step 4: Structure Your Skill\n\nPlace supporting files in appropriate subdirectories:\n\n- `references/` - Additional documentation\n- `scripts/` - Executable code\n- `assets/` - Templates, images, data files\n\n### Step 5: Write Effective Instructions\n\n- Keep instructions clear and agent-executable\n- Include trigger phrases for skill discovery\n- Provide examples where applicable\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n## Requesting New Skills\n\nYou can suggest new skills by opening a skill request on GitHub:\n\n```bash\nhttps://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml\n```\n\n资料来源：[CONTRIBUTING.md:1-30]()\n\n## Upgrading from v1.x\n\nv2.0 introduces breaking changes:\n\n- 17 skills were renamed\n- `page-cro` and `form-cro` consolidated into single `cro` skill\n- Old v1.x skill folders become stale after upgrade\n\nIf upgrading, remove old skill directories before installing v2.0.\n\n资料来源：[README.md:1-10]()\n\n## Quick Reference\n\n```mermaid\ngraph LR\n A[Install] --> B[Copy to Skills Dir]\n B --> C[Validate Frontmatter]\n C --> D[Agent Ready]\n \n E[Contribute] --> F[Create Skill Dir]\n F --> G[Write SKILL.md]\n G --> H[Add References]\n H --> I[Submit PR]\n```\n\n| Task | Command |\n|------|---------|\n| Clone repository | `git clone https://github.com/coreyhaines31/marketingskills.git` |\n| List skills | `npx skillkit install coreyhaines31/marketingskills --list` |\n| Install specific | `npx skillkit install coreyhaines31/marketingskills --skill ` |\n| Verify CLI syntax | `node --check tools/clis/.js` |\n\n---\n\n\n\n## Skills Architecture\n\n### 相关页面\n\n相关主题：[Home](#home), [Conversion Optimization Skills](#conversion-skills), [Content and Copy Skills](#content-copy-skills), [SEO and Discovery Skills](#seo-discovery-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)\n- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)\n- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)\n- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)\n- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)\n- [skills/cro/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/SKILL.md)\n\n\n# Skills Architecture\n\n## Overview\n\nThe **Marketing Skills** repository is a collection of modular, AI-agent-compatible skills designed to automate and standardize marketing tasks across different platforms and workflows. Each skill is a self-contained unit that provides instructions, references, and optional scripts for AI agents to execute specific marketing functions.\n\nThe architecture follows a content-first approach where skills are defined as markdown files with YAML frontmatter, making them platform-agnostic and easily distributable across different AI agent frameworks including Claude Code, Cursor, Copilot, and custom implementations via SkillKit.\n\n资料来源：[README.md:1-15]()\n\n## Core Concepts\n\n### What is a Skill?\n\nA skill is the fundamental unit of functionality in the Marketing Skills architecture. It consists of:\n\n| Component | Type | Description |\n|-----------|------|-------------|\n| `SKILL.md` | Required | Main instruction file with YAML frontmatter |\n| `references/` | Optional | Additional documentation and guides |\n| `scripts/` | Optional | Executable code (Node.js scripts) |\n| `assets/` | Optional | Templates, images, and data files |\n\n资料来源：[CONTRIBUTING.md:18-26]()\n\n### Skill Hierarchy\n\nThe skills are organized into a hierarchical taxonomy based on marketing function:\n\n```mermaid\ngraph TD\n ROOT[\"Marketing Skills\"]\n ROOT --> CONTENT[\"Content & Copy\"]\n ROOT --> SEO[\"SEO & Discovery\"]\n ROOT --> PAID[\"Paid & Distribution\"]\n ROOT --> MEASURE[\"Measurement & Testing\"]\n ROOT --> RETENTION[\"Retention\"]\n ROOT --> GROWTH[\"Growth Engineering\"]\n ROOT --> STRATEGY[\"Strategy & Monetization\"]\n \n CONTENT --> COPY[\"copywriting\"]\n CONTENT --> EMAILS[\"emails\"]\n CONTENT --> SOCIAL[\"social\"]\n CONTENT --> IMAGE[\"image\"]\n \n SEO --> SEOAUDIT[\"seo-audit\"]\n SEO --> AI[\"ai-seo\"]\n SEO --> ARCH[\"site-architecture\"]\n SEO --> SCHEMA[\"schema\"]\n \n PAID --> ADS[\"ads\"]\n PAID --> ADCREATIVE[\"ad-creative\"]\n \n MEASURE --> ANALYTICS[\"analytics\"]\n MEASURE --> AB[\"ab-testing\"]\n \n RETENTION --> CHURN[\"churn-prevention\"]\n \n GROWTH --> COMARKETING[\"co-marketing\"]\n GROWTH --> REFERRALS[\"referrals\"]\n GROWTH --> FREETOOLS[\"free-tools\"]\n \n STRATEGY --> IDEAS[\"marketing-ideas\"]\n STRATEGY --> PSYCH[\"marketing-psychology\"]\n STRATEGY --> LAUNCH[\"launch\"]\n```\n\n资料来源：[README.md:35-60]()\n\n## Skill Structure Specification\n\n### Directory Naming Conventions\n\nAll skill directories must follow strict naming rules:\n\n| Rule | Requirement | Example |\n|------|-------------|---------|\n| Case | Lowercase only | `emails`, not `Emails` |\n| Separators | Hyphens only | `site-architecture`, not `site_architecture` |\n| Characters | Alphanumeric + hyphens | No spaces, underscores, or special characters |\n| Match | Must match `name` field exactly | Directory `cro` → name: `cro` |\n\n资料来源：[CONTRIBUTING.md:28-32]()\n\n### SKILL.md File Format\n\nEach skill requires a `SKILL.md` file with YAML frontmatter:\n\n```yaml\n---\nname: skill-name\ndescription: When to use this skill. Include trigger phrases and keywords that help agents identify relevant tasks.\n---\n\n# Skill Title\n\nInstructions for the agent go here...\n```\n\n#### Required Frontmatter Fields\n\n| Field | Required | Constraints |\n|-------|----------|-------------|\n| `name` | Yes | 1-64 characters, lowercase `a-z`, numbers, hyphens. Must match directory name exactly |\n| `description` | Yes | 1-1024 characters. Describe what it does and when to use it |\n\n#### Optional Frontmatter Fields\n\n| Field | Default | Description |\n|-------|---------|-------------|\n| `license` | MIT | License name for the skill content |\n| `metadata` | None | Key-value pairs for author, version, etc. |\n\n资料来源：[AGENTS.md:35-50]()\n\n### Skill Directory Structure\n\n```\nskills/your-skill-name/\n├── SKILL.md # Required - main instructions\n├── references/ # Optional - additional documentation\n│ └── guide.md\n├── scripts/ # Optional - executable code\n│ └── helper.py\n└── assets/ # Optional - templates, images, data\n └── template.json\n```\n\n资料来源：[CONTRIBUTING.md:20-27]()\n\n## Skill Categories\n\n### Content & Copy\n\nSkills focused on written content and messaging.\n\n| Skill | Purpose |\n|-------|---------|\n| `copywriting` | Marketing page copy generation |\n| `copy-editing` | Edit and polish existing copy |\n| `cold-email` | B2B cold outreach emails and sequences |\n| `emails` | Automated email flows |\n| `social` | Social media content |\n| `image` | AI image generation, design tools, and optimization |\n\n资料来源：[README.md:38-44]()\n\n### SEO & Discovery\n\nSkills for organic search and content discoverability.\n\n| Skill | Purpose |\n|-------|---------|\n| `seo-audit` | Technical and on-page SEO analysis |\n| `ai-seo` | AI search optimization (AEO, GEO, LLMO) |\n| `programmatic-seo` | Scaled page generation |\n| `site-architecture` | Page hierarchy, navigation, URL structure |\n| `competitors` | Comparison and alternative pages |\n| `schema` | Structured data implementation |\n\n资料来源：[README.md:46-52]()\n\n### Measurement & Testing\n\nSkills for analytics and experimentation.\n\n| Skill | Purpose |\n|-------|---------|\n| `analytics` | Event tracking setup |\n| `ab-testing` | Experiment design and analysis |\n\n资料来源：[README.md:56-58]()\n\n### Retention & Growth\n\nSkills focused on user retention and expansion.\n\n| Category | Skill | Purpose |\n|----------|-------|---------|\n| Retention | `churn-prevention` | Cancel flows, save offers, dunning, payment recovery |\n| Growth | `co-marketing` | Partner identification and joint campaigns |\n| Growth | `free-tools` | Marketing tools and calculators |\n| Growth | `referrals` | Referral and affiliate programs |\n\n资料来源：[README.md:60-66]()\n\n## Integration Architecture\n\n### Installation Methods\n\nThe Marketing Skills architecture supports multiple installation approaches:\n\n```mermaid\ngraph LR\n USER[\"User\"] --> REPO[\"Repository\"]\n REPO --> M1[\"Plugin Install\"]\n REPO --> M2[\"Clone & Copy\"]\n REPO --> M3[\"Git Submodule\"]\n REPO --> M4[\"SkillKit\"]\n \n M1 --> AGENTS[\"Agent Skills Folder\"]\n M2 --> AGENTS\n M3 --> AGENTS\n M4 --> AGENTS\n```\n\n| Method | Command | Best For |\n|--------|---------|----------|\n| Plugin | `/plugin install marketing-skills` | Built-in agent plugin systems |\n| Clone | `git clone` + copy | Manual installation |\n| Submodule | `git submodule add` | Version-controlled projects |\n| SkillKit | `npx skillkit install` | Multi-agent environments |\n\n资料来源：[README.md:8-25]()\n\n### SkillKit Integration\n\nFor multi-agent environments, SkillKit provides unified installation:\n\n```bash\n# Install all skills\nnpx skillkit install coreyhaines31/marketingskills\n\n# Install specific skills\nnpx skillkit install coreyhaines31/marketingskills --skill cro copywriting\n\n# List available skills\nnpx skillkit install coreyhaines31/marketingskills --list\n```\n\n资料来源：[README.md:22-28]()\n\n## Validation & Quality Standards\n\n### Manual Verification Checklist\n\nSince skills are content-only (no build step), manual verification is required:\n\n| Check | Requirement |\n|-------|-------------|\n| YAML frontmatter | Must be valid YAML syntax |\n| Name field | Must match directory name exactly |\n| Name format | 1-64 chars, lowercase alphanumeric and hyphens only |\n| Description | 1-1024 characters |\n\n资料来源：[AGENTS.md:30-35]()\n\n### CLI Tool Validation\n\nCLI tools in `tools/clis/*.js` are zero-dependency Node.js scripts (Node 18+). Verify with:\n\n```bash\n# Syntax check\nnode --check tools/clis/.js\n\n# Show usage (no args = help)\nnode tools/clis/.js\n\n# Preview request without sending\nnode tools/clis/.js --dry-run\n```\n\n资料来源：[CLAUDE.md:28-34]()\n\n## Version Compatibility\n\n### v1.x to v2.0 Migration\n\nv2.0 introduces breaking changes that require migration attention:\n\n| Change Type | Details |\n|-------------|---------|\n| Renamed skills | 17 skills were renamed |\n| Consolidated skills | `page-cro` + `form-cro` merged into single `cro` skill |\n\nIf upgrading from v1.x, stale old-name folders must be removed to avoid conflicts.\n\n资料来源：[README.md:30-35]()\n\n## Tooling & Integrations\n\n### Integration Layer\n\nThe architecture includes a `tools/integrations/` directory for third-party service integrations:\n\n| Integration | Purpose |\n|-------------|---------|\n| `postmark.md` | Email delivery and tracking API |\n| `zoominfo.md` | Contact and company enrichment |\n| `sanity.md` | CMS content management |\n| `wordpress.md` | WordPress REST API |\n| `optimizely.js` | Experimentation platform CLI |\n| `livestorm.js` | Event and session management CLI |\n\nThese integrations follow a consistent documentation pattern with API endpoints, example payloads, and key object descriptions.\n\n资料来源：[tools/integrations/*.md](https://github.com/coreyhaines31/marketingskills/tree/main/tools/integrations)\n\n## Contributing Workflow\n\n### Adding a New Skill\n\n```mermaid\ngraph TD\n START[\"Create skill directory\"] --> YAML[\"Create SKILL.md with frontmatter\"]\n YAML --> STRUCTURE[\"Structure skill contents\"]\n STRUCTURE --> VALIDATE[\"Validate naming conventions\"]\n VALIDATE --> TEST[\"Test with AI agent\"]\n TEST --> SUBMIT[\"Submit via PR or issue\"]\n```\n\n1. Create the skill directory: `mkdir -p skills/your-skill-name`\n2. Create the `SKILL.md` file with required YAML frontmatter\n3. Follow naming conventions (lowercase, hyphens only)\n4. Structure with optional `references/`, `scripts/`, and `assets/` directories\n5. Write clear instructions with trigger phrases for agent activation\n\n资料来源：[CONTRIBUTING.md:10-40]()\n\n## References\n\n- [Agent Skills Specification](https://agentskills.io/specification.md) - Industry standard for skill definitions\n- [SkillKit Repository](https://github.com/rohitg00/skillkit) - Multi-agent skill management\n\n---\n\n\n\n## Conversion Optimization Skills\n\n### 相关页面\n\n相关主题：[Analytics and Testing Skills](#analytics-testing-skills), [Content and Copy Skills](#content-copy-skills), [Retention and Growth Skills](#retention-growth-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/cro/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/SKILL.md)\n- [skills/cro/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/references/experiments.md)\n- [skills/cro/references/form.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/references/form.md)\n- [skills/signup/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/signup/SKILL.md)\n- [skills/onboarding/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/onboarding/SKILL.md)\n- [skills/onboarding/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/onboarding/references/experiments.md)\n- [skills/popups/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/popups/SKILL.md)\n- [skills/paywalls/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/paywalls/SKILL.md)\n- [skills/paywalls/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/paywalls/references/experiments.md)\n\n\n# Conversion Optimization Skills\n\n## Overview\n\nConversion Optimization Skills (CRO) in the marketingskills repository encompass a suite of specialized skills designed to maximize user conversion rates across different touchpoints in the customer journey. These skills focus on optimizing key conversion moments including signup flows, onboarding sequences, popup interactions, and paywall presentations.\n\n## Skill Architecture\n\nThe conversion optimization module is structured around several interconnected skills that address different stages of the user conversion funnel:\n\n```mermaid\ngraph TD\n CRO[Conversion Rate Optimization] --> SIGNUP[Signup Flow]\n CRO --> ONBOARDING[Onboarding Sequences]\n CRO --> POPUPS[Popup Strategy]\n CRO --> PAYWALLS[Paywall Optimization]\n \n SIGNUP --> FORM[Form Optimization]\n ONBOARDING --> EXP[Experimentation]\n POPUPS --> EXP\n PAYWALLS --> EXP\n \n EXP --> DATA[Analytics & Measurement]\n```\n\n## Core Conversion Optimization Skill (cro)\n\nThe central `cro` skill provides foundational methodologies for improving conversion rates across any touchpoint. It consolidates previously separate `page-cro` and `form-cro` skills into a unified approach.\n\n### Experimentation Framework\n\nThe CRO skill emphasizes systematic experimentation to validate optimization hypotheses. The experimentation methodology follows a structured approach:\n\n1. **Hypothesis Formation** - Define specific, measurable hypotheses about user behavior\n2. **Variant Design** - Create alternative versions with single variable changes\n3. **Traffic Allocation** - Distribute visitors across control and variant groups\n4. **Statistical Validation** - Determine significance using appropriate statistical methods\n5. **Iteration Cycle** - Apply learnings to subsequent optimization rounds\n\n### Form Optimization\n\nForm optimization represents a critical subset of CRO, focusing on reducing friction in data collection touchpoints:\n\n| Optimization Area | Key Principles | Impact |\n|------------------|----------------|--------|\n| Field Count | Minimize required fields to essential data only | Reduces cognitive load |\n| Field Order | Place easiest fields first | Builds momentum |\n| Labels | Use clear, descriptive labels | Reduces confusion |\n| Validation | Real-time inline validation | Prevents frustration |\n| Autocomplete | Enable browser autocomplete where appropriate | Speeds completion |\n\n## Signup Flow Skill\n\nThe `signup` skill addresses the critical first conversion point where visitors become registered users. It provides templates and best practices for:\n\n- **Progressive disclosure** - Reveal additional fields only when needed\n- **Social signup integration** - OAuth flows for Google, GitHub, and other providers\n- **Email verification flows** - Handle verification states gracefully\n- **Error recovery** - Guide users through validation failures\n\n## Onboarding Sequences\n\nThe `onboarding` skill focuses on post-signup engagement and activation. Effective onboarding directly impacts:\n\n- Time to first value (TTFV)\n- Day-7 and Day-30 retention rates\n- Feature adoption breadth\n\n### Onboarding Experiment Patterns\n\nOnboarding optimization benefits from continuous experimentation. Common experiment categories include:\n\n| Experiment Type | Description | Success Metric |\n|----------------|-------------|----------------|\n| Tooltip placement | Where and when guidance appears | Feature discovery rate |\n| Walkthrough length | Number of steps in initial tour | Completion rate |\n| Skip options | Immediate access to product vs. forced tour | Long-term engagement |\n| Checklist style | Gamified vs. straightforward checklists | Activation rate |\n\n## Popup Strategy\n\nThe `popups` skill provides guidance on leveraging modals and overlays for conversion without degrading user experience. Key principles include:\n\n- **Trigger timing** - Exit intent, scroll depth, time on page\n- **Frequency capping** - Prevent popup fatigue\n- **Personalization** - Match content to user segments\n- **Mobile considerations** - Full-screen overlays vs. banners\n\n## Paywall Optimization\n\nThe `paywalls` skill addresses conversion moments where users encounter monetization barriers. Optimization strategies include:\n\n- **Metered paywall calibration** - Free article limits that balance traffic and conversion\n- **Upgrade prompts** - When and how to present upgrade opportunities\n- **Feature differentiation** - Clearly communicating free vs. paid tier capabilities\n- **Dunning sequences** - Recovering failed payments and reducing churn\n\n### Paywall Experiment Variables\n\n| Variable | Options | Considerations |\n|----------|---------|----------------|\n| Display trigger | Scroll %, time on site, exit intent | User intent signals |\n| Hard vs. soft | Complete block vs. partial preview | Revenue vs. engagement |\n| Pricing presentation | Monthly vs. annual emphasis | Perceived value |\n| CTA copy | Action-oriented vs. benefit-oriented | Conversion psychology |\n\n## Integration with Analytics\n\nConversion optimization skills integrate with the broader analytics skill to enable data-driven decisions:\n\n- **Event tracking** - Capture micro-conversions throughout flows\n- **Funnel analysis** - Identify drop-off points\n- **A/B testing infrastructure** - Support for controlled experiments\n- **Attribution modeling** - Understand which touchpoints drive conversions\n\n## Skill Metadata Schema\n\nConversion optimization skills follow the standard skill metadata schema:\n\n```yaml\n---\nname: cro\ndescription: Conversion rate optimization methodologies for improving conversion rates across signup, onboarding, and monetization touchpoints.\nlicense: MIT\nmetadata:\n version: 2.0\n author: marketingskills\n---\n```\n\n## Related Skills\n\nThe conversion optimization ecosystem connects to several adjacent skills:\n\n- **seo-audit** - Technical optimization supporting conversion\n- **ab-testing** - Experimental methodology foundation\n- **analytics** - Measurement and data infrastructure\n- **emails** - Post-conversion nurture sequences\n- **schema** - Structured data for search appearance optimization\n\n## Best Practices Summary\n\n1. **Start with analysis** - Identify drop-off points before implementing changes\n2. **One variable at a time** - Isolate changes to understand impact\n3. **Respect statistical significance** - Avoid decisions based on insufficient sample sizes\n4. **Mobile-first** - Optimize for mobile conversion flows first\n5. **Continuous iteration** - Treat optimization as an ongoing process, not a one-time effort\n\n---\n\n\n\n## Content and Copy Skills\n\n### 相关页面\n\n相关主题：[Conversion Optimization Skills](#conversion-skills), [SEO and Discovery Skills](#seo-discovery-skills), [Sales and RevOps Skills](#sales-revops-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/copywriting/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/SKILL.md)\n- [skills/copywriting/references/copy-frameworks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/references/copy-frameworks.md)\n- [skills/copywriting/references/natural-transitions.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/references/natural-transitions.md)\n- [skills/copy-editing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skkills/copy-editing/SKILL.md)\n- [skills/cold-email/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/SKILL.md)\n- [skills/cold-email/references/frameworks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/frameworks.md)\n- [skills/cold-email/references/subject-lines.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/subject-lines.md)\n- [skills/cold-email/references/personalization.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/personalization.md)\n- [skills/emails/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/emails/SKILL.md)\n- [skills/emails/references/sequence-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/emails/references/sequence-templates.md)\n- [skills/social/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social/SKILL.md)\n- [skills/social/references/post-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social/references/post-templates.md)\n\n\n# Content and Copy Skills\n\nThe Content and Copy Skills module within the Marketing Skills repository encompasses a comprehensive suite of skills designed to generate, refine, and distribute marketing copy across multiple channels. These skills form the core communication layer of any marketing operation, enabling AI agents to produce professional-grade content that spans marketing pages, email campaigns, cold outreach, and social media.\n\n## Overview and Architecture\n\nThe Content and Copy Skills are organized into six distinct but interconnected skill areas, each addressing a specific content creation or refinement use case. The skills work both independently and in combination to support complete content workflows from initial drafting through final publication.\n\n```mermaid\ngraph TD\n COPY[\"Copywriting Marketing Page Copy\"] --> EDIT[\"Copy-Editing Polish & Refine\"]\n COPY --> EMAIL[\"Automated Emails Email Flows\"]\n COLD[\"Cold Email B2B Outreach\"] --> EMAIL\n EMAIL --> SOCIAL[\"Social Media Content Distribution\"]\n COPY --> SOCIAL\n \n style COPY fill:#e1f5fe\n style EDIT fill:#fff3e0\n style EMAIL fill:#e8f5e9\n style COLD fill:#fce4ec\n style SOCIAL fill:#f3e5f5\n```\n\nThe primary skills in this module include:\n\n| Skill | Directory | Purpose |\n|-------|-----------|---------|\n| **Copywriting** | `skills/copywriting/` | Generate marketing page copy and promotional content |\n| **Copy-Editing** | `skills/copy-editing/` | Edit and polish existing copy to professional standards |\n| **Cold Email** | `skills/cold-email/` | B2B cold outreach emails and multi-step sequences |\n| **Emails** | `skills/emails/` | Automated email flows and drip campaigns |\n| **Social** | `skills/social/` | Social media content creation and posting strategy |\n\n资料来源：[README.md:1-20]()\n\n## Copywriting Skill\n\nThe copywriting skill specializes in generating persuasive marketing copy for web pages, landing pages, and promotional materials. It provides AI agents with the frameworks and techniques needed to produce compelling marketing narratives that drive conversions.\n\n### Skill Structure\n\nEach copywriting skill implementation follows a standardized directory structure:\n\n```\nskills/copywriting/\n├── SKILL.md # Main instructions and usage guidelines\n├── references/\n│ ├── copy-frameworks.md # Proven copywriting frameworks\n│ └── natural-transitions.md # Smooth copy transition techniques\n├── scripts/ # Optional automation helpers\n└── assets/ # Templates and example data\n```\n\n资料来源：[CONTRIBUTING.md:1-20]()\n\n### Core Copywriting Frameworks\n\nThe copywriting skill provides access to several proven frameworks for structuring marketing copy. These frameworks help ensure that generated content follows established best practices for persuasion and conversion optimization.\n\n**Problem-Agitate-Solve (PAS)** is the foundational framework that identifies customer pain points, amplifies the emotional impact of those problems, and then introduces the product or service as the solution.\n\n**Before-After-Bridge** presents the customer's current painful state, shows the desired future state after solving the problem, and positions the product as the bridge between these two states.\n\n**Feature-Benefit Bridge** transforms technical product features into tangible benefits that resonate with customer needs and desires.\n\n资料来源：[skills/copywriting/references/copy-frameworks.md](skills/copywriting/references/copy-frameworks.md)\n\n### Natural Transitions\n\nEffective marketing copy requires smooth transitions between sections to maintain reader engagement and logical flow. The natural transitions reference guide provides techniques for connecting:\n\n- Headlines to subheadings\n- Benefits to proof points\n- Objections to responses\n- CTAs to supporting context\n\nThese transitions prevent jarring shifts in tone or topic that can cause readers to disengage from the content.\n\n资料来源：[skills/copywriting/references/natural-transitions.md](skills/copywriting/references/natural-transitions.md)\n\n## Copy-Editing Skill\n\nThe copy-editing skill focuses on refining and polishing existing marketing copy to professional standards. Unlike copywriting which creates new content, copy-editing improves material that has already been drafted.\n\n### Editorial Standards\n\nThe skill enforces several key editorial standards:\n\n- **Grammar and Syntax**: Ensures proper sentence structure, verb agreement, and punctuation usage\n- **Consistency**: Maintains uniform tone, style, and terminology throughout the document\n- **Clarity**: Removes ambiguous phrases and complex jargon that may confuse readers\n- **Pacing**: Adjusts sentence length and paragraph structure for optimal readability\n- **Voice**: Ensures the copy maintains consistent brand voice and tone\n\n### Editing Workflow\n\nThe copy-editing process follows a systematic approach:\n\n1. **Structural Review**: Examine overall document organization and logical flow\n2. **Line Editing**: Refine individual sentences for clarity and impact\n3. **Copy Editing**: Check grammar, punctuation, and style consistency\n4. **Final Polish**: Verify formatting, spacing, and visual presentation\n\n资料来源：[skills/copy-editing/SKILL.md](skills/copy-editing/SKILL.md)\n\n## Cold Email Skill\n\nThe cold email skill enables AI agents to craft effective B2B cold outreach campaigns. This skill addresses the unique challenges of reaching prospects who have no prior relationship with the sender and must be convinced to engage.\n\n### Cold Email Components\n\nEach cold email follows a structured format that maximizes response rates:\n\n```mermaid\ngraph LR\n A[\"Subject Line Personalized Hook\"] --> B[\"Opening Immediate Value\"]\n B --> C[\"Body Problem/Solution\"]\n C --> D[\"CTA Clear Next Step\"]\n D --> E[\"Signature Credibility\"]\n \n style A fill:#ffcdd2\n style B fill:#c8e6c9\n style C fill:#bbdefb\n style D fill:#fff9c4\n style E fill:#e1bee7\n```\n\n### Subject Line Strategies\n\nSubject lines determine whether cold emails get opened. The skill provides multiple approaches:\n\n- **Curiosity Gap**: Creates intrigue by implying missing information\n- **Personalization**: Uses recipient's name, company, or recent activity\n- **Value Proposition**: Clearly states the benefit of reading\n- **Question Format**: Engages through rhetorical or genuine questions\n- **Social Proof**: References mutual connections or recognizable companies\n\n资料来源：[skills/cold-email/references/subject-lines.md](skills/cold-email/references/subject-lines.md)\n\n### Personalization Techniques\n\nEffective cold emails feel personalized rather than mass-sent. The skill teaches several personalization dimensions:\n\n- **Company Research**: Reference recent news, funding rounds, or product launches\n- **Role-Based Messaging**: Tailor content to the recipient's job function\n- **Industry Context**: Reference challenges specific to their sector\n- **Mutual Connections**: Mention shared contacts or associations\n- **Behavioral Triggers**: Reference actions like conference attendance or content consumption\n\n资料来源：[skills/cold-email/references/personalization.md](skills/cold-email/references/personalization.md)\n\n### Cold Email Frameworks\n\nThe skill implements several proven outreach frameworks:\n\n**AIDA (Attention-Interest-Desire-Action)** guides the prospect through a logical progression from initial awareness to taking action.\n\n**The 4Ps (Problem-Preview-Proof-Promise)** opens with the prospect's problem, offers a preview of the solution, provides proof through social proof or case studies, and promises a specific outcome.\n\n**The 5-Step Icebreaker** uses a series of low-commitment questions or observations to establish rapport before making an ask.\n\n资料来源：[skills/cold-email/references/frameworks.md](skills/cold-email/references/frameworks.md)\n\n## Automated Emails Skill\n\nThe emails skill handles the creation of automated email flows, including welcome sequences, nurture campaigns, onboarding series, and re-engagement sequences. These automated communications operate without direct human intervention once initially configured.\n\n### Email Sequence Types\n\n| Sequence Type | Purpose | Typical Length | Primary Goal |\n|--------------|---------|----------------|---------------|\n| Welcome Series | Introduce new subscribers to the brand | 3-5 emails | Engagement, education |\n| Nurture Sequence | Build relationships with leads | 5-10 emails | Trust building |\n| Onboarding | Help customers use the product | 5-15 emails | Activation, adoption |\n| Re-engagement | Win back inactive subscribers | 3-5 emails | Retention |\n| Post-Purchase | Follow up after transactions | 2-5 emails | Satisfaction, upsells |\n\n资料来源：[skills/emails/SKILL.md](skills/emails/SKILL.md)\n\n### Sequence Templates\n\nThe skill includes pre-built sequence templates that can be customized for specific use cases. Each template includes:\n\n- Email subject line variations\n- Optimal send timing between emails\n- Content structure for each message\n- Fallback sequences for non-responders\n- Success metrics and milestones\n\n资料来源：[skills/emails/references/sequence-templates.md](skills/emails/references/sequence-templates.md)\n\n### Email Components\n\nAll emails generated by this skill follow a consistent structure:\n\n**Subject Line**: Optimized for inbox placement and open rates, incorporating personalization tokens and preview text optimization.\n\n**Preheader**: The preview text that appears after the subject line in most email clients, providing additional context.\n\n**Email Body**: The main content, formatted for readability with appropriate spacing, hierarchy, and visual elements.\n\n**Call to Action**: Clear, prominent CTAs with multiple variations for A/B testing.\n\n**Footer**: Required legal information, unsubscribe links, and physical address.\n\n## Social Media Skill\n\nThe social skill enables creation of social media content across multiple platforms. It handles the unique requirements of each platform while maintaining consistent brand messaging.\n\n### Platform Adaptations\n\nEach social platform has distinct characteristics that require content adaptation:\n\n| Platform | Content Style | Optimal Length | Best For |\n|----------|--------------|----------------|----------|\n| LinkedIn | Professional, thought leadership | 150-300 words | B2B content |\n| Twitter/X | Concise, timely, conversational | 100-280 characters | News, updates |\n| Instagram | Visual-first, story-driven | Caption 125-150 words | Lifestyle, products |\n| Facebook | Community-focused, varied format | 40-80 words | Engagement |\n\n资料来源：[skills/social/SKILL.md](skills/social/SKILL.md)\n\n### Post Templates\n\nThe skill provides templates for common social media post types:\n\n- **Educational Posts**: Tips, how-tos, and industry insights\n- **Promotional Posts**: Product features, offers, and announcements\n- **Engagement Posts**: Questions, polls, and discussion starters\n- **Social Proof Posts**: Testimonials, case studies, user-generated content\n- **Behind-the-Scenes**: Team features, company culture, process insights\n\n资料来源：[skills/social/references/post-templates.md](skills/social/references/post-templates.md)\n\n## Integration Workflows\n\nThe Content and Copy Skills are designed to work together in integrated workflows that span the entire content lifecycle.\n\n```mermaid\ngraph TD\n DRAFT[\"Draft Copy Copywriting\"] --> EDIT[\"Edit & Polish Copy-Editing\"]\n EDIT --> DIST[\"Distribute Content\"]\n \n DIST --> COLD[\"Cold Outreach Cold Email\"]\n DIST --> AUTO[\"Automated Flows Emails\"]\n DIST --> SOCIAL[\"Social Posts Social Media\"]\n \n COLD --> TRACK[\"Track & Optimize\"]\n AUTO --> TRACK\n SOCIAL --> TRACK\n \n TRACK --> INSIGHTS[\"Insights Analytics\"]\n INSIGHTS --> DRAFT\n \n style DRAFT fill:#e3f2fd\n style EDIT fill:#fff8e1\n style DIST fill:#f1f8e9\n style COLD fill:#fce4ec\n style AUTO fill:#e8f5e9\n style SOCIAL fill:#f3e5f5\n style TRACK fill:#eceff1\n style INSIGHTS fill:#e0f7fa\n```\n\n### Typical Content Pipeline\n\n1. **Initial Draft**: Use copywriting skill to generate initial marketing copy\n2. **Refinement**: Apply copy-editing skill to polish and professionalize the copy\n3. **Adaptation**: Transform the core copy into platform-specific variations for cold email, automated emails, and social posts\n4. **Personalization**: Apply personalization techniques from cold email and social skills\n5. **Scheduling**: Organize content into appropriate sending schedules\n6. **Measurement**: Track engagement metrics to inform future iterations\n\n## Quality Standards\n\nAll Content and Copy Skills adhere to consistent quality standards:\n\n### Voice and Tone Guidelines\n\n| Aspect | Standard |\n|--------|----------|\n| **Perspective** | Second person (\"you\") for reader focus |\n| **Tense** | Present tense for immediacy, future tense for promises |\n| **Complexity** | Plain language; avoid jargon unless appropriate |\n| **Sentence Length** | 15-25 words average; mix lengths for rhythm |\n| **Paragraph Length** | 2-4 sentences maximum for digital content |\n\n### SEO Considerations\n\nContent generated by these skills should incorporate basic SEO principles:\n\n- Primary keywords in headlines and early in content\n- Natural keyword density without stuffing\n- Clear hierarchical structure with H2 and H3 headings\n- Internal linking opportunities identified\n- Meta descriptions and title tags for web content\n\n### Compliance Requirements\n\nFor regulated industries or jurisdictions, skills include safeguards for:\n\n- Clear disclosure of paid promotions and sponsored content\n- Proper attribution for third-party claims\n- Accessibility standards (alt text, readable contrast)\n- Email unsubscribe compliance\n\n## Best Practices\n\n### Copywriting Best Practices\n\n- Lead with the customer's problem, not the product\n- Use specific numbers and statistics for credibility\n- Include social proof early in the copy\n- Make the CTA specific and action-oriented\n- Test multiple headline variations\n\n### Email Best Practices\n\n- Personalize subject lines and preview text\n- Send at optimal times for the target audience\n- Maintain consistent sender identity\n- Use a single clear CTA per email\n- Include plain text alternatives\n\n### Cold Email Best Practices\n\n- Research prospects before reaching out\n- Lead with value, not immediate asks\n- Keep emails short and scannable\n- Follow up multiple times with different angles\n- Track metrics and iterate based on results\n\n## Related Skills\n\nThe Content and Copy Skills connect to other marketing skills in the repository:\n\n- **CRO (Conversion Rate Optimization)**: Optimizes copy for conversions\n- **Analytics**: Measures content performance\n- **A/B Testing**: Tests copy variations\n- **SEO Audit**: Ensures content is discoverable\n- **Programmatic SEO**: Scales content production\n\n## Conclusion\n\nThe Content and Copy Skills module provides a comprehensive toolkit for generating, refining, and distributing marketing content across all major channels. By leveraging proven frameworks, templates, and best practices, AI agents can produce professional-grade copy that drives engagement and conversions. The modular design allows teams to use individual skills for specific needs or combine them into complete content workflows for maximum efficiency.\n\n---\n\n\n\n## SEO and Discovery Skills\n\n### 相关页面\n\n相关主题：[Content and Copy Skills](#content-copy-skills), [Paid Advertising Skills](#paid-advertising-skills)\n\n\nRelated Source Files\n\n以下源码文件用于生成本页说明：\n\n- [skills/seo-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/SKILL.md)\n- [skills/seo-audit/references/ai-writing-detection.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/references/ai-writing-detection.md)\n- [skills/ai-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/SKILL.md)\n- [skills/ai-seo/references/platform-ranking-factors.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/platform-ranking-factors.md)\n- [skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md)\n- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)\n- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)\n- [skills/competitors/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitors/SKILL.md)\n- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)\n- [skills/schema/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema/SKILL.md)\n- [skills/content-strategy/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/content-strategy/SKILL.md)\n\n\n# SEO and Discovery Skills\n\nThe SEO and Discovery Skills module encompasses a comprehensive suite of marketing automation capabilities designed to optimize organic search visibility, enhance content discoverability, and improve overall site architecture for search engines and AI-powered platforms.\n\n## Overview\n\nThis skill set addresses the complete spectrum of search engine optimization and content discovery requirements, from technical site audits to AI-driven content optimization. The skills are designed to work both independently and as an integrated system, enabling marketing teams to implement data-driven SEO strategies at scale.\n\n### Skill Categories\n\n| Category | Primary Skills | Purpose |\n|----------|---------------|---------|\n| **Technical SEO** | `seo-audit` | Technical and on-page SEO analysis |\n| **AI Optimization** | `ai-seo` | AI search optimization (AEO, GEO, LLMO) |\n| **Scale SEO** | `programmatic-seo` | Scaled page generation |\n| **Site Structure** | `site-architecture` | Page hierarchy, navigation, URL structure |\n| **Competitor Analysis** | `competitors`, `competitor-profiling` | Comparison and alternative pages |\n| **Structured Data** | `schema` | Structured data implementation |\n\n## Architecture\n\n```mermaid\ngraph TD\n A[SEO Strategy] --> B[Site Architecture]\n A --> C[Content Strategy]\n B --> D[Navigation Patterns]\n B --> E[URL Structure]\n C --> F[Programmatic SEO]\n C --> G[Schema Markup]\n A --> H[Competitor Analysis]\n H --> I[Competitor Profiling]\n H --> J[Competitor Comparison]\n F --> K[AI SEO Optimization]\n G --> K\n K --> L[AI Writing Detection]\n A --> M[SEO Audit]\n M --> N[Technical Analysis]\n M --> O[On-Page Analysis]\n```\n\n## Site Architecture Skill\n\nThe `site-architecture` skill focuses on establishing optimal page hierarchies, navigation systems, and URL structures that both users and search engines can efficiently navigate.\n\n### Hub-and-Spoke Content Model\n\nThis model demonstrates the relationship between a central hub page connecting to multiple spoke articles, with spokes linking to each other for cross-navigation.\n\n```mermaid\ngraph TD\n HUB[\"SEO Guide (Hub Page)\"]\n HUB --> S1[\"Keyword Research\"]\n HUB --> S2[\"On-Page SEO\"]\n HUB --> S3[\"Technical SEO\"]\n HUB --> S4[\"Link Building\"]\n S1 -.-> S2\n S2 -.-> S3\n S3 -.-> S4\n \n style HUB fill:#f9f,stroke:#333,stroke-width:2px\n```\n\nLegend:\n- Solid lines indicate primary hub-spoke links\n- Dashed lines indicate cross-links between spokes\n\n### Internal Linking Flow\n\nThe internal linking structure connects different site sections to distribute page authority effectively.\n\n```mermaid\ngraph LR\n subgraph \"Marketing\"\n HOME[\"Homepage\"]\n FEAT[\"Features\"]\n PRICE[\"Pricing\"]\n end\n \n subgraph \"Content\"\n BLOG[\"Blog\"]\n GUIDE[\"Guides\"]\n CASE[\"Case Studies\"]\n end\n \n subgraph \"Product\"\n DOCS[\"Docs\"]\n API[\"API Ref\"]\n CHANGE[\"Changelog\"]\n end\n \n HOME --> FEAT\n HOME --> BLOG\n BLOG --> FEAT\n BLOG --> CASE\n CASE --> FEAT\n CASE --> PRICE\n FEAT --> DOCS\n GUIDE --> BLOG\n GUIDE --> DOCS\n```\n\n### Navigation Patterns\n\n#### Breadcrumb Standards\n\nBreadcrumbs provide users with a clear path back to the site root and help search engines understand page hierarchy.\n\n**Standard Format:**\n```\nHome > Features > Analytics\nHome > Blog > SEO Category > How to Do Keyword Research\nHome > Docs > API Reference > Authentication\n```\n\n**Rules:**\n- Use `>` or `/` as separators consistently\n- Every segment must be a link except the current page\n- Current page appears as plain text (not linked)\n- Omit the current page if the title is already visible as an H1\n\n#### Schema Markup Implementation\n\nBreadcrumb schema markup improves search result appearance through rich snippets.\n\n```html\n\n```\n\n## SEO Audit Skill\n\nThe `seo-audit` skill provides comprehensive technical and on-page SEO analysis capabilities to identify optimization opportunities and technical issues.\n\n### AI Writing Detection\n\nThe SEO audit system includes mechanisms for detecting AI-generated content, which has become increasingly important as search engines refine their algorithms to evaluate content quality.\n\n**Key Detection Areas:**\n- Linguistic pattern analysis\n- Uniqueness scoring\n- Content authenticity verification\n\n资料来源：[skills/seo-audit/references/ai-writing-detection.md]()\n\n### Technical SEO Components\n\n| Component | Description |\n|-----------|-------------|\n| Crawlability Analysis | Site structure accessibility for search bots |\n| Indexability Assessment | Page indexing status and coverage |\n| Meta Tag Evaluation | Title, description, and Open Graph tags |\n| Content Quality | Duplicate content, thin content identification |\n| Performance Metrics | Core Web Vitals alignment |\n\n## AI SEO Skill\n\nThe `ai-seo` skill addresses the emerging discipline of optimizing content for AI-powered search platforms and generative engines.\n\n### Generative Engine Optimization (GEO)\n\nGEO focuses on optimizing content for citation by AI assistants including ChatGPT, Claude, Perplexity, and Gemini.\n\n### GEO Content Patterns\n\n#### E-E-A-T Emphasis Block\n\nE-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) serves as the cornerstone of Google's content quality evaluation.\n\n```markdown\nE-E-A-T is the cornerstone of Google's content quality evaluation. Google's Search Quality Rater Guidelines confirm that trust is the most critical factor, stating that \"untrustworthy pages have low E-E-A-T no matter how experienced, expert, or authoritative they may seem.\" This means content creators must prioritize transparency and accuracy above all other optimization tactics.\n```\n\n#### Statistic Citation Block\n\nStatistics increase AI citation rates by 15-30%. Always include sources.\n\n```markdown\nMobile optimization is no longer optional for SEO success. According to Google's 2024 Core Web Vitals report, 70% of web traffic now comes from mobile devices, and pages failing mobile usability standards see 24% higher bounce rates.\n```\n\n#### Self-Contained Answer Block\n\nCreate quotable, standalone statements that AI systems can extract directly.\n\n```markdown\n**[Topic/Question]**: [Complete, self-contained answer that makes sense without additional context. Include specific details, numbers, or examples in 2-3 sentences.]\n```\n\n**Example:**\n```markdown\n**Ideal blog post length for SEO**: The optimal length for SEO blog posts is 1,500-2,500 words for competitive topics. This range allows comprehensive topic coverage while maintaining reader engagement. HubSpot research shows long-form content earns 77% more backlinks than short articles, directly impacting search rankings.\n```\n\n#### Evidence Sandwich Block\n\nStructure claims with evidence for maximum credibility.\n\n```markdown\n[Opening claim statement].\n\nEvidence supporting this includes:\n- [Data point 1 with source]\n- [Data point 2 with source]\n- [Data point 3 with source]\n\n[Concluding statement connecting evidence to actionable insight].\n```\n\n### Domain-Specific GEO Tactics\n\nDifferent content domains benefit from different authority signals:\n\n| Domain | Authority Signals |\n|--------|------------------|\n| **Technology** | Technical precision, version numbers, official documentation, code examples |\n| **Health/Medical** | Peer-reviewed studies with publication details |\n| **Finance** | Regulatory compliance, expert credentials, data sources |\n| **E-commerce** | Product specifications, user reviews, pricing transparency |\n\n### FAQ Block Pattern\n\nUse for \"How do I...\", \"What is...\", and \"Why...\" queries that commonly appear in featured snippets.\n\n```markdown\n**[Question]**: [Direct answer in the first sentence]. [Supporting context in 2-3 additional sentences].\n```\n\n**Tips for FAQ questions:**\n- Use natural question phrasing (\"How do I...\" not \"How does one...\")\n- Include question words: what, how, why, when, where, who, which\n- Match \"People Also Ask\" queries from search results\n- Keep answers between 50-100 words\n\n### Listicle Block Pattern\n\nUse for \"Best [X]\", \"Top [X]\", \"[Number] ways to [X]\" queries.\n\n```markdown\n## [Number] Best [Items] for [Goal/Purpose]\n\n[1-2 sentence intro establishing context and selection criteria]\n\n### 1. [Item Name]\n\n[Why it's included in 2-3 sentences with specific benefits]\n```\n\n## Programmatic SEO Skill\n\nThe `programmatic-seo` skill enables scaled page generation for targeting long-tail keywords and creating comprehensive content at scale.\n\n### When to Use Programmatic SEO\n\n- High-intent keywords with commercial value\n- Template-based content with consistent structure\n- Resource pages, location pages, or comparison pages\n- Integration with product databases or data sources\n\n### Content Types\n\n| Type | Use Case | Example |\n|------|----------|---------|\n| **Location Pages** | Local SEO targeting | `/locations/city-name` |\n| **Comparison Pages** | Product comparisons | `/compare/product-a-vs-product-b` |\n| **Resource Hubs** | Curated resource collections | `/resources/best-tools` |\n| **Template Libraries** | Downloadable resources | `/templates/marketing-plan` |\n\n## Schema Skill\n\nThe `schema` skill provides structured data implementation guidelines for enhancing search result appearance through rich snippets.\n\n### Article / BlogPosting Schema\n\n```json\n{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Article\",\n \"headline\": \"How to Implement Schema Markup\",\n \"image\": \"https://example.com/image.jpg\",\n \"datePublished\": \"2024-01-15T08:00:00+00:00\",\n \"dateModified\": \"2024-01-20T10:00:00+00:00\",\n \"author\": {\n \"@type\": \"Person\",\n \"name\": \"Jane Doe\",\n \"url\": \"https://example.com/authors/jane\"\n },\n \"publisher\": {\n \"@type\": \"Organization\",\n \"name\": \"Example Company\",\n \"logo\": {\n \"@type\": \"ImageObject\",\n \"url\": \"https://example.com/logo.png\"\n }\n },\n \"description\": \"A complete guide to implementing schema markup...\",\n \"mainEntityOfPage\": {\n \"@type\": \"WebPage\",\n \"@id\": \"https://example.com/schema-guide\"\n }\n}\n```\n\n### Product Schema\n\n```json\n{\n \"@context\": \"https://schema.org\",\n \"@type\": \"Product\",\n \"name\": \"Premium Widget\",\n \"image\": \"https://example.com/widget.jpg\",\n \"description\": \"High-quality widget for professional use\",\n \"sku\": \"WIDGET-001\",\n \"brand\": {\n \"@type\": \"Brand\",\n \"name\": \"ExampleCorp\"\n },\n \"offers\": {\n \"@type\": \"Offer\",\n \"price\": \"99.99\",\n \"priceCurrency\": \"USD\",\n \"availability\": \"https://schema.org/InStock\"\n }\n}\n```\n\n### SearchAction Schema\n\n```json\n{\n \"@type\": \"WebSite\",\n \"name\": \"Example Site\",\n \"url\": \"https://example.com\",\n \"potentialAction\": {\n \"@type\": \"SearchAction\",\n \"target\": {\n \"@type\": \"EntryPoint\",\n \"urlTemplate\": \"https://example.com/search?q={search_term_string}\"\n },\n \"query-input\": \"required name=search_term_string\"\n }\n}\n```\n\n## Competitor Profiling Skill\n\nThe `competitor-profiling` skill enables systematic analysis of competitor websites to extract positioning, features, pricing, and messaging intelligence.\n\n### Research Process\n\n#### Phase 1: Site Scraping (Firecrawl)\n\n##### Step 1: Map the Site\n\nUse **Firecrawl Map** to discover the competitor's site structure and identify key pages:\n\n```\nfirecrawl_map → competitor URL\n```\n\nFrom the map, identify and prioritize these page types:\n\n| Page Type | Priority Content |\n|-----------|-----------------|\n| Homepage | Headline, subheadline, value proposition, primary CTA |\n| Pricing | Tiers, prices, feature breakdown, billing options |\n| Features | Feature categories, key capabilities |\n| About | Company positioning, team, culture |\n| Blog | Content strategy signals |\n| Customers | Case studies, testimonials |\n| Integrations | Partnership ecosystem |\n| Changelog | Product development direction |\n\n##### Step 2: Scrape Key Pages\n\n```\nfirecrawl_scrape → each key page URL\n```\n\nSave results to `competitor-profiles/raw///scrapes/.md` before extracting fields.\n\n### Data Extraction Matrix\n\n| Page | What to Extract |\n|------|----------------|\n| Homepage | Headline, subheadline, value proposition, primary CTA, social proof claims, target audience signals |\n| Pricing | Tiers, prices, feature breakdown per tier, billing options, free tier/trial details |\n| Features | Feature categories, key capabilities, how they describe each feature |\n\n### Competitor Comparison Skill\n\nThe `competitors` skill focuses on creating comparison and alternative pages that position your offering against competitors.\n\n## Content Strategy Integration\n\nThe `content-strategy` skill provides the foundational content planning that supports all SEO activities.\n\n### SEO Fields Checklist\n\nEvery page-level content type needs:\n\n| Field | Description | Character Limit |\n|-------|-------------|-----------------|\n| `metaTitle` | Page title for search results | 50-60 characters |\n| `metaDescription` | Meta description for snippets | 150-160 characters |\n| `ogImage` | Social preview image | 1200x630px |\n| `slug` | URL path segment | Short, descriptive |\n| `canonicalUrl` | Optional override for duplicate content | — |\n| `noIndex` | Boolean for excluding from search | — |\n| `structuredData` | Optional JSON-LD override | Valid schema |\n\n### Editorial Workflow\n\n```mermaid\ngraph LR\n A[Draft] --> B[Review]\n B --> C[Approve]\n C --> D[Schedule]\n D --> E[Publish]\n \n style A fill:#f9f\n style E fill:#9f9\n```\n\n### Preview APIs\n\nAll major headless CMS platforms support draft previews:\n\n| Platform | Preview Method |\n|----------|---------------|\n| Sanity | Real-time preview with `useLiveQuery` or Presentation tool |\n| Contentful | Preview API (`preview.contentful.com`) with separate access token |\n| Strapi | Draft & Publish system with `status=draft` query parameter (v5) |\n\n### Content Pillars\n\nContent pillars are the 3-5 core topics your brand will own. Each pillar spawns a cluster of related content.\n\n**Types of Shareable Content:**\n- **Thought Leadership**: Articulate concepts everyone feels but hasn't named\n- **Data-Driven Content**: Product data analysis, public data analysis, original research\n- **Expert Roundups**: 15-30 experts answering one specific question\n- **Case Studies**: Challenge → Solution → Results → Key learnings\n- **Meta Content**: Behind-the-scenes transparency\n\n## Tool Integrations\n\n### Google Search Console API\n\n**Rate Limits:**\n- 200 queries per minute\n- 1,200 requests per minute\n\n**Available Dimensions:**\n- `query` - Search query\n- `page` - Page URL\n- `country` - Country code\n- `device` - Device type (MOBILE, DESKTOP, TABLET)\n- `date` - Date\n- `searchAppearance` - Search result type\n\n**Key Metrics:**\n| Metric | Description |\n|--------|-------------|\n| `clicks` | Clicks from search |\n| `impressions` | Search impressions |\n| `ctr` | Click-through rate |\n| `position` | Average position |\n\n**Search Analytics Query Example:**\n```bash\nPOST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query\n\n{\n \"startDate\": \"2024-01-01\",\n \"endDate\": \"2024-01-31\",\n \"dimensions\": [\"country\", \"query\"],\n \"rowLimit\": 100\n}\n```\n\n### Firecrawl Tools\n\n| Tool | Purpose | Best For |\n|------|---------|----------|\n| `firecrawl_map` | Discover site structure | Initial competitor research |\n| `firecrawl_scrape` | Extract content from pages | Detailed page analysis |\n| `firecrawl_crawl` | Crawl multiple pages | Deep profiles, many pages |\n| `firecrawl_extract` | Extract structured data | Consistent data format |\n\n### DataForSEO Tools\n\n**Domain-Level Intelligence:**\n| Tool | Purpose | Key Metrics |\n|------|---------|-------------|\n| `backlinks_summary` | Domain authority overview | `domain_rank`, `total_backlinks`, `referring_domains` |\n| `backlinks_referring_domains` | Top referring domains | Per-domain rank, backlinks, domain |\n| `dataforseo_labs_google_domain_rank_overview` | Organic search overview | `organic_count`, `organic_traffic`, `organic_cost` |\n\n## Workflow Summary\n\n```mermaid\ngraph TD\n A[Competitor Research] --> B[Site Architecture Planning]\n B --> C[Content Strategy Development]\n C --> D[Programmatic SEO Implementation]\n D --> E[Schema Markup]\n E --> F[AI SEO Optimization]\n F --> G[Technical SEO Audit]\n G --> H[Content Optimization]\n H --> I[Monitoring & Iteration]\n I --> A\n \n style A fill:#9f9\n style I fill:#9f9\n```\n\n## Key Performance Indicators\n\n| KPI | Tool Source | Target Range |\n|-----|-------------|--------------|\n| Organic Traffic Growth | Google Search Console | MoM increase |\n| Keyword Rankings | Ahrefs/DataForSEO | Top 10 positions |\n| Click-Through Rate | Google Search Console | >3% |\n| Index Coverage | Google Search Console | >95% |\n| Core Web Vitals | PageSpeed Insights | Pass status |\n| AI Citation Rate | Manual tracking | Industry benchmark |\n\n## Related Skills\n\n- **Analytics** (`analytics`) - Event tracking setup and performance measurement\n- **A/B Testing** (`ab-testing`) - Experiment design for SEO optimization\n- **Copywriting** (`copywriting`) - Marketing page copy optimization\n\n---\n\n\n\n## Paid Advertising Skills\n\n### 相关页面\n\n相关主题：[SEO and Discovery Skills](#seo-discovery-skills), [Analytics and Testing Skills](#analytics-testing-skills), [Content and Copy Skills](#content-copy-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/ads/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ads/SKILL.md)\n- [skills/ad-creative/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ad-creative/SKILL.md)\n- [skills/ad-creative/references/platform-specs.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ad-creative/references/platform-specs.md)\n- [skills/ads/references/ad-copy-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ads/references/ad-copy-templates.md)\n- [tools/integrations/linkedin-ads.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/linkedin-ads.md)\n\n\n# Paid Advertising Skills\n\n## Overview\n\nThe Paid Advertising Skills module provides AI agents with specialized knowledge and workflows for managing paid advertising campaigns across multiple platforms. This skill system enables agents to create, optimize, and manage advertising campaigns with platform-specific best practices, ad copy generation, audience targeting, and conversion tracking.\n\nThe skills are designed to work together as an integrated system, with `ads` handling campaign strategy, targeting, and optimization, while `ad-creative` focuses on generating high-performing ad copy at scale. 资料来源：[skills/ads/SKILL.md:1-10]()\n\n## Architecture\n\n### Skill Components\n\n```mermaid\ngraph TD\n subgraph \"Paid Advertising System\"\n ADS[ads Campaign Strategy & Optimization]\n AD_CREATIVE[ad-creative Ad Copy Generation]\n PLATFORM_SPECS[platform-specs Platform Specifications]\n COPY_TEMPLATES[ad-copy-templates Copy Formulas]\n end\n \n subgraph \"External Integrations\"\n GOOGLE[Google Ads]\n META[Meta Ads]\n LINKEDIN[LinkedIn Ads]\n TIKTOK[TikTok Ads]\n end\n \n ADS --> AD_CREATIVE\n AD_CREATIVE --> PLATFORM_SPECS\n AD_CREATIVE --> COPY_TEMPLATES\n ADS --> GOOGLE\n ADS --> META\n ADS --> LINKEDIN\n ADS --> TIKTOK\n```\n\n### Relationship to Other Skills\n\nThe `ads` skill serves as the foundation for paid advertising operations and references other skills for complementary functionality:\n\n- **copywriting**: For landing page copy where ad traffic lands\n- **ab-testing**: For structuring creative tests with statistical rigor\n- **marketing-psychology**: For psychological principles behind high-performing creative\n- **copy-editing**: For polishing ad copy before launch\n- **analytics**: For measuring and interpreting campaign performance\n\n资料来源：[skills/ads/SKILL.md:180-195]()\n\n## Campaign Structure Best Practices\n\n### Account Organization Hierarchy\n\n```mermaid\ngraph TD\n ACCOUNT[Account] --> CAMPAIGN1[Campaign 1 Objective - Audience/Product]\n ACCOUNT --> CAMPAIGN2[Campaign 2 Objective - Audience/Product]\n \n CAMPAIGN1 --> ADSET1[Ad Set 1 Targeting Variation]\n CAMPAIGN1 --> ADSET2[Ad Set 2 Targeting Variation]\n \n ADSET1 --> AD1[Ad 1 Creative Variation A]\n ADSET1 --> AD2[Ad 2 Creative Variation B]\n ADSET1 --> AD3[Ad 3 Creative Variation C]\n \n ADSET2 --> AD4[Ad 4 Creative Variation D]\n```\n\n### Naming Conventions\n\n| Element | Format | Example |\n|---------|--------|---------|\n| Campaign | `[Platform]_[Objective]_[Audience]_[Offer]_[Date]` | `META_Conv_Lookalike-Customers_FreeTrial_2024Q1` |\n| Ad Set | `[Platform]_[Objective]_[Targeting]` | `GOOG_Search_BrandTerms` |\n| Ad | `[Platform]_[CreativeType]_[Angle]_[Variant]` | `LI_Text_Problem-Solution_A` |\n\n资料来源：[skills/ads/SKILL.md:85-110]()\n\n### Budget Allocation Strategy\n\n| Phase | Duration | Budget Split | Notes |\n|-------|----------|--------------|-------|\n| **Testing** | 2-4 weeks | 70% proven / 30% new tests | Validate hypotheses |\n| **Scaling** | Ongoing | Consolidate winners | Increase 20-30% at a time |\n\n资料来源：[skills/ads/SKILL.md:111-125]()\n\n## Ad Copy Frameworks\n\n### Primary Text Formulas\n\nThe system provides five core copywriting frameworks for generating compelling ad copy:\n\n#### 1. Problem-Agitate-Solve (PAS)\n\n```\n[Problem statement] → [Agitate the pain] → [Introduce solution] → [CTA]\n```\n\n**Example:**\n> Spending hours on manual reporting every week?\n> While you're buried in spreadsheets, your competitors are making decisions.\n> [Product] automates your reports in minutes.\n> Start your free trial →\n\n资料来源：[skills/ads/references/ad-copy-templates.md:1-20]()\n\n#### 2. Before-After-Bridge (BAB)\n\n```\n[Current painful state] → [Desired future state] → [Your product as the bridge]\n```\n\n**Example:**\n> Before: Chasing down approvals across email, Slack, and spreadsheets.\n> After: Every approval tracked, automated, and on time.\n> [Product] connects your tools and keeps projects moving.\n\n资料来源：[skills/ads/references/ad-copy-templates.md:30-40]()\n\n#### 3. Social Proof Lead\n\n```\n[Impressive stat or testimonial] → [What you do] → [CTA]\n```\n\n**Example:**\n> \"We cut our reporting time by 75%.\" — Sarah K., Marketing Director\n> [Product] automates the reports you hate building.\n> See how it works →\n\n资料来源：[skills/ads/references/ad-copy-templates.md:50-60]()\n\n#### 4. Feature-Benefit Bridge\n\nConverts product features into customer benefits by connecting what it does to why it matters.\n\n#### 5. Direct Response\n\nCreates immediate action through urgency and clear next steps.\n\n### Headline Formulas\n\n#### For Search Ads\n\nFocus on intent-matching headlines with clear value propositions.\n\n#### For Social Ads\n\nEmotionally engaging headlines designed for scroll-stopping impact.\n\n### CTA Variations\n\n| Category | Examples |\n|----------|----------|\n| **Soft CTAs** | Learn more, Discover, Explore |\n| **Hard CTAs** | Buy now, Sign up, Get started |\n| **Urgency CTAs** | Limited time, Don't miss out, Today only |\n| **Action-Oriented** | Start free trial, Book a demo, Download now |\n\n资料来源：[skills/ads/references/ad-copy-templates.md:60-90]()\n\n## Platform Specifications\n\n### Google Ads - Responsive Search Ads\n\n| Element | Character Limit | Required | Notes |\n|---------|----------------|----------|-------|\n| Headline | 30 chars | 3-15 | Any 3 may be shown together |\n| Description | 90 chars | 2-4 | Any 2 may be shown together |\n| Display Path 1 | 15 chars | Optional | Appears after domain |\n| Display Path 2 | 15 chars | Optional | Appears after path 1 |\n\n资料来源：[skills/ad-creative/references/platform-specs.md:1-25]()\n\n### Google Ads Headline Mix Recommendation (15 headlines)\n\n| Category | Count | Purpose |\n|----------|-------|---------|\n| Keyword-focused | 3-4 | Match search intent |\n| Benefit-focused | 3-4 | What they get |\n| Social proof | 2-3 | Numbers, awards, customers |\n| CTA-focused | 2-3 | Action to take |\n| Differentiators | 2-3 | Why you over competitors |\n| Brand name | 1 | Brand visibility |\n\n资料来源：[skills/ad-creative/references/platform-specs.md:26-40]()\n\n### Platform Selection Guide\n\n| Platform | Best For | Audience Characteristics |\n|----------|----------|-------------------------|\n| **Google Search** | High intent, direct response | Active problem-solvers, ready to buy |\n| **Meta (FB/IG)** | Awareness, consideration, lookalikes | Broad demographics, interest-based |\n| **LinkedIn** | B2B, professional services | Decision-makers, job titles, senior roles |\n| **TikTok** | Viral reach, younger demographics | 18-34, video-forward content |\n\n资料来源：[skills/ads/SKILL.md:50-75]()\n\n## Workflow: Pull Data, Analyze, Generate\n\n```mermaid\ngraph LR\n A[Pull Recent Ad Performance] --> B[Analyze Output Identify Winners]\n B --> C[Feed Winning Patterns Into Skill]\n C --> D[Generate New Variations]\n D --> E[Upload to Platform]\n \n subgraph \"CLI Commands\"\n A --> A1[node tools/clis/google-ads.js reports get]\n end\n```\n\n### Implementation\n\n```bash\n# 1. Pull recent ad performance\nnode tools/clis/google-ads.js reports get --type ad_performance --date-range last_30_days\n\n# 2. Analyze output (identify top/bottom performers)\n# 3. Feed winning patterns into this skill\n# 4. Generate new variations\n# 5. Upload to platform\n```\n\n资料来源：[skills/ad-creative/SKILL.md:45-65]()\n\n## Output Format Standards\n\n### Standard Output Structure\n\nOrganize output by angle with character counts:\n\n```\n## Angle: [Pain Point — Manual Reporting]\n\n### Headlines (30 char max)\n1. \"Stop Building Reports by Hand\" (29)\n2. \"Automate Your Weekly Reports\" (28)\n3. \"Reports Done in 5 Min, Not 5 Hr\" (31) <- OVER LIMIT, trimmed below\n -> \"Reports in 5 Min, Not 5 Hrs\" (27)\n\n### Descriptions (90 char max)\n1. \"Marketing teams save 5 hrs/week...\"\n```\n\n### Writing Quality Standards\n\n**Strong headlines:**\n- Specific (\"Cut reporting time 75%\") over vague (\"Save time\")\n- Benefits (\"Ship code faster\") over features (\"CI/CD pipeline\")\n- Active voice (\"Automate your reports\") over passive (\"Reports are automated\")\n- Include numbers when possible (\"3x faster,\" \"in 5 minutes,\" \"10,000+ teams\")\n\n**Avoid:**\n- Jargon the audience won't recognize\n- Claims without specificity (\"Best,\" \"Leading,\" \"Top\")\n- All caps or excessive punctuation\n- Clickbait that the landing page can't deliver on\n\n资料来源：[skills/ad-creative/SKILL.md:95-130]()\n\n## Platform Integration Reference\n\n### LinkedIn Ads\n\n#### Campaign Types\n\n| Type | Description |\n|------|-------------|\n| `SPONSORED_UPDATES` | Sponsored content in feed |\n| `TEXT_AD` | Traditional text ads |\n| `SPONSORED_INMAILS` | Message ads |\n| `DYNAMIC` | Dynamic ads with personalization |\n\n#### Key Metrics\n\n| Metric | Description |\n|--------|-------------|\n| `impressions` | Ad impressions |\n| `clicks` | Total clicks |\n| `costInLocalCurrency` | Spend |\n| `conversions` | Conversion count |\n| `leadGenerationMailContactInfoShares` | Lead form submissions |\n\n#### Targeting Options\n\n- **Job-Based**: Job titles, job functions, seniority levels, years of experience\n- **Company-Based**: Company names, industries, company size, company followers\n- **Professional**: Skills, groups, schools, degrees\n\n#### Rate Limits\n\n| Access Level | Limit |\n|--------------|-------|\n| Basic | 100 requests/day |\n| Marketing Developer Platform | 10,000 requests/day |\n\n资料来源：[tools/integrations/linkedin-ads.md:1-60]()\n\n## Usage Triggers\n\nThe ad-creative skill should be activated when users mention:\n\n- \"ad copy variations\"\n- \"ad creative\"\n- \"generate headlines\"\n- \"RSA headlines\"\n- \"bulk ad copy\"\n- \"ad iterations\"\n- \"creative testing\"\n- \"ad performance optimization\"\n- \"write me some ads\"\n- \"Facebook ad copy\"\n- \"Google ad headlines\"\n- \"LinkedIn ad text\"\n- \"I need more ad variations\"\n\nThe ads skill should be used for:\n\n- Campaign strategy\n- Targeting setup\n- Budget allocation\n- Campaign optimization\n- Platform account structure\n\n资料来源：[skills/ad-creative/SKILL.md:1-20]()\n\n## Related Documentation\n\n| Document | Purpose |\n|----------|---------|\n| `skills/ads/references/ad-copy-templates.md` | Complete copy templates and formulas |\n| `skills/ad-creative/references/platform-specs.md` | Platform-specific character limits and requirements |\n| `skills/ads/references/audience-targeting.md` | Audience targeting strategies |\n| `skills/ads/references/conversion-tracking.md` | Conversion tracking implementation |\n| `tools/integrations/linkedin-ads.md` | LinkedIn Ads API integration |\n\n---\n\n\n\n## Analytics and Testing Skills\n\n### 相关页面\n\n相关主题：[Conversion Optimization Skills](#conversion-skills), [Paid Advertising Skills](#paid-advertising-skills)\n\n\nRelevant Source Files\n\nThe following source files were used to generate this page:\n\n- [tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n- [tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)\n- [tools/integrations/optimizely.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/optimizely.md)\n- [tools/integrations/keywords-everywhere.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/keywords-everywhere.md)\n- [tools/integrations/semrush.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/semrush.md)\n- [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)\n- [tools/clis/optimizely.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/optimizely.js)\n\n\n# Analytics and Testing Skills\n\nThe Analytics and Testing Skills module provides a comprehensive framework for measuring marketing performance, understanding user behavior, and conducting systematic experimentation. These skills enable marketing teams to make data-driven decisions through proper implementation of analytics tools, A/B testing infrastructure, and conversion rate optimization workflows.\n\n## Overview\n\nThe skill system is designed to integrate with multiple analytics and testing platforms, providing standardized approaches for data collection, event tracking, and experimentation. The ecosystem supports both quantitative analytics (GA4, Google Search Console, SEMrush) and qualitative analysis (Hotjar), along with experimentation tools (Optimizely).\n\n### Supported Platforms\n\n| Category | Tools | Primary Use |\n|----------|-------|-------------|\n| Web Analytics | Google Analytics 4, Google Search Console | Traffic analysis, user behavior |\n| Heatmaps & Recordings | Hotjar | Session replay, click/scroll tracking |\n| SEO Intelligence | SEMrush, Keywords Everywhere | Keyword research, rank tracking |\n| Experimentation | Optimizely | A/B testing, feature flags |\n| CLI Tools | dub.js, optimizely.js | Command-line interface operations |\n\n## Architecture\n\n### Integration Architecture\n\nThe analytics and testing infrastructure follows a layered integration pattern where tools connect through standardized APIs and CLI interfaces.\n\n```mermaid\ngraph TD\n subgraph \"Data Collection Layer\"\n GA4[\"Google Analytics 4\"]\n GTM[\"Google Tag Manager\"]\n HOTJAR[\"Hotjar\"]\n end\n \n subgraph \"Intelligence Layer\"\n GSC[\"Google Search Console\"]\n SEMRUSH[\"SEMrush\"]\n KEYWORDS[\"Keywords Everywhere\"]\n end\n \n subgraph \"Experimentation Layer\"\n OPTIMIZELY[\"Optimizely\"]\n end\n \n subgraph \"CLI Layer\"\n DUB[\"dub.js CLI\"]\n OPTCLI[\"optimizely.js CLI\"]\n end\n \n GTM --> GA4\n GSC --> INTEL[\"Analytics Intelligence\"]\n SEMRUSH --> INTEL\n KEYWORDS --> INTEL\n OPTIMIZELY --> EXP[\"Experimentation Engine\"]\n \n DUB --> DASH[\"Dashboard / Reports\"]\n OPTCLI --> EXP\n```\n\n资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n资料来源：[tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)\n\n## Google Analytics 4 Integration\n\nGoogle Analytics 4 provides the foundation for web analytics implementation, offering event-based tracking with enhanced measurement capabilities.\n\n### Implementation Pattern\n\nThe GA4 implementation follows a structured approach with proper configuration of measurement protocols and event schemas. Implementation documentation specifies standard event categories and parameters for consistent data collection across marketing touchpoints.\n\n### Event Tracking\n\nGA4 supports custom event tracking with parameters for:\n\n- **User Properties**: Demographic and behavioral attributes\n- **Event Parameters**: Contextual data about user actions\n- **Items**: Product and inventory information for e-commerce\n\n资料来源：[skills/analytics/references/ga4-implementation.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/ga4-implementation.md)\n\n## Google Tag Manager Implementation\n\nGoogle Tag Manager serves as the tag management system for implementing analytics and marketing tags without direct code deployment.\n\n### Container Structure\n\n```mermaid\ngraph TD\n GTM[\"GTM Container\"] --> TRIGGERS[\"Triggers\"]\n GTM --> TAGS[\"Tags\"]\n GTM --> VARIABLES[\"Variables\"]\n \n TRIGGERS --> PAGEVIEW[\"Pageview Trigger\"]\n TRIGGERS --> CLICK[\"Click Trigger\"]\n TRIGGERS --> CUSTOM[\"Custom Event\"]\n \n TAGS --> GA4TAG[\"GA4 Tag\"]\n TAGS --> ADWORDS[\"Google Ads Tag\"]\n TAGS --> CUSTOMTAG[\"Custom HTML\"]\n \n VARIABLES --> DOM[\"DOM Variables\"]\n VARIABLES --> DATA[\"Data Layer\"]\n VARIABLES --> CONST[\"Constants\"]\n```\n\n资料来源：[skills/analytics/references/gtm-implementation.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/gtm-implementation.md)\n\n## Event Library\n\nThe event library defines a standardized vocabulary for tracking user interactions across marketing properties.\n\n### Standard Event Categories\n\n| Category | Events | Purpose |\n|----------|--------|---------|\n| Page | `page_view`, `page_exit` | Navigation analysis |\n| Engagement | `scroll`, `click`, `video_*` | User interaction tracking |\n| Conversion | `purchase`, `sign_up`, `lead` | Goal completion |\n| Commerce | `view_item`, `add_to_cart`, `checkout` | E-commerce tracking |\n| Search | `search`, `refine_search` | Site search analysis |\n\n### Event Schema\n\nEach event follows a consistent schema structure:\n\n```\nevent_name\n├── timestamp\n├── user_id (if authenticated)\n├── session_id\n├── page_location\n├── page_referrer\n└── event_parameters (custom)\n```\n\n资料来源：[skills/analytics/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/event-library.md)\n\n## A/B Testing Framework\n\nThe A/B testing module provides infrastructure for systematic experimentation to optimize conversion rates and user experience.\n\n### Research Process\n\n```mermaid\ngraph TD\n START[\"Hypothesis Formation\"] --> DESIGN[\"Test Design\"]\n DESIGN --> SAMPLE[\"Sample Size Calculation\"]\n SAMPLE --> IMPLEMENT[\"Implement Variations\"]\n IMPLEMENT --> LAUNCH[\"Launch Test\"]\n LAUNCH --> MONITOR[\"Monitor Results\"]\n MONITOR --> ANALYZE[\"Statistical Analysis\"]\n ANALYZE --> DECISION[\"Winner Declaration\"]\n DECISION --> ITERATE[\"Iterate\"]\n```\n\n资料来源：[skills/ab-testing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/SKILL.md)\n\n### Sample Size Determination\n\nProper sample size calculation ensures statistical validity of test results.\n\n| Factor | Impact | Consideration |\n|--------|--------|---------------|\n| Baseline Conversion | Determines effect size | Historical data required |\n| Minimum Detectable Effect | Smaller effects need larger samples | Business context dependent |\n| Statistical Power | Typically 80% | Affects Type II error rate |\n| Significance Level | Typically 95% | Affects Type I error rate |\n\n资料来源：[skills/ab-testing/references/sample-size-guide.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/references/sample-size-guide.md)\n\n### Test Templates\n\nStandardized templates accelerate test implementation:\n\n```mermaid\ngraph LR\n A[Control] -->|Original| B[Baseline Metrics]\n C[Variation A] -->|Treatment| D[Variant Metrics]\n E[Variation B] -->|Treatment| D\n D --> F{Compare}\n F -->|Significant| G[Declare Winner]\n F -->|Not Significant| H[Extend Test]\n```\n\n资料来源：[skills/ab-testing/references/test-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/references/test-templates.md)\n\n## Optimizely Integration\n\nOptimizely provides enterprise experimentation capabilities including A/B testing, feature flags, and personalization.\n\n### API Capabilities\n\n| Endpoint | Purpose | Parameters |\n|----------|---------|------------|\n| `projects.list` | List experimentation projects | `page`, `per_page` |\n| `experiments.list` | List experiments in project | `project_id`, `status` |\n| `experiments.create` | Create new experiment | `name`, `variations`, `metrics` |\n| `results.get` | Retrieve experiment results | `experiment_id`, `start_time`, `end_time` |\n\n### Rate Limits\n\n- **50 requests/second** per personal token\n- Pagination via `page` and `per_page` parameters\n- OpenAPI specification available at `https://api.optimizely.com/v2/swagger.json`\n\n### CLI Commands\n\nThe Optimizely CLI provides command-line access to experimentation features:\n\n```bash\n# List projects\noptimizely projects list\n\n# List experiments\noptimizely experiments list --project-id \n\n# List pages\noptimizely pages list --project-id \n\n# List options with pagination\noptimizely options --page --per-page --status \n```\n\n资料来源：[tools/integrations/optimizely.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/optimizely.md)\n资料来源：[tools/clis/optimizely.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/optimizely.js)\n\n## Google Search Console Integration\n\nGoogle Search Console provides organic search performance data essential for SEO analytics.\n\n### API Operations\n\n| Operation | Endpoint | Purpose |\n|-----------|----------|---------|\n| Query Analysis | `searchAnalytics.query` | Search performance data |\n| URL Inspection | `urlInspection.index:inspect` | Index status check |\n| Sitemap Management | `sites/{siteUrl}/sitemaps` | Sitemap submission |\n| Index Request | `urlNotifications:publish` | Request indexing |\n\n### Dimensions and Metrics\n\n**Available Dimensions:**\n\n- `query` — Search query\n- `page` — Page URL\n- `country` — Country code\n- `device` — Device type (MOBILE, DESKTOP, TABLET)\n- `date` — Date\n- `searchAppearance` — Search result type\n\n**Metrics:**\n\n| Metric | Description |\n|--------|-------------|\n| `clicks` | Clicks from search results |\n| `impressions` | Search impressions |\n| `ctr` | Click-through rate |\n| `position` | Average search position |\n\n### Rate Limits\n\n- **200 queries per minute**\n- **1,200 requests per minute**\n\n### Query Example\n\n```bash\nPOST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query\n\n{\n \"startDate\": \"2024-01-01\",\n \"endDate\": \"2024-01-31\",\n \"dimensions\": [\"country\", \"query\"],\n \"rowLimit\": 100\n}\n```\n\n### Filter Configuration\n\n```json\n{\n \"dimensionFilterGroups\": [{\n \"filters\": [{\n \"dimension\": \"query\",\n \"operator\": \"contains\",\n \"expression\": \"keyword\"\n }]\n }]\n}\n```\n\n资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)\n\n## Hotjar Integration\n\nHotjar provides qualitative analytics through heatmaps, session recordings, and user surveys.\n\n### Data Types\n\n#### Heatmap Data\n\n| Field | Description |\n|-------|-------------|\n| `url` | Page URL |\n| `click_count` | Total clicks tracked |\n| `visitors` | Unique visitors |\n| `created_at` | Heatmap creation date |\n\n#### Recording Data\n\n| Field | Description |\n|-------|-------------|\n| `recording_id` | Unique recording identifier |\n| `duration` | Session duration |\n| `pages_visited` | Pages in session |\n| `device` | Device information |\n\n### API Parameters\n\n**Survey Responses:**\n\n| Parameter | Description |\n|-----------|-------------|\n| `limit` | Results per page (default: 100) |\n| `cursor` | Pagination cursor |\n| `sort` | Sort order (default: created_at desc) |\n\n**Recordings:**\n\n| Parameter | Description |\n|-----------|-------------|\n| `limit` | Results per page |\n| `cursor` | Pagination cursor |\n| `date_from` | Start date filter |\n| `date_to` | End date filter |\n\n### Rate Limits\n\n- **3,000 requests/minute** (50 per second)\n- Rate limited by source IP address\n- Cursor-based pagination for large result sets\n\n### Use Cases\n\n- Analyzing user behavior patterns on landing pages\n- Collecting qualitative feedback via on-site surveys\n- Identifying UX issues through session recordings\n- Understanding scroll depth and engagement via heatmaps\n- Validating CRO hypotheses with user behavior data\n- Form abandonment analysis\n\n资料来源：[tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)\n\n## SEO Analytics Tools\n\n### SEMrush Integration\n\nSEMrush provides comprehensive SEO intelligence including keyword research, competitive analysis, and backlink monitoring.\n\n#### Export Columns\n\n| Report Type | Key Columns |\n|-------------|-------------|\n| **Domain Report** | `Db`, `Dn`, `Rk`, `Or`, `Ot`, `Oc` |\n| **Keyword Report** | `Ph`, `Nq`, `Cp`, `Co`, `Kd`, `Nr` |\n| **Backlinks** | `source_url`, `target_url`, `anchor`, `source_title` |\n\n#### Database Coverage\n\nCountry codes supported: `us`, `uk`, `de`, `fr`, `ca`, `au`, and others.\n\n#### Rate Limits\n\n- Varies by plan (10-30K units/day)\n- Each API call consumes units\n\n资料来源：[tools/integrations/semrush.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/semrush.md)\n\n### Keywords Everywhere\n\nKeywords Everywhere provides keyword data including search volume, CPC, and competition scores.\n\n#### Key Metrics\n\n| Metric | Description |\n|--------|-------------|\n| `search_volume` | Monthly search volume |\n| `cpc.value` | Cost per click |\n| `competition` | Competition score |\n| `trend` | 12-month trend data |\n| `estimated_traffic` | Estimated monthly traffic |\n| `keywords_count` | Number of ranking keywords |\n\n#### Parameters\n\n| Parameter | Description |\n|-----------|-------------|\n| `country` | Country code (us, uk, de, fr, etc.) |\n| `currency` | Currency code (USD, GBP, EUR, etc.) |\n| `dataSource` | Data source (default: `gkp` for Google Keyword Planner) |\n| `kw` | Array of keywords (max 100 per request) |\n\n#### Rate Limits\n\n- **100 keywords per request**\n- Credit-based pricing (1 credit per keyword)\n\n资料来源：[tools/integrations/keywords-everywhere.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/keywords-everywhere.md)\n\n## Workflow Integration\n\n### Analytics Workflow\n\n```mermaid\ngraph TD\n subgraph \"Collection\"\n WEB[\"Web Analytics\"]\n GSC[\"Search Console\"]\n SEO[\"SEO Tools\"]\n end\n \n subgraph \"Analysis\"\n PERFORMANCE[\"Performance Review\"]\n SEGMENT[\"Segmentation\"]\n FUNNEL[\"Funnel Analysis\"]\n end\n \n subgraph \"Optimization\"\n TEST[\"A/B Testing\"]\n PRIORITIZE[\"Prioritization\"]\n IMPLEMENT[\"Implementation\"]\n end\n \n WEB --> PERFORMANCE\n GSC --> PERFORMANCE\n SEO --> SEGMENT\n SEGMENT --> FUNNEL\n FUNNEL --> TEST\n TEST --> PRIORITIZE\n PRIORITIZE --> IMPLEMENT\n IMPLEMENT --> WEB\n```\n\n### Testing Workflow\n\n```mermaid\ngraph LR\n A[Idea] --> B[Hypothesis]\n B --> C[Test Design]\n C --> D[Build]\n D --> E[QA]\n E --> F[Launch]\n F --> G[Monitor]\n G --> H[Analysis]\n H --> I[Decision]\n I --> J[Ship Winner]\n J --> K[Archive]\n I --> L[Iterate]\n L --> C\n```\n\n## Related Skills\n\n| Skill | Relationship |\n|-------|--------------|\n| **CRO** | Conversion Rate Optimization leverages analytics for improvement identification |\n| **SEO Audit** | Uses Google Search Console and SEMrush data for technical analysis |\n| **Landing Page** | A/B testing targets for landing page optimization |\n| **Personalization** | User behavior data drives personalization rules |\n| **UX Audit** | Hotjar data informs UX improvement recommendations |\n| **Programmatic SEO** | Analytics data guides programmatic content strategy |\n\n## Best Practices\n\n### Data Quality\n\n1. Implement consistent event naming conventions\n2. Validate tracking across all platforms before launch\n3. Document custom dimensions and metrics\n4. Regular audit of data collection implementation\n\n### Experimentation\n\n1. Calculate sample size before launching tests\n2. Avoid peeking at results before statistical significance\n3. Document hypotheses and success criteria\n4. Test one variable per experiment when possible\n\n### Integration\n\n1. Use standardized API schemas across tools\n2. Implement proper rate limit handling\n3. Configure webhooks for real-time updates where available\n4. Maintain API key security and rotation policies\n\n## Tool Reference Summary\n\n| Tool | Primary Function | Rate Limit |\n|------|------------------|------------|\n| Google Analytics 4 | Web analytics | Platform dependent |\n| Google Search Console | Search performance | 200 queries/min |\n| Hotjar | Qualitative analysis | 3000 requests/min |\n| Optimizely | Experimentation | 50 requests/sec |\n| SEMrush | SEO intelligence | 10-30K units/day |\n| Keywords Everywhere | Keyword research | 100 keywords/request |\n\n## File Structure\n\n```\ntools/\n├── integrations/\n│ ├── google-search-console.md\n│ ├── hotjar.md\n│ ├── optimizely.md\n│ ├── semrush.md\n│ └── keywords-everywhere.md\n└── clis/\n ├── dub.js\n └── optimizely.js\n\nskills/\n├── analytics/\n│ ├── SKILL.md\n│ └── references/\n│ ├── ga4-implementation.md\n│ ├── gtm-implementation.md\n│ └── event-library.md\n└── ab-testing/\n ├── SKILL.md\n └── references/\n ├── sample-size-guide.md\n └── test-templates.md\n\n---\n\n\n\n## Retention and Growth Skills\n\n### 相关页面\n\n相关主题：[Conversion Optimization Skills](#conversion-skills), [Sales and RevOps Skills](#sales-revops-skills), [Content and Copy Skills](#content-copy-skills)\n\n\n相关源码文件\n\n以下源码文件用于生成本页说明：\n\n- [skills/churn-prevention/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/SKILL.md)\n- [skills/churn-prevention/references/cancel-flow-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/references/cancel-flow-patterns.md)\n- [skills/churn-prevention/references/dunning-playbook.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/references/dunning-playbook.md)\n- [skills/referrals/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/referrals/SKILL.md)\n- [skills/referrals/references/program-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/referrals/references/program-examples.md)\n- [skills/co-marketing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/co-marketing/SKILL.md)\n- [skills/free-tools/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/free-tools/SKILL.md)\n- [skills/lead-magnets/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/lead-magnets/SKILL.md)\n- [skills/lead-magnets/references/benchmarks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/lead-magnets/references/benchmarks.md)\n- [skills/community-marketing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/community-marketing/SKILL.md)\n\n\n# Retention and Growth Skills\n\n## Overview\n\nRetention and Growth Skills constitute a specialized category within the Marketing Skills framework designed to help AI agents assist with customer retention, revenue recovery, and sustainable business growth strategies. These skills focus on preventing churn, maximizing customer lifetime value, and expanding revenue through referral programs, co-marketing partnerships, and lead generation tactics.\n\nThe skills in this category work together to create a comprehensive customer lifecycle management approach:\n\n```mermaid\ngraph TD\n A[Customer Lifecycle] --> B[Retention]\n A --> C[Growth]\n B --> D[Churn Prevention]\n B --> E[Dunning & Recovery]\n C --> F[Referral Programs]\n C --> G[Lead Magnets]\n C --> H[Co-Marketing]\n C --> I[Free Tools]\n C --> J[Community Marketing]\n \n D --> K[Cancel Flow Patterns]\n E --> L[Payment Recovery]\n F --> M[Viral Growth]\n G --> N[Lead Capture]\n H --> O[Partnership Expansion]\n I --> P[Tool-Led Acquisition]\n J --> Q[Community Engagement]\n```\n\n## Skill Categories\n\n| Skill | Primary Focus | Key Outcomes |\n|-------|--------------|---------------|\n| `churn-prevention` | Customer retention & cancellation prevention | Reduce churn rate, recover at-risk customers |\n| `referrals` | Word-of-mouth and viral growth | Acquire customers through existing user networks |\n| `lead-magnets` | Lead capture and qualification | Generate qualified leads with valuable content |\n| `co-marketing` | Strategic partnerships | Expand reach through joint marketing efforts |\n| `free-tools` | Tool-led acquisition | Attract users with free utility offerings |\n| `community-marketing` | Community-driven growth | Build engaged user communities for organic growth |\n\n## Churn Prevention Skill\n\nThe `churn-prevention` skill enables agents to help businesses reduce customer attrition through proactive intervention and strategic retention offers. It encompasses two key reference modules: cancel flow patterns and dunning playbooks.\n\n### Purpose and Scope\n\nChurn prevention focuses on identifying at-risk customers before they cancel and implementing recovery strategies during the cancellation process. The skill provides guidance on creating effective save flows, timing interventions, and crafting compelling retention offers.\n\n### Cancel Flow Patterns\n\nThe cancel flow patterns module provides structured approaches to handling customer cancellation requests. It emphasizes understanding the customer's reason for leaving and offering appropriate alternatives.\n\n**Key Components:**\n\n1. **Exit Survey Integration** - Collect cancellation reasons to inform product improvements\n2. **Save Offer Tiers** - Provide escalating offers based on customer value\n3. **Pause Options** - Offer temporary suspension instead of cancellation\n4. **Downgrade Paths** - Allow migration to lower-tier plans\n\n```mermaid\ngraph TD\n A[Cancel Request] --> B[Exit Survey]\n B --> C{Reason Analysis}\n C -->|Price| D[Discount Offer]\n C -->|Value| E[Feature Highlight]\n C -->|Usage| F[Onboarding Help]\n C -->|Competitor| G[Competitive Analysis]\n C -->|Other| H[General Retention]\n \n D --> I[Save Flow]\n E --> I\n F --> I\n G --> I\n H --> I\n \n I --> J{Save Success?}\n J -->|Yes| K[Retained Customer]\n J -->|No| L[Grace Period Offer]\n L --> M[Final Save]\n M -->|No| N[Cancellation Complete]\n```\n\n资料来源：[skills/churn-prevention/references/cancel-flow-patterns.md]()\n\n### Dunning Playbook\n\nThe dunning module addresses failed payments and subscription recovery. It provides strategies for communicating payment failures, retry timing, and customer-friendly recovery processes.\n\n**Dunning Communication Strategy:**\n\n| Stage | Timing | Focus | Channels |\n|-------|--------|-------|----------|\n| First Notice | Day 1 | Gentle reminder | Email |\n| Second Notice | Day 3-5 | Urgent but helpful | Email + SMS |\n| Third Notice | Day 7-10 | Final warning | Email + SMS + Call |\n| Grace Period | Day 14-21 | Last chance | Email + Personal outreach |\n\n**Best Practices:**\n\n- Use friendly, non-threatening language\n- Clearly explain the issue and resolution steps\n- Offer multiple payment method updates\n- Include one-click payment update links\n- Provide clear timeline of consequences\n\n资料来源：[skills/churn-prevention/references/dunning-playbook.md]()\n\n## Referrals Skill\n\nThe `referrals` skill helps agents design and optimize referral marketing programs that leverage existing customers to acquire new ones. Referral programs are among the most cost-effective acquisition channels when properly structured.\n\n### Program Structure\n\nA referral program typically consists of four key elements:\n\n```mermaid\ngraph LR\n A[Referrer] -->|Makes Referral| B[Referral Program]\n B --> C{Eligibility Check}\n C -->|Qualified| D[Reward Triggered]\n C -->|Not Qualified| E[No Reward]\n D --> F[Referral Becomes Customer]\n F -->|Cycle| A\n \n style A fill:#bbf\n style F fill:#bbf\n style D fill:#dfd\n```\n\n### Program Examples\n\nThe program examples reference provides real-world templates for different referral scenarios:\n\n**Standard Referral:**\n- Referrer receives reward when referee completes purchase\n- Reward can be fixed amount, percentage, or credit\n- Suitable for e-commerce and SaaS businesses\n\n**Tiered Referral:**\n- Rewards increase with number of successful referrals\n- Encourages repeated advocacy\n- Example: Dropbox's early referral program\n\n**Viral Referral:**\n- Double-sided rewards (both parties get benefit)\n- Built-in sharing mechanics\n- Example: Uber's referral system\n\n**Milestone-Based Referral:**\n- Rewards at specific referral thresholds\n- Creates achievement motivation\n- Example: Referral milestones at 5, 10, 25 referrals\n\n| Program Type | Best For | Reward Structure | Key Metric |\n|--------------|----------|------------------|------------|\n| Standard | B2C e-commerce | Fixed discount | Conversion rate |\n| Double-sided | Growth stage SaaS | Equal reward both parties | Viral coefficient |\n| Tiered | Enterprise | Increasing rewards | Referrals per user |\n| Milestone | Gamified experience | Badge + reward | Engagement rate |\n\n资料来源：[skills/referrals/references/program-examples.md]()\n\n## Lead Magnets Skill\n\nThe `lead-magnets` skill enables agents to create effective lead capture mechanisms that provide value to prospects while qualifying them for sales follow-up.\n\n### Purpose and Strategy\n\nLead magnets are valuable content or tools offered in exchange for contact information. They serve as the bridge between top-of-funnel awareness and qualified lead conversion.\n\n**Common Lead Magnet Formats:**\n\n| Format | Example | Best For | Effort |\n|--------|---------|----------|--------|\n| Ebook/Guide | Industry report | Thought leadership | Medium |\n| Checklist | Launch checklist | Action-oriented buyers | Low |\n| Template | Email sequence template | DIY marketers | Medium |\n| Tool | ROI calculator | High-intent prospects | High |\n| Webinar | Training session | Engagement nurturing | Medium |\n| Free Trial | Product access | Product-qualified leads | High |\n\n### Lead Magnet Benchmarks\n\nThe benchmarks reference provides performance metrics for optimizing lead magnet effectiveness:\n\n**Conversion Benchmarks by Type:**\n\n- **Email signup forms**: 1-3% average conversion\n- **Lead magnets**: 10-20% conversion from visitor to lead\n- **Gated content**: 2-5% of website visitors\n- **Exit-intent popups**: 1-2% conversion\n\n**Best Practices:**\n\n1. Match lead magnet format to audience preference\n2. Create specific, actionable content over generic\n3. Use clear, benefit-driven headlines\n4. Optimize form fields (minimize friction)\n5. Implement progressive profiling for returning visitors\n\n资料来源：[skills/lead-magnets/references/benchmarks.md]()\n\n## Co-Marketing Skill\n\nThe `co-marketing` skill facilitates partnership-driven growth through joint marketing initiatives with complementary businesses.\n\n### Partnership Types\n\n| Type | Description | Example |\n|------|-------------|---------|\n| Content Co-creation | Joint blog posts, webinars, studies | Tech company + Analytics firm |\n| Event Co-marketing | Shared virtual summits, workshops | Industry associations |\n| Product Integration | Embedded referrals, shared tools | SaaS integrations |\n| Promotion Exchange | Cross-promotional campaigns | Complementary products |\n| Research Collaboration | Joint surveys, industry reports | Think tanks + Companies |\n\n### Implementation Checklist\n\n- Define mutual goals and success metrics\n- Establish clear value exchange\n- Create joint content calendar\n- Set up attribution tracking\n- Agree on lead sharing process\n\n资料来源：[skills/co-marketing/SKILL.md]()\n\n## Free Tools Skill\n\nThe `free-tools` skill focuses on tool-led acquisition strategies where valuable free utilities attract and convert potential customers.\n\n### Strategy Overview\n\nFree tools leverage the \"foot-in-the-door\" technique by providing immediate value that builds trust and demonstrates product capability.\n\n**Tool Categories:**\n\n| Category | Example | Conversion Mechanism |\n|----------|---------|---------------------|\n| Calculators | ROI, savings, estimates | Results-based upsell |\n| Generators | Logo, copy, images | Output requires paid features |\n| Analyzers | SEO, website, social | Recommendations link to paid |\n| Templates | Documents, spreadsheets | Premium versions available |\n| Checklists | Pre-flight, audit tools | Upgrade to full version |\n\n资料来源：[skills/free-tools/SKILL.md]()\n\n## Community Marketing Skill\n\nThe `community-marketing` skill helps build and leverage user communities for organic growth and customer retention.\n\n### Community Strategy\n\n**Community Building Framework:**\n\n```mermaid\ngraph TD\n A[Community Goal] --> B[Platform Selection]\n A --> C[Content Strategy]\n A --> D[Engagement Plan]\n \n B --> E[Slack/Discord/Facebook Groups]\n B --> F[Forum/Reddit]\n B --> G[Customer Community]\n \n C --> H[User-Generated Content]\n C --> I[AMAs and Q&A Sessions]\n C --> J[Knowledge Sharing]\n \n D --> K[Recognition Programs]\n D --> L[Exclusive Access]\n D --> M[Feedback Loops]\n \n H --> N[Brand Advocacy]\n I --> N\n J --> N\n K --> N\n L --> N\n M --> N\n```\n\n**Benefits of Community Marketing:**\n\n- Reduced support costs through peer-to-peer help\n- Increased customer retention through belonging\n- Valuable user feedback and feature ideas\n- Organic word-of-mouth promotion\n- Brand loyalty and advocacy\n\n**Platform Options:**\n\n| Platform | Best For | Features |\n|----------|----------|----------|\n| Slack | B2B SaaS | Channels, integrations |\n| Discord | Developers/Gamers | Voice, roles, bots |\n| Facebook Groups | Broad audiences | Native social features |\n| Circle | Content creators | Courses, memberships |\n\n资料来源：[skills/community-marketing/SKILL.md]()\n\n## Implementation Guidelines\n\n### Skill Selection Matrix\n\n| Business Goal | Primary Skill | Supporting Skills |\n|---------------|---------------|-------------------|\n| Reduce churn | `churn-prevention` | `community-marketing` |\n| Lower CAC | `referrals` | `lead-magnets` |\n| Lead volume | `lead-magnets` | `free-tools` |\n| Market expansion | `co-marketing` | `referrals` |\n| Product adoption | `free-tools` | `community-marketing` |\n\n### Integration Patterns\n\n```mermaid\ngraph LR\n subgraph \"Top of Funnel\"\n A[Free Tools]\n B[Lead Magnets]\n C[Co-Marketing]\n end\n \n subgraph \"Middle of Funnel\"\n D[Community Marketing]\n E[Lead Nurturing]\n end\n \n subgraph \"Bottom of Funnel\"\n F[Churn Prevention]\n G[Referrals]\n end\n \n A --> D\n B --> D\n C --> D\n D --> F\n F --> G\n G --> A\n```\n\n## Trigger Phrases for Agent Invocation\n\nThe following phrases indicate a user needs retention and growth skill assistance:\n\n| Skill | Trigger Phrases |\n|-------|-----------------|\n| Churn Prevention | \"reduce churn\", \"customer leaving\", \"canceling subscription\", \"failed payment\" |\n| Referrals | \"referral program\", \"word of mouth\", \"customer recommendations\", \"viral growth\" |\n| Lead Magnets | \"lead generation\", \"capture leads\", \"content upgrade\", \"gated content\" |\n| Co-Marketing | \"partnership\", \"joint marketing\", \"co-branded\", \"strategic alliance\" |\n| Free Tools | \"free tool\", \"calculator\", \"generator\", \"free utility\" |\n| Community | \"build community\", \"user community\", \"customer engagement\", \"brand advocates\" |\n\n## Related Skills\n\n- **CRO Skill** - Works with churn prevention for conversion optimization\n- **Analytics Skill** - Provides metrics tracking for all retention initiatives\n- **Emails Skill** - Supports communication for dunning and save flows\n- **Copywriting Skill** - Crafts compelling referral messages and offers\n\n---\n\n\n\n## Sales and RevOps Skills\n\n### 相关页面\n\n相关主题：[Retention and Growth Skills](#retention-growth-skills), [Content and Copy Skills](#content-copy-skills)\n\nThe source files for Sales and RevOps Skills are not included in the provided context. To generate this wiki page, I would need the following files:\n\n- `skills/revops/SKILL.md`\n- `skills/revops/references/lifecycle-definitions.md`\n- `skills/revops/references/scoring-models.md`\n- `skills/revops/references/routing-rules.md`\n- `skills/revops/references/automation-playbooks.md`\n- `skills/sales-enablement/SKILL.md`\n- `skills/sales-enablement/references/deck-frameworks.md`\n- `skills/sales-enablement/references/objection-library.md`\n- `skills/sales-enablement/references/demo-scripts.md`\n\n**Available context includes:** `README.md`, `AGENTS.md`, `CLAUDE.md`, `CONTRIBUTING.md`, various skills under `skills/site-architecture/`, `skills/competitor-profiling/`, `skills/ai-seo/`, `skills/content-strategy/`, `skills/schema/`, and tools under `tools/integrations/` and `tools/clis/`.\n\nPlease provide the Sales and RevOps source files to generate the wiki page.\n\n---\n\n---\n\n## Doramagic 踩坑日志\n\n项目：coreyhaines31/marketingskills\n\n摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令：`npx skills`\n- 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n\n## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 7. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n\n## 8. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\n\n## 9. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing\n\n## 10. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.\n\n## 12. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。\n\n## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。\n\n## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。\n\n## 18. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown\n\n## 19. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | release_recency=unknown\n\n\n",
"summary": "DeepWiki/Human Wiki 完整输出，末尾追加 Discovery Agent 踩坑日志。",
"title": "Human Manual / 人类版说明书"
},
"pitfall_log": {
"asset_id": "pitfall_log",
"filename": "PITFALL_LOG.md",
"markdown": "# Pitfall Log / 踩坑日志\n\n项目：coreyhaines31/marketingskills\n\n摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。\n\n## 1. 身份坑 · 仓库名和安装名不一致\n\n- 严重度：medium\n- 证据强度：runtime_trace\n- 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。\n- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。\n- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。\n- 复现命令：`npx skills`\n- 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。\n- 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills\n\n## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。\n\n## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand\n- 对用户的影响：可能影响升级、迁移或版本选择。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix\n- 对用户的影响：可能增加新用户试用和生产接入成本。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 7. 配置坑 · 可能修改宿主 AI 配置\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。\n- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。\n- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。\n- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。\n- 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code\n\n## 8. 能力坑 · 能力判断依赖假设\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：README/documentation is current enough for a first validation pass.\n- 对用户的影响：假设不成立时，用户拿不到承诺的能力。\n- 建议检查：将假设转成下游验证清单。\n- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。\n- 证据：capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.\n\n## 9. 维护坑 · 维护活跃度未知\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：未记录 last_activity_observed。\n- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。\n- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。\n- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing\n\n## 10. 安全/权限坑 · 下游验证发现风险项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：下游已经要求复核，不能在页面中弱化。\n- 建议检查：进入安全/权限治理复核队列。\n- 防护动作：下游风险存在时必须保持 review/recommendation 降级。\n- 证据：downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 11. 安全/权限坑 · 存在安全注意事项\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：No sandbox install has been executed yet; downstream must verify before user use.\n- 对用户的影响：用户安装前需要知道权限边界和敏感操作。\n- 建议检查：转成明确权限清单和安全审查提示。\n- 防护动作：安全注意事项必须面向用户前置展示。\n- 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.\n\n## 12. 安全/权限坑 · 存在评分风险\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：no_demo\n- 对用户的影响：风险会影响是否适合普通用户安装。\n- 建议检查：把风险写入边界卡，并确认是否需要人工复核。\n- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。\n- 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium\n\n## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。\n\n## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。\n\n## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。\n\n## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix\n\n- 严重度：medium\n- 证据强度：source_linked\n- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix\n- 对用户的影响：可能影响授权、密钥配置或安全边界。\n- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。\n- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。\n- 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。\n\n## 18. 维护坑 · issue/PR 响应质量未知\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：issue_or_pr_quality=unknown。\n- 对用户的影响：用户无法判断遇到问题后是否有人维护。\n- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。\n- 防护动作：issue/PR 响应未知时，必须提示维护风险。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown\n\n## 19. 维护坑 · 发布节奏不明确\n\n- 严重度：low\n- 证据强度：source_linked\n- 发现：release_recency=unknown。\n- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。\n- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。\n- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。\n- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | release_recency=unknown\n",
"summary": "用户实践前最可能遇到的身份、安装、配置、运行和安全坑。",
"title": "Pitfall Log / 踩坑日志"
},
"prompt_preview": {
"asset_id": "prompt_preview",
"filename": "PROMPT_PREVIEW.md",
"markdown": "# marketingskills - Prompt Preview\n\n> Copy the prompt below into your AI host before installing anything.\n> Its purpose is to let you safely feel the project's workflow, not to claim the project has already run.\n\n## Copy this prompt\n\n```text\nYou are using an independent Doramagic capability pack for coreyhaines31/marketingskills.\n\nProject:\n- Name: marketingskills\n- Repository: https://github.com/coreyhaines31/marketingskills\n- Summary: Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.\n- Host target: claude, claude_code\n\nGoal:\nHelp me evaluate this project for the following task without installing it yet: Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.\n\nBefore taking action:\n1. Restate my task, success standard, and boundary.\n2. Identify whether the next step requires tools, browser access, network access, filesystem access, credentials, package installation, or host configuration.\n3. Use only the Doramagic Project Pack, the upstream repository, and the source-linked evidence listed below.\n4. If a real command, install step, API call, file write, or host integration is required, mark it as \"requires post-install verification\" and ask for approval first.\n5. If evidence is missing, say \"evidence is missing\" instead of filling the gap.\n\nPreviewable capabilities:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n\nCapabilities that require post-install verification:\n- Capability 1: Use the source-backed project context to guide one small, checkable workflow step.\n- Capability 2: Use the source-backed project context to guide one small, checkable workflow step.\n\nCore service flow:\n1. getting-started: Getting Started. Produce one small intermediate artifact and wait for confirmation.\n2. skills-architecture: Skills Architecture. Produce one small intermediate artifact and wait for confirmation.\n3. conversion-skills: Conversion Optimization Skills. Produce one small intermediate artifact and wait for confirmation.\n4. content-copy-skills: Content and Copy Skills. Produce one small intermediate artifact and wait for confirmation.\n5. seo-discovery-skills: SEO and Discovery Skills. Produce one small intermediate artifact and wait for confirmation.\n\nSource-backed evidence to keep in mind:\n- https://github.com/coreyhaines31/marketingskills\n- https://github.com/coreyhaines31/marketingskills#readme\n- skills/ab-testing/SKILL.md\n- skills/ad-creative/SKILL.md\n- skills/ads/SKILL.md\n- skills/ai-seo/SKILL.md\n- skills/analytics/SKILL.md\n- skills/aso/SKILL.md\n- skills/churn-prevention/SKILL.md\n- skills/co-marketing/SKILL.md\n\nFirst response rules:\n1. Start Step 1 only.\n2. Explain the one service action you will perform first.\n3. Ask exactly three questions about my target workflow, success standard, and sandbox boundary.\n4. Stop and wait for my answers.\n\nStep 1 follow-up protocol:\n- After I answer the first three questions, stay in Step 1.\n- Produce six parts only: clarified task, success standard, boundary conditions, two or three options, tradeoffs for each option, and one recommendation.\n- End by asking whether I confirm the recommendation.\n- Do not move to Step 2 until I explicitly confirm.\n\nConversation rules:\n- Advance one step at a time and wait for confirmation after each small artifact.\n- Write outputs as recommendations or planned checks, not as completed execution.\n- Do not claim tests passed, files changed, commands ran, APIs were called, or the project was installed.\n- If the user asks for execution, first provide the sandbox setup, expected output, rollback, and approval checkpoint.\n```\n",
"summary": "不安装项目也能感受能力节奏的安全试用 Prompt。",
"title": "Prompt Preview / 安装前试用 Prompt"
},
"quick_start": {
"asset_id": "quick_start",
"filename": "QUICK_START.md",
"markdown": "# Quick Start / 官方入口\n\n项目：coreyhaines31/marketingskills\n\n## 官方安装入口\n\n### Node.js / npx · 官方安装入口\n\n```bash\nnpx skills\n```\n\n来源：https://github.com/coreyhaines31/marketingskills#readme\n\n## 来源\n\n- repo: https://github.com/coreyhaines31/marketingskills\n- docs: https://github.com/coreyhaines31/marketingskills#readme\n",
"summary": "从项目官方 README 或安装文档提取的开工入口。",
"title": "Quick Start / 官方入口"
}
},
"validation_id": "dval_d436df076e8348609d8f07e74d4f2057"
}