# https://github.com/coreyhaines31/marketingskills 项目说明书
生成时间：2026-05-15 15:47:54 UTC
## 目录
- [Home](#home)
- [Getting Started](#getting-started)
- [Skills Architecture](#skills-architecture)
- [Conversion Optimization Skills](#conversion-skills)
- [Content and Copy Skills](#content-copy-skills)
- [SEO and Discovery Skills](#seo-discovery-skills)
- [Paid Advertising Skills](#paid-advertising-skills)
- [Analytics and Testing Skills](#analytics-testing-skills)
- [Retention and Growth Skills](#retention-growth-skills)
- [Sales and RevOps Skills](#sales-revops-skills)
## Home
### 相关页面
相关主题：[Getting Started](#getting-started), [Skills Architecture](#skills-architecture)
相关源码文件
以下源码文件用于生成本页说明：
- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)
- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)
- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)
- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)
- [tools/integrations/postmark.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/postmark.md)
- [tools/integrations/sanity.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/sanity.md)
- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)
- [skills/schema/references/schema-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema/references/schema-examples.md)
# Home
Marketing 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.
## Overview
The 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.
资料来源：[README.md:1-15]()
## Repository Structure
The repository follows a modular architecture with three main components:
| Component | Location | Purpose |
|-----------|----------|---------|
| Skills | `skills/` | Marketing task instructions for AI agents |
| CLI Tools | `tools/clis/` | Zero-dependency Node.js scripts for integrations |
| Integrations | `tools/integrations/` | API documentation and references |
资料来源：[CLAUDE.md:1-20]()
```mermaid
graph TD
subgraph "Marketing Skills Repository"
subgraph "skills/"
CRO["CRO Skills"]
EMAIL["Email Marketing"]
SEO["SEO & Discovery"]
ADS["Paid Advertising"]
ANALYTICS["Analytics & Testing"]
CONTENT["Content & Copy"]
end
subgraph "tools/"
CLIS["CLI Tools"]
INTEGRATIONS["Integration Docs"]
end
subgraph "Documentation"
README["README.md"]
CLAUDE["CLAUDE.md"]
AGENTS["AGENTS.md"]
CONTRIBUTING["CONTRIBUTING.md"]
end
end
AI_AGENT["AI Agent"] --> SKILLS
AI_AGENT --> CLIS
CLIS --> INTEGRATIONS
```
## Skills Categories
The repository contains skills organized by marketing discipline:
### Conversion & User Experience
| Skill | Description |
|-------|-------------|
| `cro` | Conversion rate optimization for pages, modals, overlays, and paywalls |
| `form-cro` | Form optimization and behavior analysis |
资料来源：[README.md:45-52]()
### Content & Copywriting
| Skill | Description |
|-------|-------------|
| `copywriting` | Marketing page copy generation |
| `copy-editing` | Edit and polish existing copy |
| `cold-email` | B2B cold outreach emails and sequences |
| `emails` | Automated email flows |
| `social` | Social media content creation |
| `image` | AI image generation and design optimization |
资料来源：[README.md:53-60]()
### SEO & Discovery
| Skill | Description |
|-------|-------------|
| `seo-audit` | Technical and on-page SEO analysis |
| `ai-seo` | AI search optimization (AEO, GEO, LLMO) |
| `programmatic-seo` | Scaled page generation |
| `site-architecture` | Page hierarchy, navigation, URL structure |
| `competitors` | Comparison and alternative pages |
| `schema` | Structured data implementation |
资料来源：[README.md:61-68]()
### Paid & Distribution
| Skill | Description |
|-------|-------------|
| `ads` | Google, Meta, LinkedIn ad campaigns |
| `ad-creative` | Bulk ad creative generation and iteration |
资料来源：[README.md:69-72]()
### Measurement & Retention
| Skill | Description |
|-------|-------------|
| `analytics` | Event tracking setup |
| `ab-testing` | Experiment design |
| `churn-prevention` | Cancel flows, save offers, dunning |
资料来源：[README.md:73-80]()
### Growth Engineering
| Skill | Description |
|-------|-------------|
| `co-marketing` | Partner identification and joint campaigns |
| `free-tools` | Marketing tools and calculators |
| `referrals` | Referral and affiliate programs |
| `marketing-ideas` | 140 SaaS marketing ideas |
| `marketing-psychology` | Mental models and psychology |
| `launch` | Product launches |
资料来源：[README.md:81-87]()
## Skill Structure
Each skill follows a standardized directory structure:
```
skills/your-skill-name/
├── SKILL.md # Required - main instructions
├── references/ # Optional - additional documentation
│ └── guide.md
├── scripts/ # Optional - executable code
│ └── helper.py
└── assets/ # Optional - templates, images, data
└── template.json
```
资料来源：[CONTRIBUTING.md:18-27]()
### SKILL.md Format
Every skill requires a `SKILL.md` file with YAML frontmatter:
```yaml
---
name: your-skill-name
description: When to use this skill. Include trigger phrases and keywords.
---
# Your Skill Name
Instructions for the agent go here...
```
资料来源：[CONTRIBUTING.md:10-18]()
### Frontmatter Requirements
| Field | Required | Constraints |
|-------|----------|-------------|
| `name` | Yes | 1-64 chars, lowercase `a-z`, numbers, hyphens. Must match directory name |
| `description` | Yes | 1-1024 chars. Include trigger phrases |
| `license` | No | License name (default: MIT) |
| `metadata` | No | Key-value pairs (author, version, etc.) |
资料来源：[AGENTS.md:45-55]()
## CLI Tools
The repository includes zero-dependency Node.js scripts (Node 18+) for interacting with various marketing platforms:
| Tool | Purpose |
|------|---------|
| `livestorm.js` | Webinar and event management |
| `optimizely.js` | Experimentation platform |
资料来源：[CLAUDE.md:25-30]()
### CLI Verification Commands
```bash
# Syntax check
node --check tools/clis/.js
# Show usage
node tools/clis/.js
# Dry run preview
node tools/clis/.js --dry-run
```
资料来源：[CLAUDE.md:26-32]()
## Integration Documentation
API references are provided for various marketing platforms:
### Supported Integrations
| Platform | Documentation | Key Features |
|----------|---------------|--------------|
| Postmark | Email delivery, templates, bounces | Transactional email |
| WordPress | Posts, pages, categories, media | CMS integration |
| Sanity | Content management, datasets | Structured content |
| Intercom | Articles, admins, events, contacts | Customer communication |
| Livestorm | Events, sessions, registrations | Webinar management |
| Hyperframes | Video generation, HTML frames | Motion content |
资料来源：[tools/integrations/postmark.md:1-35]()
资料来源：[tools/integrations/sanity.md:1-50]()
资料来源：[tools/integrations/intercom.md:1-40]()
资料来源：[tools/integrations/livestorm.md:1-30]()
## Installation Methods
Multiple installation options are available for integrating skills into AI agent projects:
```mermaid
graph LR
A["Choose Method"] --> B["Manual Clone"]
A --> C["Git Submodule"]
A --> D["Plugin System"]
A --> E["SkillKit"]
A --> F["Fork & Customize"]
B --> B1["cp -r skills/* .agents/skills/"]
C --> C1["git submodule add ..."]
D --> D1["/plugin install marketing-skills"]
E --> E1["npx skillkit install coreyhaines31/marketingskills"]
F --> F1["Custom fork in project"]
```
资料来源：[README.md:20-45]()
### Installation Options
| Method | Command | Use Case |
|--------|---------|----------|
| Manual Clone | `git clone` + copy | Full control, custom modifications |
| Git Submodule | `git submodule add` | Easy updates across projects |
| Plugin Install | `/plugin install marketing-skills` | Quick setup in agent platforms |
| SkillKit | `npx skillkit install` | Multi-agent support |
资料来源：[README.md:20-40]()
### SkillKit Multi-Agent Support
SkillKit allows installing skills across multiple AI agents:
```bash
# Install all skills
npx skillkit install coreyhaines31/marketingskills
# Install specific skills
npx skillkit install coreyhaines31/marketingskills --skill cro copywriting
# List available skills
npx skillkit install coreyhaines31/marketingskills --list
```
资料来源：[README.md:35-42]()
## Contributing
New skills can be added by following the contribution guidelines:
```mermaid
graph TD
A["Create Skill Directory"] --> B["Add SKILL.md"]
B --> C["Follow Naming Conventions"]
C --> D["Structure Skill"]
D --> E["Write Effective Instructions"]
E --> F["Submit via PR or Issue"]
```
资料来源：[CONTRIBUTING.md:1-15]()
### Naming Conventions
- **Directory name**: lowercase, hyphens only (e.g., `emails`)
- **Name field**: must match directory name exactly
- **Description**: 1-1024 characters, include trigger phrases
资料来源：[CONTRIBUTING.md:22-25]()
## Version Migration
v2.0 introduced breaking changes including:
- 17 skills renamed
- `page-cro` + `form-cro` consolidated into single `cro` skill
资料来源：[README.md:48-52]()
## Quick Reference
| Resource | Description |
|----------|-------------|
| `skills/*/SKILL.md` | Main skill instructions |
| `skills/*/references/*` | Additional documentation |
| `tools/integrations/*.md` | API references |
| `tools/clis/*.js` | CLI tools |
---
## Getting Started
### 相关页面
相关主题：[Home](#home), [Skills Architecture](#skills-architecture)
相关源码文件
以下源码文件用于生成本页说明：
- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)
- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)
- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)
- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)
- [tools/clis/livestorm.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/livestorm.js)
# Getting Started
Marketing 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.
## Overview
Marketing 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.
```mermaid
graph TD
A[Marketing Skills Repository] --> B[Skills Directory]
A --> C[CLI Tools]
A --> D[Integration References]
B --> B1[copywriting]
B --> B2[seo-audit]
B --> B3[ads]
B --> B4[emails]
B --> B5[analytics]
C --> C1[Node.js Scripts]
C --> C2[Zero Dependencies]
D --> D1[Postmark]
D --> D2[WordPress]
D --> D3[Intercom]
```
## Installation
The repository supports multiple installation methods depending on your AI agent setup.
### Method 1: Claude Desktop
Add the skills path to your Claude Desktop configuration file:
```json
{
"agent": {
"skills": {
"marketing-skills": {
"command": "python",
"args": ["-m", "agent", "skills", "install", "marketing-skills"]
}
}
}
}
```
资料来源：[README.md:1-10]()
### Method 2: MCP Plugin
For MCP-compatible agents, install via plugin command:
```bash
/plugin install marketing-skills
```
资料来源：[README.md:1-10]()
### Method 3: Clone and Copy
Clone the repository and manually copy skills to your agent's skills directory:
```bash
git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/* .agents/skills/
```
资料来源：[README.md:1-10]()
### Method 4: Git Submodule
For projects requiring version control over dependencies:
```bash
git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills
```
Reference skills from `.agents/marketingskills/skills/`.
资料来源：[README.md:1-10]()
### Method 5: SkillKit
For multi-agent environments (Claude Code, Cursor, Copilot):
```bash
# Install all skills
npx skillkit install coreyhaines31/marketingskills
# Install specific skills
npx skillkit install coreyhaines31/marketingskills --skill cro copywriting
# List available skills
npx skillkit install coreyhaines31/marketingskills --list
```
资料来源：[README.md:1-10]()
## Available Skills
Marketing Skills includes the following categories:
| Category | Skills |
|----------|--------|
| **Conversion** | `cro`, `ab-testing` |
| **Content & Copy** | `copywriting`, `copy-editing`, `cold-email`, `emails`, `social`, `image` |
| **SEO & Discovery** | `seo-audit`, `ai-seo`, `programmatic-seo`, `site-architecture`, `competitors`, `schema` |
| **Paid & Distribution** | `ads`, `ad-creative` |
| **Measurement** | `analytics` |
| **Retention** | `churn-prevention` |
| **Growth Engineering** | `co-marketing`, `free-tools`, `referrals` |
| **Strategy** | `marketing-ideas`, `marketing-psychology`, `launch` |
资料来源：[README.md:1-10]()
## Skill Structure
Each skill resides in its own directory with a standardized structure:
```
skills/your-skill-name/
├── SKILL.md # Required - main instructions
├── references/ # Optional - additional documentation
│ └── guide.md
├── scripts/ # Optional - executable code
│ └── helper.py
└── assets/ # Optional - templates, images, data
└── template.json
```
资料来源：[CONTRIBUTING.md:1-30]()
### SKILL.md Format
Every skill requires a `SKILL.md` file with YAML frontmatter:
```yaml
---
name: your-skill-name
description: When to use this skill. Include trigger phrases and keywords that help agents identify relevant tasks.
---
# Your Skill Name
Instructions for the agent go here...
```
资料来源：[CONTRIBUTING.md:1-30]()
### Frontmatter Field Constraints
| Field | Required | Constraints |
|-------|----------|-------------|
| `name` | Yes | 1-64 chars, lowercase `a-z`, numbers, hyphens. Must match directory name. |
| `description` | Yes | 1-1024 chars. Describe what it does and when to use it. |
| `license` | No | License name (default: MIT) |
| `metadata` | No | Key-value pairs (author, version, etc.) |
资料来源：[AGENTS.md:1-50]()
## Verification and Testing
### Skills Validation
Skills are content-only with no build step. Verify manually:
| Check | Command/Action |
|-------|----------------|
| YAML frontmatter validity | Parse YAML syntax |
| `name` field matches directory | Compare values |
| `name` length constraints | 1-64 chars |
| `description` length | 1-1024 chars |
资料来源：[AGENTS.md:1-50]()
### CLI Tools Verification
CLI tools are zero-dependency Node.js scripts (Node 18+). Verify with:
```bash
# Syntax check
node --check tools/clis/.js
# Show usage (no args = help)
node tools/clis/.js
# Preview request without sending
node tools/clis/.js --dry-run
```
资料来源：[AGENTS.md:1-50]()
### Available CLI Tools
| Tool | Purpose |
|------|---------|
| `livestorm.js` | Events, sessions, people, webhooks management |
| `optimizely.js` | Experiments, pages, projects management |
资料来源：[tools/clis/livestorm.js:1-50]()
资料来源：[tools/clis/optimizely.js:1-50]()
### CLI Tool Usage Example
```bash
# Show all available commands
node tools/clis/livestorm.js
# Output structure
{
commands: {
ping: 'ping',
events: 'events [list | get --id | create --title | ...]',
sessions: 'sessions [...]',
people: 'people [list --email | get --id ]',
webhooks: 'webhooks [...]',
organization: 'organization'
},
usage: {
options: '--page --per-page '
}
}
```
## Adding New Skills
### Step 1: Create the Skill Directory
```bash
mkdir -p skills/your-skill-name
```
### Step 2: Create the SKILL.md File
Follow the frontmatter format with required `name` and `description` fields.
### Step 3: Follow Naming Conventions
| Convention | Rule |
|------------|------|
| Directory name | lowercase, hyphens only (e.g., `emails`) |
| Name field | Must match directory name exactly |
| Description | 1-1024 characters, include trigger phrases |
### Step 4: Structure Your Skill
Place supporting files in appropriate subdirectories:
- `references/` - Additional documentation
- `scripts/` - Executable code
- `assets/` - Templates, images, data files
### Step 5: Write Effective Instructions
- Keep instructions clear and agent-executable
- Include trigger phrases for skill discovery
- Provide examples where applicable
资料来源：[CONTRIBUTING.md:1-30]()
## Requesting New Skills
You can suggest new skills by opening a skill request on GitHub:
```bash
https://github.com/coreyhaines31/marketingskills/issues/new?template=skill-request.yml
```
资料来源：[CONTRIBUTING.md:1-30]()
## Upgrading from v1.x
v2.0 introduces breaking changes:
- 17 skills were renamed
- `page-cro` and `form-cro` consolidated into single `cro` skill
- Old v1.x skill folders become stale after upgrade
If upgrading, remove old skill directories before installing v2.0.
资料来源：[README.md:1-10]()
## Quick Reference
```mermaid
graph LR
A[Install] --> B[Copy to Skills Dir]
B --> C[Validate Frontmatter]
C --> D[Agent Ready]
E[Contribute] --> F[Create Skill Dir]
F --> G[Write SKILL.md]
G --> H[Add References]
H --> I[Submit PR]
```
| Task | Command |
|------|---------|
| Clone repository | `git clone https://github.com/coreyhaines31/marketingskills.git` |
| List skills | `npx skillkit install coreyhaines31/marketingskills --list` |
| Install specific | `npx skillkit install coreyhaines31/marketingskills --skill ` |
| Verify CLI syntax | `node --check tools/clis/.js` |
---
## Skills Architecture
### 相关页面
相关主题：[Home](#home), [Conversion Optimization Skills](#conversion-skills), [Content and Copy Skills](#content-copy-skills), [SEO and Discovery Skills](#seo-discovery-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [README.md](https://github.com/coreyhaines31/marketingskills/blob/main/README.md)
- [AGENTS.md](https://github.com/coreyhaines31/marketingskills/blob/main/AGENTS.md)
- [CLAUDE.md](https://github.com/coreyhaines31/marketingskills/blob/main/CLAUDE.md)
- [CONTRIBUTING.md](https://github.com/coreyhaines31/marketingskills/blob/main/CONTRIBUTING.md)
- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)
- [skills/cro/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/SKILL.md)
# Skills Architecture
## Overview
The **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.
The 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.
资料来源：[README.md:1-15]()
## Core Concepts
### What is a Skill?
A skill is the fundamental unit of functionality in the Marketing Skills architecture. It consists of:
| Component | Type | Description |
|-----------|------|-------------|
| `SKILL.md` | Required | Main instruction file with YAML frontmatter |
| `references/` | Optional | Additional documentation and guides |
| `scripts/` | Optional | Executable code (Node.js scripts) |
| `assets/` | Optional | Templates, images, and data files |
资料来源：[CONTRIBUTING.md:18-26]()
### Skill Hierarchy
The skills are organized into a hierarchical taxonomy based on marketing function:
```mermaid
graph TD
ROOT["Marketing Skills"]
ROOT --> CONTENT["Content & Copy"]
ROOT --> SEO["SEO & Discovery"]
ROOT --> PAID["Paid & Distribution"]
ROOT --> MEASURE["Measurement & Testing"]
ROOT --> RETENTION["Retention"]
ROOT --> GROWTH["Growth Engineering"]
ROOT --> STRATEGY["Strategy & Monetization"]
CONTENT --> COPY["copywriting"]
CONTENT --> EMAILS["emails"]
CONTENT --> SOCIAL["social"]
CONTENT --> IMAGE["image"]
SEO --> SEOAUDIT["seo-audit"]
SEO --> AI["ai-seo"]
SEO --> ARCH["site-architecture"]
SEO --> SCHEMA["schema"]
PAID --> ADS["ads"]
PAID --> ADCREATIVE["ad-creative"]
MEASURE --> ANALYTICS["analytics"]
MEASURE --> AB["ab-testing"]
RETENTION --> CHURN["churn-prevention"]
GROWTH --> COMARKETING["co-marketing"]
GROWTH --> REFERRALS["referrals"]
GROWTH --> FREETOOLS["free-tools"]
STRATEGY --> IDEAS["marketing-ideas"]
STRATEGY --> PSYCH["marketing-psychology"]
STRATEGY --> LAUNCH["launch"]
```
资料来源：[README.md:35-60]()
## Skill Structure Specification
### Directory Naming Conventions
All skill directories must follow strict naming rules:
| Rule | Requirement | Example |
|------|-------------|---------|
| Case | Lowercase only | `emails`, not `Emails` |
| Separators | Hyphens only | `site-architecture`, not `site_architecture` |
| Characters | Alphanumeric + hyphens | No spaces, underscores, or special characters |
| Match | Must match `name` field exactly | Directory `cro` → name: `cro` |
资料来源：[CONTRIBUTING.md:28-32]()
### SKILL.md File Format
Each skill requires a `SKILL.md` file with YAML frontmatter:
```yaml
---
name: skill-name
description: When to use this skill. Include trigger phrases and keywords that help agents identify relevant tasks.
---
# Skill Title
Instructions for the agent go here...
```
#### Required Frontmatter Fields
| Field | Required | Constraints |
|-------|----------|-------------|
| `name` | Yes | 1-64 characters, lowercase `a-z`, numbers, hyphens. Must match directory name exactly |
| `description` | Yes | 1-1024 characters. Describe what it does and when to use it |
#### Optional Frontmatter Fields
| Field | Default | Description |
|-------|---------|-------------|
| `license` | MIT | License name for the skill content |
| `metadata` | None | Key-value pairs for author, version, etc. |
资料来源：[AGENTS.md:35-50]()
### Skill Directory Structure
```
skills/your-skill-name/
├── SKILL.md # Required - main instructions
├── references/ # Optional - additional documentation
│ └── guide.md
├── scripts/ # Optional - executable code
│ └── helper.py
└── assets/ # Optional - templates, images, data
└── template.json
```
资料来源：[CONTRIBUTING.md:20-27]()
## Skill Categories
### Content & Copy
Skills focused on written content and messaging.
| Skill | Purpose |
|-------|---------|
| `copywriting` | Marketing page copy generation |
| `copy-editing` | Edit and polish existing copy |
| `cold-email` | B2B cold outreach emails and sequences |
| `emails` | Automated email flows |
| `social` | Social media content |
| `image` | AI image generation, design tools, and optimization |
资料来源：[README.md:38-44]()
### SEO & Discovery
Skills for organic search and content discoverability.
| Skill | Purpose |
|-------|---------|
| `seo-audit` | Technical and on-page SEO analysis |
| `ai-seo` | AI search optimization (AEO, GEO, LLMO) |
| `programmatic-seo` | Scaled page generation |
| `site-architecture` | Page hierarchy, navigation, URL structure |
| `competitors` | Comparison and alternative pages |
| `schema` | Structured data implementation |
资料来源：[README.md:46-52]()
### Measurement & Testing
Skills for analytics and experimentation.
| Skill | Purpose |
|-------|---------|
| `analytics` | Event tracking setup |
| `ab-testing` | Experiment design and analysis |
资料来源：[README.md:56-58]()
### Retention & Growth
Skills focused on user retention and expansion.
| Category | Skill | Purpose |
|----------|-------|---------|
| Retention | `churn-prevention` | Cancel flows, save offers, dunning, payment recovery |
| Growth | `co-marketing` | Partner identification and joint campaigns |
| Growth | `free-tools` | Marketing tools and calculators |
| Growth | `referrals` | Referral and affiliate programs |
资料来源：[README.md:60-66]()
## Integration Architecture
### Installation Methods
The Marketing Skills architecture supports multiple installation approaches:
```mermaid
graph LR
USER["User"] --> REPO["Repository"]
REPO --> M1["Plugin Install"]
REPO --> M2["Clone & Copy"]
REPO --> M3["Git Submodule"]
REPO --> M4["SkillKit"]
M1 --> AGENTS["Agent Skills Folder"]
M2 --> AGENTS
M3 --> AGENTS
M4 --> AGENTS
```
| Method | Command | Best For |
|--------|---------|----------|
| Plugin | `/plugin install marketing-skills` | Built-in agent plugin systems |
| Clone | `git clone` + copy | Manual installation |
| Submodule | `git submodule add` | Version-controlled projects |
| SkillKit | `npx skillkit install` | Multi-agent environments |
资料来源：[README.md:8-25]()
### SkillKit Integration
For multi-agent environments, SkillKit provides unified installation:
```bash
# Install all skills
npx skillkit install coreyhaines31/marketingskills
# Install specific skills
npx skillkit install coreyhaines31/marketingskills --skill cro copywriting
# List available skills
npx skillkit install coreyhaines31/marketingskills --list
```
资料来源：[README.md:22-28]()
## Validation & Quality Standards
### Manual Verification Checklist
Since skills are content-only (no build step), manual verification is required:
| Check | Requirement |
|-------|-------------|
| YAML frontmatter | Must be valid YAML syntax |
| Name field | Must match directory name exactly |
| Name format | 1-64 chars, lowercase alphanumeric and hyphens only |
| Description | 1-1024 characters |
资料来源：[AGENTS.md:30-35]()
### CLI Tool Validation
CLI tools in `tools/clis/*.js` are zero-dependency Node.js scripts (Node 18+). Verify with:
```bash
# Syntax check
node --check tools/clis/.js
# Show usage (no args = help)
node tools/clis/.js
# Preview request without sending
node tools/clis/.js --dry-run
```
资料来源：[CLAUDE.md:28-34]()
## Version Compatibility
### v1.x to v2.0 Migration
v2.0 introduces breaking changes that require migration attention:
| Change Type | Details |
|-------------|---------|
| Renamed skills | 17 skills were renamed |
| Consolidated skills | `page-cro` + `form-cro` merged into single `cro` skill |
If upgrading from v1.x, stale old-name folders must be removed to avoid conflicts.
资料来源：[README.md:30-35]()
## Tooling & Integrations
### Integration Layer
The architecture includes a `tools/integrations/` directory for third-party service integrations:
| Integration | Purpose |
|-------------|---------|
| `postmark.md` | Email delivery and tracking API |
| `zoominfo.md` | Contact and company enrichment |
| `sanity.md` | CMS content management |
| `wordpress.md` | WordPress REST API |
| `optimizely.js` | Experimentation platform CLI |
| `livestorm.js` | Event and session management CLI |
These integrations follow a consistent documentation pattern with API endpoints, example payloads, and key object descriptions.
资料来源：[tools/integrations/*.md](https://github.com/coreyhaines31/marketingskills/tree/main/tools/integrations)
## Contributing Workflow
### Adding a New Skill
```mermaid
graph TD
START["Create skill directory"] --> YAML["Create SKILL.md with frontmatter"]
YAML --> STRUCTURE["Structure skill contents"]
STRUCTURE --> VALIDATE["Validate naming conventions"]
VALIDATE --> TEST["Test with AI agent"]
TEST --> SUBMIT["Submit via PR or issue"]
```
1. Create the skill directory: `mkdir -p skills/your-skill-name`
2. Create the `SKILL.md` file with required YAML frontmatter
3. Follow naming conventions (lowercase, hyphens only)
4. Structure with optional `references/`, `scripts/`, and `assets/` directories
5. Write clear instructions with trigger phrases for agent activation
资料来源：[CONTRIBUTING.md:10-40]()
## References
- [Agent Skills Specification](https://agentskills.io/specification.md) - Industry standard for skill definitions
- [SkillKit Repository](https://github.com/rohitg00/skillkit) - Multi-agent skill management
---
## Conversion Optimization Skills
### 相关页面
相关主题：[Analytics and Testing Skills](#analytics-testing-skills), [Content and Copy Skills](#content-copy-skills), [Retention and Growth Skills](#retention-growth-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [skills/cro/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/SKILL.md)
- [skills/cro/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/references/experiments.md)
- [skills/cro/references/form.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cro/references/form.md)
- [skills/signup/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/signup/SKILL.md)
- [skills/onboarding/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/onboarding/SKILL.md)
- [skills/onboarding/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/onboarding/references/experiments.md)
- [skills/popups/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/popups/SKILL.md)
- [skills/paywalls/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/paywalls/SKILL.md)
- [skills/paywalls/references/experiments.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/paywalls/references/experiments.md)
# Conversion Optimization Skills
## Overview
Conversion 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.
## Skill Architecture
The conversion optimization module is structured around several interconnected skills that address different stages of the user conversion funnel:
```mermaid
graph TD
CRO[Conversion Rate Optimization] --> SIGNUP[Signup Flow]
CRO --> ONBOARDING[Onboarding Sequences]
CRO --> POPUPS[Popup Strategy]
CRO --> PAYWALLS[Paywall Optimization]
SIGNUP --> FORM[Form Optimization]
ONBOARDING --> EXP[Experimentation]
POPUPS --> EXP
PAYWALLS --> EXP
EXP --> DATA[Analytics & Measurement]
```
## Core Conversion Optimization Skill (cro)
The 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.
### Experimentation Framework
The CRO skill emphasizes systematic experimentation to validate optimization hypotheses. The experimentation methodology follows a structured approach:
1. **Hypothesis Formation** - Define specific, measurable hypotheses about user behavior
2. **Variant Design** - Create alternative versions with single variable changes
3. **Traffic Allocation** - Distribute visitors across control and variant groups
4. **Statistical Validation** - Determine significance using appropriate statistical methods
5. **Iteration Cycle** - Apply learnings to subsequent optimization rounds
### Form Optimization
Form optimization represents a critical subset of CRO, focusing on reducing friction in data collection touchpoints:
| Optimization Area | Key Principles | Impact |
|------------------|----------------|--------|
| Field Count | Minimize required fields to essential data only | Reduces cognitive load |
| Field Order | Place easiest fields first | Builds momentum |
| Labels | Use clear, descriptive labels | Reduces confusion |
| Validation | Real-time inline validation | Prevents frustration |
| Autocomplete | Enable browser autocomplete where appropriate | Speeds completion |
## Signup Flow Skill
The `signup` skill addresses the critical first conversion point where visitors become registered users. It provides templates and best practices for:
- **Progressive disclosure** - Reveal additional fields only when needed
- **Social signup integration** - OAuth flows for Google, GitHub, and other providers
- **Email verification flows** - Handle verification states gracefully
- **Error recovery** - Guide users through validation failures
## Onboarding Sequences
The `onboarding` skill focuses on post-signup engagement and activation. Effective onboarding directly impacts:
- Time to first value (TTFV)
- Day-7 and Day-30 retention rates
- Feature adoption breadth
### Onboarding Experiment Patterns
Onboarding optimization benefits from continuous experimentation. Common experiment categories include:
| Experiment Type | Description | Success Metric |
|----------------|-------------|----------------|
| Tooltip placement | Where and when guidance appears | Feature discovery rate |
| Walkthrough length | Number of steps in initial tour | Completion rate |
| Skip options | Immediate access to product vs. forced tour | Long-term engagement |
| Checklist style | Gamified vs. straightforward checklists | Activation rate |
## Popup Strategy
The `popups` skill provides guidance on leveraging modals and overlays for conversion without degrading user experience. Key principles include:
- **Trigger timing** - Exit intent, scroll depth, time on page
- **Frequency capping** - Prevent popup fatigue
- **Personalization** - Match content to user segments
- **Mobile considerations** - Full-screen overlays vs. banners
## Paywall Optimization
The `paywalls` skill addresses conversion moments where users encounter monetization barriers. Optimization strategies include:
- **Metered paywall calibration** - Free article limits that balance traffic and conversion
- **Upgrade prompts** - When and how to present upgrade opportunities
- **Feature differentiation** - Clearly communicating free vs. paid tier capabilities
- **Dunning sequences** - Recovering failed payments and reducing churn
### Paywall Experiment Variables
| Variable | Options | Considerations |
|----------|---------|----------------|
| Display trigger | Scroll %, time on site, exit intent | User intent signals |
| Hard vs. soft | Complete block vs. partial preview | Revenue vs. engagement |
| Pricing presentation | Monthly vs. annual emphasis | Perceived value |
| CTA copy | Action-oriented vs. benefit-oriented | Conversion psychology |
## Integration with Analytics
Conversion optimization skills integrate with the broader analytics skill to enable data-driven decisions:
- **Event tracking** - Capture micro-conversions throughout flows
- **Funnel analysis** - Identify drop-off points
- **A/B testing infrastructure** - Support for controlled experiments
- **Attribution modeling** - Understand which touchpoints drive conversions
## Skill Metadata Schema
Conversion optimization skills follow the standard skill metadata schema:
```yaml
---
name: cro
description: Conversion rate optimization methodologies for improving conversion rates across signup, onboarding, and monetization touchpoints.
license: MIT
metadata:
version: 2.0
author: marketingskills
---
```
## Related Skills
The conversion optimization ecosystem connects to several adjacent skills:
- **seo-audit** - Technical optimization supporting conversion
- **ab-testing** - Experimental methodology foundation
- **analytics** - Measurement and data infrastructure
- **emails** - Post-conversion nurture sequences
- **schema** - Structured data for search appearance optimization
## Best Practices Summary
1. **Start with analysis** - Identify drop-off points before implementing changes
2. **One variable at a time** - Isolate changes to understand impact
3. **Respect statistical significance** - Avoid decisions based on insufficient sample sizes
4. **Mobile-first** - Optimize for mobile conversion flows first
5. **Continuous iteration** - Treat optimization as an ongoing process, not a one-time effort
---
## Content and Copy Skills
### 相关页面
相关主题：[Conversion Optimization Skills](#conversion-skills), [SEO and Discovery Skills](#seo-discovery-skills), [Sales and RevOps Skills](#sales-revops-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [skills/copywriting/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/SKILL.md)
- [skills/copywriting/references/copy-frameworks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/references/copy-frameworks.md)
- [skills/copywriting/references/natural-transitions.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/copywriting/references/natural-transitions.md)
- [skills/copy-editing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skkills/copy-editing/SKILL.md)
- [skills/cold-email/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/SKILL.md)
- [skills/cold-email/references/frameworks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/frameworks.md)
- [skills/cold-email/references/subject-lines.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/subject-lines.md)
- [skills/cold-email/references/personalization.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/cold-email/references/personalization.md)
- [skills/emails/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/emails/SKILL.md)
- [skills/emails/references/sequence-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/emails/references/sequence-templates.md)
- [skills/social/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social/SKILL.md)
- [skills/social/references/post-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/social/references/post-templates.md)
# Content and Copy Skills
The 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.
## Overview and Architecture
The 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.
```mermaid
graph TD
COPY["Copywriting
Marketing Page Copy"] --> EDIT["Copy-Editing
Polish & Refine"]
COPY --> EMAIL["Automated Emails
Email Flows"]
COLD["Cold Email
B2B Outreach"] --> EMAIL
EMAIL --> SOCIAL["Social Media
Content Distribution"]
COPY --> SOCIAL
style COPY fill:#e1f5fe
style EDIT fill:#fff3e0
style EMAIL fill:#e8f5e9
style COLD fill:#fce4ec
style SOCIAL fill:#f3e5f5
```
The primary skills in this module include:
| Skill | Directory | Purpose |
|-------|-----------|---------|
| **Copywriting** | `skills/copywriting/` | Generate marketing page copy and promotional content |
| **Copy-Editing** | `skills/copy-editing/` | Edit and polish existing copy to professional standards |
| **Cold Email** | `skills/cold-email/` | B2B cold outreach emails and multi-step sequences |
| **Emails** | `skills/emails/` | Automated email flows and drip campaigns |
| **Social** | `skills/social/` | Social media content creation and posting strategy |
资料来源：[README.md:1-20]()
## Copywriting Skill
The 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.
### Skill Structure
Each copywriting skill implementation follows a standardized directory structure:
```
skills/copywriting/
├── SKILL.md # Main instructions and usage guidelines
├── references/
│ ├── copy-frameworks.md # Proven copywriting frameworks
│ └── natural-transitions.md # Smooth copy transition techniques
├── scripts/ # Optional automation helpers
└── assets/ # Templates and example data
```
资料来源：[CONTRIBUTING.md:1-20]()
### Core Copywriting Frameworks
The 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.
**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.
**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.
**Feature-Benefit Bridge** transforms technical product features into tangible benefits that resonate with customer needs and desires.
资料来源：[skills/copywriting/references/copy-frameworks.md](skills/copywriting/references/copy-frameworks.md)
### Natural Transitions
Effective marketing copy requires smooth transitions between sections to maintain reader engagement and logical flow. The natural transitions reference guide provides techniques for connecting:
- Headlines to subheadings
- Benefits to proof points
- Objections to responses
- CTAs to supporting context
These transitions prevent jarring shifts in tone or topic that can cause readers to disengage from the content.
资料来源：[skills/copywriting/references/natural-transitions.md](skills/copywriting/references/natural-transitions.md)
## Copy-Editing Skill
The 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.
### Editorial Standards
The skill enforces several key editorial standards:
- **Grammar and Syntax**: Ensures proper sentence structure, verb agreement, and punctuation usage
- **Consistency**: Maintains uniform tone, style, and terminology throughout the document
- **Clarity**: Removes ambiguous phrases and complex jargon that may confuse readers
- **Pacing**: Adjusts sentence length and paragraph structure for optimal readability
- **Voice**: Ensures the copy maintains consistent brand voice and tone
### Editing Workflow
The copy-editing process follows a systematic approach:
1. **Structural Review**: Examine overall document organization and logical flow
2. **Line Editing**: Refine individual sentences for clarity and impact
3. **Copy Editing**: Check grammar, punctuation, and style consistency
4. **Final Polish**: Verify formatting, spacing, and visual presentation
资料来源：[skills/copy-editing/SKILL.md](skills/copy-editing/SKILL.md)
## Cold Email Skill
The 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.
### Cold Email Components
Each cold email follows a structured format that maximizes response rates:
```mermaid
graph LR
A["Subject Line
Personalized Hook"] --> B["Opening
Immediate Value"]
B --> C["Body
Problem/Solution"]
C --> D["CTA
Clear Next Step"]
D --> E["Signature
Credibility"]
style A fill:#ffcdd2
style B fill:#c8e6c9
style C fill:#bbdefb
style D fill:#fff9c4
style E fill:#e1bee7
```
### Subject Line Strategies
Subject lines determine whether cold emails get opened. The skill provides multiple approaches:
- **Curiosity Gap**: Creates intrigue by implying missing information
- **Personalization**: Uses recipient's name, company, or recent activity
- **Value Proposition**: Clearly states the benefit of reading
- **Question Format**: Engages through rhetorical or genuine questions
- **Social Proof**: References mutual connections or recognizable companies
资料来源：[skills/cold-email/references/subject-lines.md](skills/cold-email/references/subject-lines.md)
### Personalization Techniques
Effective cold emails feel personalized rather than mass-sent. The skill teaches several personalization dimensions:
- **Company Research**: Reference recent news, funding rounds, or product launches
- **Role-Based Messaging**: Tailor content to the recipient's job function
- **Industry Context**: Reference challenges specific to their sector
- **Mutual Connections**: Mention shared contacts or associations
- **Behavioral Triggers**: Reference actions like conference attendance or content consumption
资料来源：[skills/cold-email/references/personalization.md](skills/cold-email/references/personalization.md)
### Cold Email Frameworks
The skill implements several proven outreach frameworks:
**AIDA (Attention-Interest-Desire-Action)** guides the prospect through a logical progression from initial awareness to taking action.
**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.
**The 5-Step Icebreaker** uses a series of low-commitment questions or observations to establish rapport before making an ask.
资料来源：[skills/cold-email/references/frameworks.md](skills/cold-email/references/frameworks.md)
## Automated Emails Skill
The 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.
### Email Sequence Types
| Sequence Type | Purpose | Typical Length | Primary Goal |
|--------------|---------|----------------|---------------|
| Welcome Series | Introduce new subscribers to the brand | 3-5 emails | Engagement, education |
| Nurture Sequence | Build relationships with leads | 5-10 emails | Trust building |
| Onboarding | Help customers use the product | 5-15 emails | Activation, adoption |
| Re-engagement | Win back inactive subscribers | 3-5 emails | Retention |
| Post-Purchase | Follow up after transactions | 2-5 emails | Satisfaction, upsells |
资料来源：[skills/emails/SKILL.md](skills/emails/SKILL.md)
### Sequence Templates
The skill includes pre-built sequence templates that can be customized for specific use cases. Each template includes:
- Email subject line variations
- Optimal send timing between emails
- Content structure for each message
- Fallback sequences for non-responders
- Success metrics and milestones
资料来源：[skills/emails/references/sequence-templates.md](skills/emails/references/sequence-templates.md)
### Email Components
All emails generated by this skill follow a consistent structure:
**Subject Line**: Optimized for inbox placement and open rates, incorporating personalization tokens and preview text optimization.
**Preheader**: The preview text that appears after the subject line in most email clients, providing additional context.
**Email Body**: The main content, formatted for readability with appropriate spacing, hierarchy, and visual elements.
**Call to Action**: Clear, prominent CTAs with multiple variations for A/B testing.
**Footer**: Required legal information, unsubscribe links, and physical address.
## Social Media Skill
The social skill enables creation of social media content across multiple platforms. It handles the unique requirements of each platform while maintaining consistent brand messaging.
### Platform Adaptations
Each social platform has distinct characteristics that require content adaptation:
| Platform | Content Style | Optimal Length | Best For |
|----------|--------------|----------------|----------|
| LinkedIn | Professional, thought leadership | 150-300 words | B2B content |
| Twitter/X | Concise, timely, conversational | 100-280 characters | News, updates |
| Instagram | Visual-first, story-driven | Caption 125-150 words | Lifestyle, products |
| Facebook | Community-focused, varied format | 40-80 words | Engagement |
资料来源：[skills/social/SKILL.md](skills/social/SKILL.md)
### Post Templates
The skill provides templates for common social media post types:
- **Educational Posts**: Tips, how-tos, and industry insights
- **Promotional Posts**: Product features, offers, and announcements
- **Engagement Posts**: Questions, polls, and discussion starters
- **Social Proof Posts**: Testimonials, case studies, user-generated content
- **Behind-the-Scenes**: Team features, company culture, process insights
资料来源：[skills/social/references/post-templates.md](skills/social/references/post-templates.md)
## Integration Workflows
The Content and Copy Skills are designed to work together in integrated workflows that span the entire content lifecycle.
```mermaid
graph TD
DRAFT["Draft Copy
Copywriting"] --> EDIT["Edit & Polish
Copy-Editing"]
EDIT --> DIST["Distribute Content"]
DIST --> COLD["Cold Outreach
Cold Email"]
DIST --> AUTO["Automated Flows
Emails"]
DIST --> SOCIAL["Social Posts
Social Media"]
COLD --> TRACK["Track & Optimize"]
AUTO --> TRACK
SOCIAL --> TRACK
TRACK --> INSIGHTS["Insights
Analytics"]
INSIGHTS --> DRAFT
style DRAFT fill:#e3f2fd
style EDIT fill:#fff8e1
style DIST fill:#f1f8e9
style COLD fill:#fce4ec
style AUTO fill:#e8f5e9
style SOCIAL fill:#f3e5f5
style TRACK fill:#eceff1
style INSIGHTS fill:#e0f7fa
```
### Typical Content Pipeline
1. **Initial Draft**: Use copywriting skill to generate initial marketing copy
2. **Refinement**: Apply copy-editing skill to polish and professionalize the copy
3. **Adaptation**: Transform the core copy into platform-specific variations for cold email, automated emails, and social posts
4. **Personalization**: Apply personalization techniques from cold email and social skills
5. **Scheduling**: Organize content into appropriate sending schedules
6. **Measurement**: Track engagement metrics to inform future iterations
## Quality Standards
All Content and Copy Skills adhere to consistent quality standards:
### Voice and Tone Guidelines
| Aspect | Standard |
|--------|----------|
| **Perspective** | Second person ("you") for reader focus |
| **Tense** | Present tense for immediacy, future tense for promises |
| **Complexity** | Plain language; avoid jargon unless appropriate |
| **Sentence Length** | 15-25 words average; mix lengths for rhythm |
| **Paragraph Length** | 2-4 sentences maximum for digital content |
### SEO Considerations
Content generated by these skills should incorporate basic SEO principles:
- Primary keywords in headlines and early in content
- Natural keyword density without stuffing
- Clear hierarchical structure with H2 and H3 headings
- Internal linking opportunities identified
- Meta descriptions and title tags for web content
### Compliance Requirements
For regulated industries or jurisdictions, skills include safeguards for:
- Clear disclosure of paid promotions and sponsored content
- Proper attribution for third-party claims
- Accessibility standards (alt text, readable contrast)
- Email unsubscribe compliance
## Best Practices
### Copywriting Best Practices
- Lead with the customer's problem, not the product
- Use specific numbers and statistics for credibility
- Include social proof early in the copy
- Make the CTA specific and action-oriented
- Test multiple headline variations
### Email Best Practices
- Personalize subject lines and preview text
- Send at optimal times for the target audience
- Maintain consistent sender identity
- Use a single clear CTA per email
- Include plain text alternatives
### Cold Email Best Practices
- Research prospects before reaching out
- Lead with value, not immediate asks
- Keep emails short and scannable
- Follow up multiple times with different angles
- Track metrics and iterate based on results
## Related Skills
The Content and Copy Skills connect to other marketing skills in the repository:
- **CRO (Conversion Rate Optimization)**: Optimizes copy for conversions
- **Analytics**: Measures content performance
- **A/B Testing**: Tests copy variations
- **SEO Audit**: Ensures content is discoverable
- **Programmatic SEO**: Scales content production
## Conclusion
The 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.
---
## SEO and Discovery Skills
### 相关页面
相关主题：[Content and Copy Skills](#content-copy-skills), [Paid Advertising Skills](#paid-advertising-skills)
Related Source Files
以下源码文件用于生成本页说明：
- [skills/seo-audit/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/SKILL.md)
- [skills/seo-audit/references/ai-writing-detection.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/seo-audit/references/ai-writing-detection.md)
- [skills/ai-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/SKILL.md)
- [skills/ai-seo/references/platform-ranking-factors.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ai-seo/references/platform-ranking-factors.md)
- [skills/programmatic-seo/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/programmatic-seo/SKILL.md)
- [skills/site-architecture/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/SKILL.md)
- [skills/site-architecture/references/navigation-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/navigation-patterns.md)
- [skills/competitors/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitors/SKILL.md)
- [skills/competitor-profiling/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/competitor-profiling/SKILL.md)
- [skills/schema/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/schema/SKILL.md)
- [skills/content-strategy/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/content-strategy/SKILL.md)
# SEO and Discovery Skills
The 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.
## Overview
This 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.
### Skill Categories
| Category | Primary Skills | Purpose |
|----------|---------------|---------|
| **Technical SEO** | `seo-audit` | Technical and on-page SEO analysis |
| **AI Optimization** | `ai-seo` | AI search optimization (AEO, GEO, LLMO) |
| **Scale SEO** | `programmatic-seo` | Scaled page generation |
| **Site Structure** | `site-architecture` | Page hierarchy, navigation, URL structure |
| **Competitor Analysis** | `competitors`, `competitor-profiling` | Comparison and alternative pages |
| **Structured Data** | `schema` | Structured data implementation |
## Architecture
```mermaid
graph TD
A[SEO Strategy] --> B[Site Architecture]
A --> C[Content Strategy]
B --> D[Navigation Patterns]
B --> E[URL Structure]
C --> F[Programmatic SEO]
C --> G[Schema Markup]
A --> H[Competitor Analysis]
H --> I[Competitor Profiling]
H --> J[Competitor Comparison]
F --> K[AI SEO Optimization]
G --> K
K --> L[AI Writing Detection]
A --> M[SEO Audit]
M --> N[Technical Analysis]
M --> O[On-Page Analysis]
```
## Site Architecture Skill
The `site-architecture` skill focuses on establishing optimal page hierarchies, navigation systems, and URL structures that both users and search engines can efficiently navigate.
### Hub-and-Spoke Content Model
This model demonstrates the relationship between a central hub page connecting to multiple spoke articles, with spokes linking to each other for cross-navigation.
```mermaid
graph TD
HUB["SEO Guide
(Hub Page)"]
HUB --> S1["Keyword Research"]
HUB --> S2["On-Page SEO"]
HUB --> S3["Technical SEO"]
HUB --> S4["Link Building"]
S1 -.-> S2
S2 -.-> S3
S3 -.-> S4
style HUB fill:#f9f,stroke:#333,stroke-width:2px
```
Legend:
- Solid lines indicate primary hub-spoke links
- Dashed lines indicate cross-links between spokes
### Internal Linking Flow
The internal linking structure connects different site sections to distribute page authority effectively.
```mermaid
graph LR
subgraph "Marketing"
HOME["Homepage"]
FEAT["Features"]
PRICE["Pricing"]
end
subgraph "Content"
BLOG["Blog"]
GUIDE["Guides"]
CASE["Case Studies"]
end
subgraph "Product"
DOCS["Docs"]
API["API Ref"]
CHANGE["Changelog"]
end
HOME --> FEAT
HOME --> BLOG
BLOG --> FEAT
BLOG --> CASE
CASE --> FEAT
CASE --> PRICE
FEAT --> DOCS
GUIDE --> BLOG
GUIDE --> DOCS
```
### Navigation Patterns
#### Breadcrumb Standards
Breadcrumbs provide users with a clear path back to the site root and help search engines understand page hierarchy.
**Standard Format:**
```
Home > Features > Analytics
Home > Blog > SEO Category > How to Do Keyword Research
Home > Docs > API Reference > Authentication
```
**Rules:**
- Use `>` or `/` as separators consistently
- Every segment must be a link except the current page
- Current page appears as plain text (not linked)
- Omit the current page if the title is already visible as an H1
#### Schema Markup Implementation
Breadcrumb schema markup improves search result appearance through rich snippets.
```html
```
## SEO Audit Skill
The `seo-audit` skill provides comprehensive technical and on-page SEO analysis capabilities to identify optimization opportunities and technical issues.
### AI Writing Detection
The 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.
**Key Detection Areas:**
- Linguistic pattern analysis
- Uniqueness scoring
- Content authenticity verification
资料来源：[skills/seo-audit/references/ai-writing-detection.md]()
### Technical SEO Components
| Component | Description |
|-----------|-------------|
| Crawlability Analysis | Site structure accessibility for search bots |
| Indexability Assessment | Page indexing status and coverage |
| Meta Tag Evaluation | Title, description, and Open Graph tags |
| Content Quality | Duplicate content, thin content identification |
| Performance Metrics | Core Web Vitals alignment |
## AI SEO Skill
The `ai-seo` skill addresses the emerging discipline of optimizing content for AI-powered search platforms and generative engines.
### Generative Engine Optimization (GEO)
GEO focuses on optimizing content for citation by AI assistants including ChatGPT, Claude, Perplexity, and Gemini.
### GEO Content Patterns
#### E-E-A-T Emphasis Block
E-E-A-T (Experience, Expertise, Authoritativeness, Trustworthiness) serves as the cornerstone of Google's content quality evaluation.
```markdown
E-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.
```
#### Statistic Citation Block
Statistics increase AI citation rates by 15-30%. Always include sources.
```markdown
Mobile 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.
```
#### Self-Contained Answer Block
Create quotable, standalone statements that AI systems can extract directly.
```markdown
**[Topic/Question]**: [Complete, self-contained answer that makes sense without additional context. Include specific details, numbers, or examples in 2-3 sentences.]
```
**Example:**
```markdown
**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.
```
#### Evidence Sandwich Block
Structure claims with evidence for maximum credibility.
```markdown
[Opening claim statement].
Evidence supporting this includes:
- [Data point 1 with source]
- [Data point 2 with source]
- [Data point 3 with source]
[Concluding statement connecting evidence to actionable insight].
```
### Domain-Specific GEO Tactics
Different content domains benefit from different authority signals:
| Domain | Authority Signals |
|--------|------------------|
| **Technology** | Technical precision, version numbers, official documentation, code examples |
| **Health/Medical** | Peer-reviewed studies with publication details |
| **Finance** | Regulatory compliance, expert credentials, data sources |
| **E-commerce** | Product specifications, user reviews, pricing transparency |
### FAQ Block Pattern
Use for "How do I...", "What is...", and "Why..." queries that commonly appear in featured snippets.
```markdown
**[Question]**: [Direct answer in the first sentence]. [Supporting context in 2-3 additional sentences].
```
**Tips for FAQ questions:**
- Use natural question phrasing ("How do I..." not "How does one...")
- Include question words: what, how, why, when, where, who, which
- Match "People Also Ask" queries from search results
- Keep answers between 50-100 words
### Listicle Block Pattern
Use for "Best [X]", "Top [X]", "[Number] ways to [X]" queries.
```markdown
## [Number] Best [Items] for [Goal/Purpose]
[1-2 sentence intro establishing context and selection criteria]
### 1. [Item Name]
[Why it's included in 2-3 sentences with specific benefits]
```
## Programmatic SEO Skill
The `programmatic-seo` skill enables scaled page generation for targeting long-tail keywords and creating comprehensive content at scale.
### When to Use Programmatic SEO
- High-intent keywords with commercial value
- Template-based content with consistent structure
- Resource pages, location pages, or comparison pages
- Integration with product databases or data sources
### Content Types
| Type | Use Case | Example |
|------|----------|---------|
| **Location Pages** | Local SEO targeting | `/locations/city-name` |
| **Comparison Pages** | Product comparisons | `/compare/product-a-vs-product-b` |
| **Resource Hubs** | Curated resource collections | `/resources/best-tools` |
| **Template Libraries** | Downloadable resources | `/templates/marketing-plan` |
## Schema Skill
The `schema` skill provides structured data implementation guidelines for enhancing search result appearance through rich snippets.
### Article / BlogPosting Schema
```json
{
"@context": "https://schema.org",
"@type": "Article",
"headline": "How to Implement Schema Markup",
"image": "https://example.com/image.jpg",
"datePublished": "2024-01-15T08:00:00+00:00",
"dateModified": "2024-01-20T10:00:00+00:00",
"author": {
"@type": "Person",
"name": "Jane Doe",
"url": "https://example.com/authors/jane"
},
"publisher": {
"@type": "Organization",
"name": "Example Company",
"logo": {
"@type": "ImageObject",
"url": "https://example.com/logo.png"
}
},
"description": "A complete guide to implementing schema markup...",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://example.com/schema-guide"
}
}
```
### Product Schema
```json
{
"@context": "https://schema.org",
"@type": "Product",
"name": "Premium Widget",
"image": "https://example.com/widget.jpg",
"description": "High-quality widget for professional use",
"sku": "WIDGET-001",
"brand": {
"@type": "Brand",
"name": "ExampleCorp"
},
"offers": {
"@type": "Offer",
"price": "99.99",
"priceCurrency": "USD",
"availability": "https://schema.org/InStock"
}
}
```
### SearchAction Schema
```json
{
"@type": "WebSite",
"name": "Example Site",
"url": "https://example.com",
"potentialAction": {
"@type": "SearchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://example.com/search?q={search_term_string}"
},
"query-input": "required name=search_term_string"
}
}
```
## Competitor Profiling Skill
The `competitor-profiling` skill enables systematic analysis of competitor websites to extract positioning, features, pricing, and messaging intelligence.
### Research Process
#### Phase 1: Site Scraping (Firecrawl)
##### Step 1: Map the Site
Use **Firecrawl Map** to discover the competitor's site structure and identify key pages:
```
firecrawl_map → competitor URL
```
From the map, identify and prioritize these page types:
| Page Type | Priority Content |
|-----------|-----------------|
| Homepage | Headline, subheadline, value proposition, primary CTA |
| Pricing | Tiers, prices, feature breakdown, billing options |
| Features | Feature categories, key capabilities |
| About | Company positioning, team, culture |
| Blog | Content strategy signals |
| Customers | Case studies, testimonials |
| Integrations | Partnership ecosystem |
| Changelog | Product development direction |
##### Step 2: Scrape Key Pages
```
firecrawl_scrape → each key page URL
```
Save results to `competitor-profiles/raw///scrapes/.md` before extracting fields.
### Data Extraction Matrix
| Page | What to Extract |
|------|----------------|
| Homepage | Headline, subheadline, value proposition, primary CTA, social proof claims, target audience signals |
| Pricing | Tiers, prices, feature breakdown per tier, billing options, free tier/trial details |
| Features | Feature categories, key capabilities, how they describe each feature |
### Competitor Comparison Skill
The `competitors` skill focuses on creating comparison and alternative pages that position your offering against competitors.
## Content Strategy Integration
The `content-strategy` skill provides the foundational content planning that supports all SEO activities.
### SEO Fields Checklist
Every page-level content type needs:
| Field | Description | Character Limit |
|-------|-------------|-----------------|
| `metaTitle` | Page title for search results | 50-60 characters |
| `metaDescription` | Meta description for snippets | 150-160 characters |
| `ogImage` | Social preview image | 1200x630px |
| `slug` | URL path segment | Short, descriptive |
| `canonicalUrl` | Optional override for duplicate content | — |
| `noIndex` | Boolean for excluding from search | — |
| `structuredData` | Optional JSON-LD override | Valid schema |
### Editorial Workflow
```mermaid
graph LR
A[Draft] --> B[Review]
B --> C[Approve]
C --> D[Schedule]
D --> E[Publish]
style A fill:#f9f
style E fill:#9f9
```
### Preview APIs
All major headless CMS platforms support draft previews:
| Platform | Preview Method |
|----------|---------------|
| Sanity | Real-time preview with `useLiveQuery` or Presentation tool |
| Contentful | Preview API (`preview.contentful.com`) with separate access token |
| Strapi | Draft & Publish system with `status=draft` query parameter (v5) |
### Content Pillars
Content pillars are the 3-5 core topics your brand will own. Each pillar spawns a cluster of related content.
**Types of Shareable Content:**
- **Thought Leadership**: Articulate concepts everyone feels but hasn't named
- **Data-Driven Content**: Product data analysis, public data analysis, original research
- **Expert Roundups**: 15-30 experts answering one specific question
- **Case Studies**: Challenge → Solution → Results → Key learnings
- **Meta Content**: Behind-the-scenes transparency
## Tool Integrations
### Google Search Console API
**Rate Limits:**
- 200 queries per minute
- 1,200 requests per minute
**Available Dimensions:**
- `query` - Search query
- `page` - Page URL
- `country` - Country code
- `device` - Device type (MOBILE, DESKTOP, TABLET)
- `date` - Date
- `searchAppearance` - Search result type
**Key Metrics:**
| Metric | Description |
|--------|-------------|
| `clicks` | Clicks from search |
| `impressions` | Search impressions |
| `ctr` | Click-through rate |
| `position` | Average position |
**Search Analytics Query Example:**
```bash
POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query
{
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": ["country", "query"],
"rowLimit": 100
}
```
### Firecrawl Tools
| Tool | Purpose | Best For |
|------|---------|----------|
| `firecrawl_map` | Discover site structure | Initial competitor research |
| `firecrawl_scrape` | Extract content from pages | Detailed page analysis |
| `firecrawl_crawl` | Crawl multiple pages | Deep profiles, many pages |
| `firecrawl_extract` | Extract structured data | Consistent data format |
### DataForSEO Tools
**Domain-Level Intelligence:**
| Tool | Purpose | Key Metrics |
|------|---------|-------------|
| `backlinks_summary` | Domain authority overview | `domain_rank`, `total_backlinks`, `referring_domains` |
| `backlinks_referring_domains` | Top referring domains | Per-domain rank, backlinks, domain |
| `dataforseo_labs_google_domain_rank_overview` | Organic search overview | `organic_count`, `organic_traffic`, `organic_cost` |
## Workflow Summary
```mermaid
graph TD
A[Competitor Research] --> B[Site Architecture Planning]
B --> C[Content Strategy Development]
C --> D[Programmatic SEO Implementation]
D --> E[Schema Markup]
E --> F[AI SEO Optimization]
F --> G[Technical SEO Audit]
G --> H[Content Optimization]
H --> I[Monitoring & Iteration]
I --> A
style A fill:#9f9
style I fill:#9f9
```
## Key Performance Indicators
| KPI | Tool Source | Target Range |
|-----|-------------|--------------|
| Organic Traffic Growth | Google Search Console | MoM increase |
| Keyword Rankings | Ahrefs/DataForSEO | Top 10 positions |
| Click-Through Rate | Google Search Console | >3% |
| Index Coverage | Google Search Console | >95% |
| Core Web Vitals | PageSpeed Insights | Pass status |
| AI Citation Rate | Manual tracking | Industry benchmark |
## Related Skills
- **Analytics** (`analytics`) - Event tracking setup and performance measurement
- **A/B Testing** (`ab-testing`) - Experiment design for SEO optimization
- **Copywriting** (`copywriting`) - Marketing page copy optimization
---
## Paid Advertising Skills
### 相关页面
相关主题：[SEO and Discovery Skills](#seo-discovery-skills), [Analytics and Testing Skills](#analytics-testing-skills), [Content and Copy Skills](#content-copy-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [skills/ads/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ads/SKILL.md)
- [skills/ad-creative/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ad-creative/SKILL.md)
- [skills/ad-creative/references/platform-specs.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ad-creative/references/platform-specs.md)
- [skills/ads/references/ad-copy-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ads/references/ad-copy-templates.md)
- [tools/integrations/linkedin-ads.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/linkedin-ads.md)
# Paid Advertising Skills
## Overview
The 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.
The 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]()
## Architecture
### Skill Components
```mermaid
graph TD
subgraph "Paid Advertising System"
ADS[ads
Campaign Strategy & Optimization]
AD_CREATIVE[ad-creative
Ad Copy Generation]
PLATFORM_SPECS[platform-specs
Platform Specifications]
COPY_TEMPLATES[ad-copy-templates
Copy Formulas]
end
subgraph "External Integrations"
GOOGLE[Google Ads]
META[Meta Ads]
LINKEDIN[LinkedIn Ads]
TIKTOK[TikTok Ads]
end
ADS --> AD_CREATIVE
AD_CREATIVE --> PLATFORM_SPECS
AD_CREATIVE --> COPY_TEMPLATES
ADS --> GOOGLE
ADS --> META
ADS --> LINKEDIN
ADS --> TIKTOK
```
### Relationship to Other Skills
The `ads` skill serves as the foundation for paid advertising operations and references other skills for complementary functionality:
- **copywriting**: For landing page copy where ad traffic lands
- **ab-testing**: For structuring creative tests with statistical rigor
- **marketing-psychology**: For psychological principles behind high-performing creative
- **copy-editing**: For polishing ad copy before launch
- **analytics**: For measuring and interpreting campaign performance
资料来源：[skills/ads/SKILL.md:180-195]()
## Campaign Structure Best Practices
### Account Organization Hierarchy
```mermaid
graph TD
ACCOUNT[Account] --> CAMPAIGN1[Campaign 1
Objective - Audience/Product]
ACCOUNT --> CAMPAIGN2[Campaign 2
Objective - Audience/Product]
CAMPAIGN1 --> ADSET1[Ad Set 1
Targeting Variation]
CAMPAIGN1 --> ADSET2[Ad Set 2
Targeting Variation]
ADSET1 --> AD1[Ad 1
Creative Variation A]
ADSET1 --> AD2[Ad 2
Creative Variation B]
ADSET1 --> AD3[Ad 3
Creative Variation C]
ADSET2 --> AD4[Ad 4
Creative Variation D]
```
### Naming Conventions
| Element | Format | Example |
|---------|--------|---------|
| Campaign | `[Platform]_[Objective]_[Audience]_[Offer]_[Date]` | `META_Conv_Lookalike-Customers_FreeTrial_2024Q1` |
| Ad Set | `[Platform]_[Objective]_[Targeting]` | `GOOG_Search_BrandTerms` |
| Ad | `[Platform]_[CreativeType]_[Angle]_[Variant]` | `LI_Text_Problem-Solution_A` |
资料来源：[skills/ads/SKILL.md:85-110]()
### Budget Allocation Strategy
| Phase | Duration | Budget Split | Notes |
|-------|----------|--------------|-------|
| **Testing** | 2-4 weeks | 70% proven / 30% new tests | Validate hypotheses |
| **Scaling** | Ongoing | Consolidate winners | Increase 20-30% at a time |
资料来源：[skills/ads/SKILL.md:111-125]()
## Ad Copy Frameworks
### Primary Text Formulas
The system provides five core copywriting frameworks for generating compelling ad copy:
#### 1. Problem-Agitate-Solve (PAS)
```
[Problem statement] → [Agitate the pain] → [Introduce solution] → [CTA]
```
**Example:**
> Spending hours on manual reporting every week?
> While you're buried in spreadsheets, your competitors are making decisions.
> [Product] automates your reports in minutes.
> Start your free trial →
资料来源：[skills/ads/references/ad-copy-templates.md:1-20]()
#### 2. Before-After-Bridge (BAB)
```
[Current painful state] → [Desired future state] → [Your product as the bridge]
```
**Example:**
> Before: Chasing down approvals across email, Slack, and spreadsheets.
> After: Every approval tracked, automated, and on time.
> [Product] connects your tools and keeps projects moving.
资料来源：[skills/ads/references/ad-copy-templates.md:30-40]()
#### 3. Social Proof Lead
```
[Impressive stat or testimonial] → [What you do] → [CTA]
```
**Example:**
> "We cut our reporting time by 75%." — Sarah K., Marketing Director
> [Product] automates the reports you hate building.
> See how it works →
资料来源：[skills/ads/references/ad-copy-templates.md:50-60]()
#### 4. Feature-Benefit Bridge
Converts product features into customer benefits by connecting what it does to why it matters.
#### 5. Direct Response
Creates immediate action through urgency and clear next steps.
### Headline Formulas
#### For Search Ads
Focus on intent-matching headlines with clear value propositions.
#### For Social Ads
Emotionally engaging headlines designed for scroll-stopping impact.
### CTA Variations
| Category | Examples |
|----------|----------|
| **Soft CTAs** | Learn more, Discover, Explore |
| **Hard CTAs** | Buy now, Sign up, Get started |
| **Urgency CTAs** | Limited time, Don't miss out, Today only |
| **Action-Oriented** | Start free trial, Book a demo, Download now |
资料来源：[skills/ads/references/ad-copy-templates.md:60-90]()
## Platform Specifications
### Google Ads - Responsive Search Ads
| Element | Character Limit | Required | Notes |
|---------|----------------|----------|-------|
| Headline | 30 chars | 3-15 | Any 3 may be shown together |
| Description | 90 chars | 2-4 | Any 2 may be shown together |
| Display Path 1 | 15 chars | Optional | Appears after domain |
| Display Path 2 | 15 chars | Optional | Appears after path 1 |
资料来源：[skills/ad-creative/references/platform-specs.md:1-25]()
### Google Ads Headline Mix Recommendation (15 headlines)
| Category | Count | Purpose |
|----------|-------|---------|
| Keyword-focused | 3-4 | Match search intent |
| Benefit-focused | 3-4 | What they get |
| Social proof | 2-3 | Numbers, awards, customers |
| CTA-focused | 2-3 | Action to take |
| Differentiators | 2-3 | Why you over competitors |
| Brand name | 1 | Brand visibility |
资料来源：[skills/ad-creative/references/platform-specs.md:26-40]()
### Platform Selection Guide
| Platform | Best For | Audience Characteristics |
|----------|----------|-------------------------|
| **Google Search** | High intent, direct response | Active problem-solvers, ready to buy |
| **Meta (FB/IG)** | Awareness, consideration, lookalikes | Broad demographics, interest-based |
| **LinkedIn** | B2B, professional services | Decision-makers, job titles, senior roles |
| **TikTok** | Viral reach, younger demographics | 18-34, video-forward content |
资料来源：[skills/ads/SKILL.md:50-75]()
## Workflow: Pull Data, Analyze, Generate
```mermaid
graph LR
A[Pull Recent
Ad Performance] --> B[Analyze Output
Identify Winners]
B --> C[Feed Winning Patterns
Into Skill]
C --> D[Generate New
Variations]
D --> E[Upload to
Platform]
subgraph "CLI Commands"
A --> A1[node tools/clis/google-ads.js
reports get]
end
```
### Implementation
```bash
# 1. Pull recent ad performance
node tools/clis/google-ads.js reports get --type ad_performance --date-range last_30_days
# 2. Analyze output (identify top/bottom performers)
# 3. Feed winning patterns into this skill
# 4. Generate new variations
# 5. Upload to platform
```
资料来源：[skills/ad-creative/SKILL.md:45-65]()
## Output Format Standards
### Standard Output Structure
Organize output by angle with character counts:
```
## Angle: [Pain Point — Manual Reporting]
### Headlines (30 char max)
1. "Stop Building Reports by Hand" (29)
2. "Automate Your Weekly Reports" (28)
3. "Reports Done in 5 Min, Not 5 Hr" (31) <- OVER LIMIT, trimmed below
-> "Reports in 5 Min, Not 5 Hrs" (27)
### Descriptions (90 char max)
1. "Marketing teams save 5 hrs/week..."
```
### Writing Quality Standards
**Strong headlines:**
- Specific ("Cut reporting time 75%") over vague ("Save time")
- Benefits ("Ship code faster") over features ("CI/CD pipeline")
- Active voice ("Automate your reports") over passive ("Reports are automated")
- Include numbers when possible ("3x faster," "in 5 minutes," "10,000+ teams")
**Avoid:**
- Jargon the audience won't recognize
- Claims without specificity ("Best," "Leading," "Top")
- All caps or excessive punctuation
- Clickbait that the landing page can't deliver on
资料来源：[skills/ad-creative/SKILL.md:95-130]()
## Platform Integration Reference
### LinkedIn Ads
#### Campaign Types
| Type | Description |
|------|-------------|
| `SPONSORED_UPDATES` | Sponsored content in feed |
| `TEXT_AD` | Traditional text ads |
| `SPONSORED_INMAILS` | Message ads |
| `DYNAMIC` | Dynamic ads with personalization |
#### Key Metrics
| Metric | Description |
|--------|-------------|
| `impressions` | Ad impressions |
| `clicks` | Total clicks |
| `costInLocalCurrency` | Spend |
| `conversions` | Conversion count |
| `leadGenerationMailContactInfoShares` | Lead form submissions |
#### Targeting Options
- **Job-Based**: Job titles, job functions, seniority levels, years of experience
- **Company-Based**: Company names, industries, company size, company followers
- **Professional**: Skills, groups, schools, degrees
#### Rate Limits
| Access Level | Limit |
|--------------|-------|
| Basic | 100 requests/day |
| Marketing Developer Platform | 10,000 requests/day |
资料来源：[tools/integrations/linkedin-ads.md:1-60]()
## Usage Triggers
The ad-creative skill should be activated when users mention:
- "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"
- "LinkedIn ad text"
- "I need more ad variations"
The ads skill should be used for:
- Campaign strategy
- Targeting setup
- Budget allocation
- Campaign optimization
- Platform account structure
资料来源：[skills/ad-creative/SKILL.md:1-20]()
## Related Documentation
| Document | Purpose |
|----------|---------|
| `skills/ads/references/ad-copy-templates.md` | Complete copy templates and formulas |
| `skills/ad-creative/references/platform-specs.md` | Platform-specific character limits and requirements |
| `skills/ads/references/audience-targeting.md` | Audience targeting strategies |
| `skills/ads/references/conversion-tracking.md` | Conversion tracking implementation |
| `tools/integrations/linkedin-ads.md` | LinkedIn Ads API integration |
---
## Analytics and Testing Skills
### 相关页面
相关主题：[Conversion Optimization Skills](#conversion-skills), [Paid Advertising Skills](#paid-advertising-skills)
Relevant Source Files
The following source files were used to generate this page:
- [tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)
- [tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)
- [tools/integrations/optimizely.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/optimizely.md)
- [tools/integrations/keywords-everywhere.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/keywords-everywhere.md)
- [tools/integrations/semrush.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/semrush.md)
- [skills/site-architecture/references/mermaid-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/site-architecture/references/mermaid-templates.md)
- [tools/clis/optimizely.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/optimizely.js)
# Analytics and Testing Skills
The 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.
## Overview
The 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).
### Supported Platforms
| Category | Tools | Primary Use |
|----------|-------|-------------|
| Web Analytics | Google Analytics 4, Google Search Console | Traffic analysis, user behavior |
| Heatmaps & Recordings | Hotjar | Session replay, click/scroll tracking |
| SEO Intelligence | SEMrush, Keywords Everywhere | Keyword research, rank tracking |
| Experimentation | Optimizely | A/B testing, feature flags |
| CLI Tools | dub.js, optimizely.js | Command-line interface operations |
## Architecture
### Integration Architecture
The analytics and testing infrastructure follows a layered integration pattern where tools connect through standardized APIs and CLI interfaces.
```mermaid
graph TD
subgraph "Data Collection Layer"
GA4["Google Analytics 4"]
GTM["Google Tag Manager"]
HOTJAR["Hotjar"]
end
subgraph "Intelligence Layer"
GSC["Google Search Console"]
SEMRUSH["SEMrush"]
KEYWORDS["Keywords Everywhere"]
end
subgraph "Experimentation Layer"
OPTIMIZELY["Optimizely"]
end
subgraph "CLI Layer"
DUB["dub.js CLI"]
OPTCLI["optimizely.js CLI"]
end
GTM --> GA4
GSC --> INTEL["Analytics Intelligence"]
SEMRUSH --> INTEL
KEYWORDS --> INTEL
OPTIMIZELY --> EXP["Experimentation Engine"]
DUB --> DASH["Dashboard / Reports"]
OPTCLI --> EXP
```
资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)
资料来源：[tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)
## Google Analytics 4 Integration
Google Analytics 4 provides the foundation for web analytics implementation, offering event-based tracking with enhanced measurement capabilities.
### Implementation Pattern
The 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.
### Event Tracking
GA4 supports custom event tracking with parameters for:
- **User Properties**: Demographic and behavioral attributes
- **Event Parameters**: Contextual data about user actions
- **Items**: Product and inventory information for e-commerce
资料来源：[skills/analytics/references/ga4-implementation.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/ga4-implementation.md)
## Google Tag Manager Implementation
Google Tag Manager serves as the tag management system for implementing analytics and marketing tags without direct code deployment.
### Container Structure
```mermaid
graph TD
GTM["GTM Container"] --> TRIGGERS["Triggers"]
GTM --> TAGS["Tags"]
GTM --> VARIABLES["Variables"]
TRIGGERS --> PAGEVIEW["Pageview Trigger"]
TRIGGERS --> CLICK["Click Trigger"]
TRIGGERS --> CUSTOM["Custom Event"]
TAGS --> GA4TAG["GA4 Tag"]
TAGS --> ADWORDS["Google Ads Tag"]
TAGS --> CUSTOMTAG["Custom HTML"]
VARIABLES --> DOM["DOM Variables"]
VARIABLES --> DATA["Data Layer"]
VARIABLES --> CONST["Constants"]
```
资料来源：[skills/analytics/references/gtm-implementation.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/gtm-implementation.md)
## Event Library
The event library defines a standardized vocabulary for tracking user interactions across marketing properties.
### Standard Event Categories
| Category | Events | Purpose |
|----------|--------|---------|
| Page | `page_view`, `page_exit` | Navigation analysis |
| Engagement | `scroll`, `click`, `video_*` | User interaction tracking |
| Conversion | `purchase`, `sign_up`, `lead` | Goal completion |
| Commerce | `view_item`, `add_to_cart`, `checkout` | E-commerce tracking |
| Search | `search`, `refine_search` | Site search analysis |
### Event Schema
Each event follows a consistent schema structure:
```
event_name
├── timestamp
├── user_id (if authenticated)
├── session_id
├── page_location
├── page_referrer
└── event_parameters (custom)
```
资料来源：[skills/analytics/references/event-library.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/analytics/references/event-library.md)
## A/B Testing Framework
The A/B testing module provides infrastructure for systematic experimentation to optimize conversion rates and user experience.
### Research Process
```mermaid
graph TD
START["Hypothesis Formation"] --> DESIGN["Test Design"]
DESIGN --> SAMPLE["Sample Size Calculation"]
SAMPLE --> IMPLEMENT["Implement Variations"]
IMPLEMENT --> LAUNCH["Launch Test"]
LAUNCH --> MONITOR["Monitor Results"]
MONITOR --> ANALYZE["Statistical Analysis"]
ANALYZE --> DECISION["Winner Declaration"]
DECISION --> ITERATE["Iterate"]
```
资料来源：[skills/ab-testing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/SKILL.md)
### Sample Size Determination
Proper sample size calculation ensures statistical validity of test results.
| Factor | Impact | Consideration |
|--------|--------|---------------|
| Baseline Conversion | Determines effect size | Historical data required |
| Minimum Detectable Effect | Smaller effects need larger samples | Business context dependent |
| Statistical Power | Typically 80% | Affects Type II error rate |
| Significance Level | Typically 95% | Affects Type I error rate |
资料来源：[skills/ab-testing/references/sample-size-guide.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/references/sample-size-guide.md)
### Test Templates
Standardized templates accelerate test implementation:
```mermaid
graph LR
A[Control] -->|Original| B[Baseline Metrics]
C[Variation A] -->|Treatment| D[Variant Metrics]
E[Variation B] -->|Treatment| D
D --> F{Compare}
F -->|Significant| G[Declare Winner]
F -->|Not Significant| H[Extend Test]
```
资料来源：[skills/ab-testing/references/test-templates.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/ab-testing/references/test-templates.md)
## Optimizely Integration
Optimizely provides enterprise experimentation capabilities including A/B testing, feature flags, and personalization.
### API Capabilities
| Endpoint | Purpose | Parameters |
|----------|---------|------------|
| `projects.list` | List experimentation projects | `page`, `per_page` |
| `experiments.list` | List experiments in project | `project_id`, `status` |
| `experiments.create` | Create new experiment | `name`, `variations`, `metrics` |
| `results.get` | Retrieve experiment results | `experiment_id`, `start_time`, `end_time` |
### Rate Limits
- **50 requests/second** per personal token
- Pagination via `page` and `per_page` parameters
- OpenAPI specification available at `https://api.optimizely.com/v2/swagger.json`
### CLI Commands
The Optimizely CLI provides command-line access to experimentation features:
```bash
# List projects
optimizely projects list
# List experiments
optimizely experiments list --project-id
# List pages
optimizely pages list --project-id
# List options with pagination
optimizely options --page --per-page --status
```
资料来源：[tools/integrations/optimizely.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/optimizely.md)
资料来源：[tools/clis/optimizely.js](https://github.com/coreyhaines31/marketingskills/blob/main/tools/clis/optimizely.js)
## Google Search Console Integration
Google Search Console provides organic search performance data essential for SEO analytics.
### API Operations
| Operation | Endpoint | Purpose |
|-----------|----------|---------|
| Query Analysis | `searchAnalytics.query` | Search performance data |
| URL Inspection | `urlInspection.index:inspect` | Index status check |
| Sitemap Management | `sites/{siteUrl}/sitemaps` | Sitemap submission |
| Index Request | `urlNotifications:publish` | Request indexing |
### Dimensions and Metrics
**Available Dimensions:**
- `query` — Search query
- `page` — Page URL
- `country` — Country code
- `device` — Device type (MOBILE, DESKTOP, TABLET)
- `date` — Date
- `searchAppearance` — Search result type
**Metrics:**
| Metric | Description |
|--------|-------------|
| `clicks` | Clicks from search results |
| `impressions` | Search impressions |
| `ctr` | Click-through rate |
| `position` | Average search position |
### Rate Limits
- **200 queries per minute**
- **1,200 requests per minute**
### Query Example
```bash
POST https://searchconsole.googleapis.com/webmasters/v3/sites/{site_url}/searchAnalytics/query
{
"startDate": "2024-01-01",
"endDate": "2024-01-31",
"dimensions": ["country", "query"],
"rowLimit": 100
}
```
### Filter Configuration
```json
{
"dimensionFilterGroups": [{
"filters": [{
"dimension": "query",
"operator": "contains",
"expression": "keyword"
}]
}]
}
```
资料来源：[tools/integrations/google-search-console.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/google-search-console.md)
## Hotjar Integration
Hotjar provides qualitative analytics through heatmaps, session recordings, and user surveys.
### Data Types
#### Heatmap Data
| Field | Description |
|-------|-------------|
| `url` | Page URL |
| `click_count` | Total clicks tracked |
| `visitors` | Unique visitors |
| `created_at` | Heatmap creation date |
#### Recording Data
| Field | Description |
|-------|-------------|
| `recording_id` | Unique recording identifier |
| `duration` | Session duration |
| `pages_visited` | Pages in session |
| `device` | Device information |
### API Parameters
**Survey Responses:**
| Parameter | Description |
|-----------|-------------|
| `limit` | Results per page (default: 100) |
| `cursor` | Pagination cursor |
| `sort` | Sort order (default: created_at desc) |
**Recordings:**
| Parameter | Description |
|-----------|-------------|
| `limit` | Results per page |
| `cursor` | Pagination cursor |
| `date_from` | Start date filter |
| `date_to` | End date filter |
### Rate Limits
- **3,000 requests/minute** (50 per second)
- Rate limited by source IP address
- Cursor-based pagination for large result sets
### Use Cases
- Analyzing user behavior patterns on landing pages
- Collecting qualitative feedback via on-site surveys
- Identifying UX issues through session recordings
- Understanding scroll depth and engagement via heatmaps
- Validating CRO hypotheses with user behavior data
- Form abandonment analysis
资料来源：[tools/integrations/hotjar.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/hotjar.md)
## SEO Analytics Tools
### SEMrush Integration
SEMrush provides comprehensive SEO intelligence including keyword research, competitive analysis, and backlink monitoring.
#### Export Columns
| Report Type | Key Columns |
|-------------|-------------|
| **Domain Report** | `Db`, `Dn`, `Rk`, `Or`, `Ot`, `Oc` |
| **Keyword Report** | `Ph`, `Nq`, `Cp`, `Co`, `Kd`, `Nr` |
| **Backlinks** | `source_url`, `target_url`, `anchor`, `source_title` |
#### Database Coverage
Country codes supported: `us`, `uk`, `de`, `fr`, `ca`, `au`, and others.
#### Rate Limits
- Varies by plan (10-30K units/day)
- Each API call consumes units
资料来源：[tools/integrations/semrush.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/semrush.md)
### Keywords Everywhere
Keywords Everywhere provides keyword data including search volume, CPC, and competition scores.
#### Key Metrics
| Metric | Description |
|--------|-------------|
| `search_volume` | Monthly search volume |
| `cpc.value` | Cost per click |
| `competition` | Competition score |
| `trend` | 12-month trend data |
| `estimated_traffic` | Estimated monthly traffic |
| `keywords_count` | Number of ranking keywords |
#### Parameters
| Parameter | Description |
|-----------|-------------|
| `country` | Country code (us, uk, de, fr, etc.) |
| `currency` | Currency code (USD, GBP, EUR, etc.) |
| `dataSource` | Data source (default: `gkp` for Google Keyword Planner) |
| `kw` | Array of keywords (max 100 per request) |
#### Rate Limits
- **100 keywords per request**
- Credit-based pricing (1 credit per keyword)
资料来源：[tools/integrations/keywords-everywhere.md](https://github.com/coreyhaines31/marketingskills/blob/main/tools/integrations/keywords-everywhere.md)
## Workflow Integration
### Analytics Workflow
```mermaid
graph TD
subgraph "Collection"
WEB["Web Analytics"]
GSC["Search Console"]
SEO["SEO Tools"]
end
subgraph "Analysis"
PERFORMANCE["Performance Review"]
SEGMENT["Segmentation"]
FUNNEL["Funnel Analysis"]
end
subgraph "Optimization"
TEST["A/B Testing"]
PRIORITIZE["Prioritization"]
IMPLEMENT["Implementation"]
end
WEB --> PERFORMANCE
GSC --> PERFORMANCE
SEO --> SEGMENT
SEGMENT --> FUNNEL
FUNNEL --> TEST
TEST --> PRIORITIZE
PRIORITIZE --> IMPLEMENT
IMPLEMENT --> WEB
```
### Testing Workflow
```mermaid
graph LR
A[Idea] --> B[Hypothesis]
B --> C[Test Design]
C --> D[Build]
D --> E[QA]
E --> F[Launch]
F --> G[Monitor]
G --> H[Analysis]
H --> I[Decision]
I --> J[Ship Winner]
J --> K[Archive]
I --> L[Iterate]
L --> C
```
## Related Skills
| Skill | Relationship |
|-------|--------------|
| **CRO** | Conversion Rate Optimization leverages analytics for improvement identification |
| **SEO Audit** | Uses Google Search Console and SEMrush data for technical analysis |
| **Landing Page** | A/B testing targets for landing page optimization |
| **Personalization** | User behavior data drives personalization rules |
| **UX Audit** | Hotjar data informs UX improvement recommendations |
| **Programmatic SEO** | Analytics data guides programmatic content strategy |
## Best Practices
### Data Quality
1. Implement consistent event naming conventions
2. Validate tracking across all platforms before launch
3. Document custom dimensions and metrics
4. Regular audit of data collection implementation
### Experimentation
1. Calculate sample size before launching tests
2. Avoid peeking at results before statistical significance
3. Document hypotheses and success criteria
4. Test one variable per experiment when possible
### Integration
1. Use standardized API schemas across tools
2. Implement proper rate limit handling
3. Configure webhooks for real-time updates where available
4. Maintain API key security and rotation policies
## Tool Reference Summary
| Tool | Primary Function | Rate Limit |
|------|------------------|------------|
| Google Analytics 4 | Web analytics | Platform dependent |
| Google Search Console | Search performance | 200 queries/min |
| Hotjar | Qualitative analysis | 3000 requests/min |
| Optimizely | Experimentation | 50 requests/sec |
| SEMrush | SEO intelligence | 10-30K units/day |
| Keywords Everywhere | Keyword research | 100 keywords/request |
## File Structure
```
tools/
├── integrations/
│ ├── google-search-console.md
│ ├── hotjar.md
│ ├── optimizely.md
│ ├── semrush.md
│ └── keywords-everywhere.md
└── clis/
├── dub.js
└── optimizely.js
skills/
├── analytics/
│ ├── SKILL.md
│ └── references/
│ ├── ga4-implementation.md
│ ├── gtm-implementation.md
│ └── event-library.md
└── ab-testing/
├── SKILL.md
└── references/
├── sample-size-guide.md
└── test-templates.md
---
## Retention and Growth Skills
### 相关页面
相关主题：[Conversion Optimization Skills](#conversion-skills), [Sales and RevOps Skills](#sales-revops-skills), [Content and Copy Skills](#content-copy-skills)
相关源码文件
以下源码文件用于生成本页说明：
- [skills/churn-prevention/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/SKILL.md)
- [skills/churn-prevention/references/cancel-flow-patterns.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/references/cancel-flow-patterns.md)
- [skills/churn-prevention/references/dunning-playbook.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/churn-prevention/references/dunning-playbook.md)
- [skills/referrals/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/referrals/SKILL.md)
- [skills/referrals/references/program-examples.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/referrals/references/program-examples.md)
- [skills/co-marketing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/co-marketing/SKILL.md)
- [skills/free-tools/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/free-tools/SKILL.md)
- [skills/lead-magnets/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/lead-magnets/SKILL.md)
- [skills/lead-magnets/references/benchmarks.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/lead-magnets/references/benchmarks.md)
- [skills/community-marketing/SKILL.md](https://github.com/coreyhaines31/marketingskills/blob/main/skills/community-marketing/SKILL.md)
# Retention and Growth Skills
## Overview
Retention 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.
The skills in this category work together to create a comprehensive customer lifecycle management approach:
```mermaid
graph TD
A[Customer Lifecycle] --> B[Retention]
A --> C[Growth]
B --> D[Churn Prevention]
B --> E[Dunning & Recovery]
C --> F[Referral Programs]
C --> G[Lead Magnets]
C --> H[Co-Marketing]
C --> I[Free Tools]
C --> J[Community Marketing]
D --> K[Cancel Flow Patterns]
E --> L[Payment Recovery]
F --> M[Viral Growth]
G --> N[Lead Capture]
H --> O[Partnership Expansion]
I --> P[Tool-Led Acquisition]
J --> Q[Community Engagement]
```
## Skill Categories
| Skill | Primary Focus | Key Outcomes |
|-------|--------------|---------------|
| `churn-prevention` | Customer retention & cancellation prevention | Reduce churn rate, recover at-risk customers |
| `referrals` | Word-of-mouth and viral growth | Acquire customers through existing user networks |
| `lead-magnets` | Lead capture and qualification | Generate qualified leads with valuable content |
| `co-marketing` | Strategic partnerships | Expand reach through joint marketing efforts |
| `free-tools` | Tool-led acquisition | Attract users with free utility offerings |
| `community-marketing` | Community-driven growth | Build engaged user communities for organic growth |
## Churn Prevention Skill
The `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.
### Purpose and Scope
Churn 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.
### Cancel Flow Patterns
The 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.
**Key Components:**
1. **Exit Survey Integration** - Collect cancellation reasons to inform product improvements
2. **Save Offer Tiers** - Provide escalating offers based on customer value
3. **Pause Options** - Offer temporary suspension instead of cancellation
4. **Downgrade Paths** - Allow migration to lower-tier plans
```mermaid
graph TD
A[Cancel Request] --> B[Exit Survey]
B --> C{Reason Analysis}
C -->|Price| D[Discount Offer]
C -->|Value| E[Feature Highlight]
C -->|Usage| F[Onboarding Help]
C -->|Competitor| G[Competitive Analysis]
C -->|Other| H[General Retention]
D --> I[Save Flow]
E --> I
F --> I
G --> I
H --> I
I --> J{Save Success?}
J -->|Yes| K[Retained Customer]
J -->|No| L[Grace Period Offer]
L --> M[Final Save]
M -->|No| N[Cancellation Complete]
```
资料来源：[skills/churn-prevention/references/cancel-flow-patterns.md]()
### Dunning Playbook
The dunning module addresses failed payments and subscription recovery. It provides strategies for communicating payment failures, retry timing, and customer-friendly recovery processes.
**Dunning Communication Strategy:**
| Stage | Timing | Focus | Channels |
|-------|--------|-------|----------|
| First Notice | Day 1 | Gentle reminder | Email |
| Second Notice | Day 3-5 | Urgent but helpful | Email + SMS |
| Third Notice | Day 7-10 | Final warning | Email + SMS + Call |
| Grace Period | Day 14-21 | Last chance | Email + Personal outreach |
**Best Practices:**
- Use friendly, non-threatening language
- Clearly explain the issue and resolution steps
- Offer multiple payment method updates
- Include one-click payment update links
- Provide clear timeline of consequences
资料来源：[skills/churn-prevention/references/dunning-playbook.md]()
## Referrals Skill
The `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.
### Program Structure
A referral program typically consists of four key elements:
```mermaid
graph LR
A[Referrer] -->|Makes Referral| B[Referral Program]
B --> C{Eligibility Check}
C -->|Qualified| D[Reward Triggered]
C -->|Not Qualified| E[No Reward]
D --> F[Referral Becomes Customer]
F -->|Cycle| A
style A fill:#bbf
style F fill:#bbf
style D fill:#dfd
```
### Program Examples
The program examples reference provides real-world templates for different referral scenarios:
**Standard Referral:**
- Referrer receives reward when referee completes purchase
- Reward can be fixed amount, percentage, or credit
- Suitable for e-commerce and SaaS businesses
**Tiered Referral:**
- Rewards increase with number of successful referrals
- Encourages repeated advocacy
- Example: Dropbox's early referral program
**Viral Referral:**
- Double-sided rewards (both parties get benefit)
- Built-in sharing mechanics
- Example: Uber's referral system
**Milestone-Based Referral:**
- Rewards at specific referral thresholds
- Creates achievement motivation
- Example: Referral milestones at 5, 10, 25 referrals
| Program Type | Best For | Reward Structure | Key Metric |
|--------------|----------|------------------|------------|
| Standard | B2C e-commerce | Fixed discount | Conversion rate |
| Double-sided | Growth stage SaaS | Equal reward both parties | Viral coefficient |
| Tiered | Enterprise | Increasing rewards | Referrals per user |
| Milestone | Gamified experience | Badge + reward | Engagement rate |
资料来源：[skills/referrals/references/program-examples.md]()
## Lead Magnets Skill
The `lead-magnets` skill enables agents to create effective lead capture mechanisms that provide value to prospects while qualifying them for sales follow-up.
### Purpose and Strategy
Lead 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.
**Common Lead Magnet Formats:**
| Format | Example | Best For | Effort |
|--------|---------|----------|--------|
| Ebook/Guide | Industry report | Thought leadership | Medium |
| Checklist | Launch checklist | Action-oriented buyers | Low |
| Template | Email sequence template | DIY marketers | Medium |
| Tool | ROI calculator | High-intent prospects | High |
| Webinar | Training session | Engagement nurturing | Medium |
| Free Trial | Product access | Product-qualified leads | High |
### Lead Magnet Benchmarks
The benchmarks reference provides performance metrics for optimizing lead magnet effectiveness:
**Conversion Benchmarks by Type:**
- **Email signup forms**: 1-3% average conversion
- **Lead magnets**: 10-20% conversion from visitor to lead
- **Gated content**: 2-5% of website visitors
- **Exit-intent popups**: 1-2% conversion
**Best Practices:**
1. Match lead magnet format to audience preference
2. Create specific, actionable content over generic
3. Use clear, benefit-driven headlines
4. Optimize form fields (minimize friction)
5. Implement progressive profiling for returning visitors
资料来源：[skills/lead-magnets/references/benchmarks.md]()
## Co-Marketing Skill
The `co-marketing` skill facilitates partnership-driven growth through joint marketing initiatives with complementary businesses.
### Partnership Types
| Type | Description | Example |
|------|-------------|---------|
| Content Co-creation | Joint blog posts, webinars, studies | Tech company + Analytics firm |
| Event Co-marketing | Shared virtual summits, workshops | Industry associations |
| Product Integration | Embedded referrals, shared tools | SaaS integrations |
| Promotion Exchange | Cross-promotional campaigns | Complementary products |
| Research Collaboration | Joint surveys, industry reports | Think tanks + Companies |
### Implementation Checklist
- Define mutual goals and success metrics
- Establish clear value exchange
- Create joint content calendar
- Set up attribution tracking
- Agree on lead sharing process
资料来源：[skills/co-marketing/SKILL.md]()
## Free Tools Skill
The `free-tools` skill focuses on tool-led acquisition strategies where valuable free utilities attract and convert potential customers.
### Strategy Overview
Free tools leverage the "foot-in-the-door" technique by providing immediate value that builds trust and demonstrates product capability.
**Tool Categories:**
| Category | Example | Conversion Mechanism |
|----------|---------|---------------------|
| Calculators | ROI, savings, estimates | Results-based upsell |
| Generators | Logo, copy, images | Output requires paid features |
| Analyzers | SEO, website, social | Recommendations link to paid |
| Templates | Documents, spreadsheets | Premium versions available |
| Checklists | Pre-flight, audit tools | Upgrade to full version |
资料来源：[skills/free-tools/SKILL.md]()
## Community Marketing Skill
The `community-marketing` skill helps build and leverage user communities for organic growth and customer retention.
### Community Strategy
**Community Building Framework:**
```mermaid
graph TD
A[Community Goal] --> B[Platform Selection]
A --> C[Content Strategy]
A --> D[Engagement Plan]
B --> E[Slack/Discord/Facebook Groups]
B --> F[Forum/Reddit]
B --> G[Customer Community]
C --> H[User-Generated Content]
C --> I[AMAs and Q&A Sessions]
C --> J[Knowledge Sharing]
D --> K[Recognition Programs]
D --> L[Exclusive Access]
D --> M[Feedback Loops]
H --> N[Brand Advocacy]
I --> N
J --> N
K --> N
L --> N
M --> N
```
**Benefits of Community Marketing:**
- Reduced support costs through peer-to-peer help
- Increased customer retention through belonging
- Valuable user feedback and feature ideas
- Organic word-of-mouth promotion
- Brand loyalty and advocacy
**Platform Options:**
| Platform | Best For | Features |
|----------|----------|----------|
| Slack | B2B SaaS | Channels, integrations |
| Discord | Developers/Gamers | Voice, roles, bots |
| Facebook Groups | Broad audiences | Native social features |
| Circle | Content creators | Courses, memberships |
资料来源：[skills/community-marketing/SKILL.md]()
## Implementation Guidelines
### Skill Selection Matrix
| Business Goal | Primary Skill | Supporting Skills |
|---------------|---------------|-------------------|
| Reduce churn | `churn-prevention` | `community-marketing` |
| Lower CAC | `referrals` | `lead-magnets` |
| Lead volume | `lead-magnets` | `free-tools` |
| Market expansion | `co-marketing` | `referrals` |
| Product adoption | `free-tools` | `community-marketing` |
### Integration Patterns
```mermaid
graph LR
subgraph "Top of Funnel"
A[Free Tools]
B[Lead Magnets]
C[Co-Marketing]
end
subgraph "Middle of Funnel"
D[Community Marketing]
E[Lead Nurturing]
end
subgraph "Bottom of Funnel"
F[Churn Prevention]
G[Referrals]
end
A --> D
B --> D
C --> D
D --> F
F --> G
G --> A
```
## Trigger Phrases for Agent Invocation
The following phrases indicate a user needs retention and growth skill assistance:
| Skill | Trigger Phrases |
|-------|-----------------|
| Churn Prevention | "reduce churn", "customer leaving", "canceling subscription", "failed payment" |
| Referrals | "referral program", "word of mouth", "customer recommendations", "viral growth" |
| Lead Magnets | "lead generation", "capture leads", "content upgrade", "gated content" |
| Co-Marketing | "partnership", "joint marketing", "co-branded", "strategic alliance" |
| Free Tools | "free tool", "calculator", "generator", "free utility" |
| Community | "build community", "user community", "customer engagement", "brand advocates" |
## Related Skills
- **CRO Skill** - Works with churn prevention for conversion optimization
- **Analytics Skill** - Provides metrics tracking for all retention initiatives
- **Emails Skill** - Supports communication for dunning and save flows
- **Copywriting Skill** - Crafts compelling referral messages and offers
---
## Sales and RevOps Skills
### 相关页面
相关主题：[Retention and Growth Skills](#retention-growth-skills), [Content and Copy Skills](#content-copy-skills)
The 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:
- `skills/revops/SKILL.md`
- `skills/revops/references/lifecycle-definitions.md`
- `skills/revops/references/scoring-models.md`
- `skills/revops/references/routing-rules.md`
- `skills/revops/references/automation-playbooks.md`
- `skills/sales-enablement/SKILL.md`
- `skills/sales-enablement/references/deck-frameworks.md`
- `skills/sales-enablement/references/objection-library.md`
- `skills/sales-enablement/references/demo-scripts.md`
**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/`.
Please provide the Sales and RevOps source files to generate the wiki page.
---
---
## Doramagic 踩坑日志
项目：coreyhaines31/marketingskills
摘要：发现 19 个潜在踩坑项，其中 0 个为 high/blocking；最高优先级：身份坑 - 仓库名和安装名不一致。
## 1. 身份坑 · 仓库名和安装名不一致
- 严重度：medium
- 证据强度：runtime_trace
- 发现：仓库名 `marketingskills` 与安装入口 `skills` 不完全一致。
- 对用户的影响：用户照着仓库名搜索包或照着包名找仓库时容易走错入口。
- 建议检查：在 npm/PyPI/GitHub 上确认包名映射和官方 README 说明。
- 复现命令：`npx skills`
- 防护动作：页面必须同时展示 repo 名和真实安装入口，避免用户搜索错包。
- 证据：identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills
## 2. 安装坑 · 来源证据：Add OpenAI Codex plugin support
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Add OpenAI Codex plugin support
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_c087d3feeb494e9480713d6dc9e924f1 | https://github.com/coreyhaines31/marketingskills/issues/295 | 来源类型 github_issue 暴露的待验证使用条件。
## 3. 安装坑 · 来源证据：Create official marketing skills plugin for Claude Code plugin marketplace
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Create official marketing skills plugin for Claude Code plugin marketplace
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_0887d9c4d8fa414a803dedc9b5ed3b7f | https://github.com/coreyhaines31/marketingskills/issues/229 | 来源类型 github_issue 暴露的待验证使用条件。
## 4. 安装坑 · 来源证据：Feature Request: Add Prefix to skills
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：Feature Request: Add Prefix to skills
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源问题仍为 open，Pack Agent 需要复核是否仍影响当前版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_3e599cd97c324acd88021e15eff0d375 | https://github.com/coreyhaines31/marketingskills/issues/279 | 来源类型 github_issue 暴露的待验证使用条件。
## 5. 安装坑 · 来源证据：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand
- 对用户的影响：可能影响升级、迁移或版本选择。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_e6220468080c46c4801a7801b8cfbf84 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0 | 来源类型 github_release 暴露的待验证使用条件。
## 6. 安装坑 · 来源证据：v1.9.0 — image skill, video skill, plugin fix
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安装相关的待验证问题：v1.9.0 — image skill, video skill, plugin fix
- 对用户的影响：可能增加新用户试用和生产接入成本。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_b2e5d4f3b13b4cf9bf57f7d9883e6ca2 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0 | 来源类型 github_release 暴露的待验证使用条件。
## 7. 配置坑 · 可能修改宿主 AI 配置
- 严重度：medium
- 证据强度：source_linked
- 发现：项目面向 Claude/Cursor/Codex/Gemini/OpenCode 等宿主，或安装命令涉及用户配置目录。
- 对用户的影响：安装可能改变本机 AI 工具行为，用户需要知道写入位置和回滚方法。
- 建议检查：列出会写入的配置文件、目录和卸载/回滚步骤。
- 防护动作：涉及宿主配置目录时必须给回滚路径，不能只给安装命令。
- 证据：capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code
## 8. 能力坑 · 能力判断依赖假设
- 严重度：medium
- 证据强度：source_linked
- 发现：README/documentation is current enough for a first validation pass.
- 对用户的影响：假设不成立时，用户拿不到承诺的能力。
- 建议检查：将假设转成下游验证清单。
- 防护动作：假设必须转成验证项；没有验证结果前不能写成事实。
- 证据：capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.
## 9. 维护坑 · 维护活跃度未知
- 严重度：medium
- 证据强度：source_linked
- 发现：未记录 last_activity_observed。
- 对用户的影响：新项目、停更项目和活跃项目会被混在一起，推荐信任度下降。
- 建议检查：补 GitHub 最近 commit、release、issue/PR 响应信号。
- 防护动作：维护活跃度未知时，推荐强度不能标为高信任。
- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing
## 10. 安全/权限坑 · 下游验证发现风险项
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：下游已经要求复核，不能在页面中弱化。
- 建议检查：进入安全/权限治理复核队列。
- 防护动作：下游风险存在时必须保持 review/recommendation 降级。
- 证据：downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium
## 11. 安全/权限坑 · 存在安全注意事项
- 严重度：medium
- 证据强度：source_linked
- 发现：No sandbox install has been executed yet; downstream must verify before user use.
- 对用户的影响：用户安装前需要知道权限边界和敏感操作。
- 建议检查：转成明确权限清单和安全审查提示。
- 防护动作：安全注意事项必须面向用户前置展示。
- 证据：risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.
## 12. 安全/权限坑 · 存在评分风险
- 严重度：medium
- 证据强度：source_linked
- 发现：no_demo
- 对用户的影响：风险会影响是否适合普通用户安装。
- 建议检查：把风险写入边界卡，并确认是否需要人工复核。
- 防护动作：评分风险必须进入边界卡，不能只作为内部分数。
- 证据：risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium
## 13. 安全/权限坑 · 来源证据：v1.1.0 — Tools Registry, Progressive Disclosure & More
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.1.0 — Tools Registry, Progressive Disclosure & More
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_2ce61abbfe664a1c884129cf5e26a47a | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.1.0 | 来源类型 github_release 暴露的待验证使用条件。
## 14. 安全/权限坑 · 来源证据：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_c9b5f529d1ae4679b15fcf45a148e130 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.2.0 | 来源讨论提到 node 相关条件，需在安装/试用前复核。
## 15. 安全/权限坑 · 来源证据：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_a8f99c9b2e1a41a284683c9ad456d8e8 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.5.0 | 来源讨论提到 windows 相关条件，需在安装/试用前复核。
## 16. 安全/权限坑 · 来源证据：v1.7.0 — ASO audit skill, Zapier SDK
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.7.0 — ASO audit skill, Zapier SDK
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_21639af8f9f846c3920bd9368f4eb1ff | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.7.0 | 来源类型 github_release 暴露的待验证使用条件。
## 17. 安全/权限坑 · 来源证据：v1.8.0 — 2 new skills, security hardening, plugin fix
- 严重度：medium
- 证据强度：source_linked
- 发现：GitHub 社区证据显示该项目存在一个安全/权限相关的待验证问题：v1.8.0 — 2 new skills, security hardening, plugin fix
- 对用户的影响：可能影响授权、密钥配置或安全边界。
- 建议检查：来源显示可能已有修复、规避或版本变化，说明书中必须标注适用版本。
- 防护动作：不得脱离来源链接放大为确定性结论；需要标注适用版本和复核状态。
- 证据：community_evidence:github | cevd_3f54380df7c947deb428af9b2886a4a9 | https://github.com/coreyhaines31/marketingskills/releases/tag/v1.8.0 | 来源讨论提到 api key 相关条件，需在安装/试用前复核。
## 18. 维护坑 · issue/PR 响应质量未知
- 严重度：low
- 证据强度：source_linked
- 发现：issue_or_pr_quality=unknown。
- 对用户的影响：用户无法判断遇到问题后是否有人维护。
- 建议检查：抽样最近 issue/PR，判断是否长期无人处理。
- 防护动作：issue/PR 响应未知时，必须提示维护风险。
- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | issue_or_pr_quality=unknown
## 19. 维护坑 · 发布节奏不明确
- 严重度：low
- 证据强度：source_linked
- 发现：release_recency=unknown。
- 对用户的影响：安装命令和文档可能落后于代码，用户踩坑概率升高。
- 建议检查：确认最近 release/tag 和 README 安装命令是否一致。
- 防护动作：发布节奏未知或过期时，安装说明必须标注可能漂移。
- 证据：evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | release_recency=unknown