Related Pages

Related topics: Getting Started, Skills Architecture

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.

Sources: README.md:1-15

Repository Structure

The repository follows a modular architecture with three main components:

Sources: CLAUDE.md:1-20

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

Sources: README.md:45-52

Content & Copywriting

Sources: README.md:53-60

SEO & Discovery

Sources: README.md:61-68

Paid & Distribution

Sources: README.md:69-72

Measurement & Retention

Sources: README.md:73-80

Growth Engineering

Sources: 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

Sources: CONTRIBUTING.md:18-27

SKILL.md Format

Every skill requires a SKILL.md file with YAML frontmatter:

Related Pages

Related topics: Home, Skills Architecture

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.

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:

{
  "agent": {
    "skills": {
      "marketing-skills": {
        "command": "python",
        "args": ["-m", "agent", "skills", "install", "marketing-skills"]
      }
    }
  }
}

Sources: README.md:1-10

Method 2: MCP Plugin

For MCP-compatible agents, install via plugin command:

/plugin install marketing-skills

Sources: README.md:1-10

Method 3: Clone and Copy

Clone the repository and manually copy skills to your agent's skills directory:

git clone https://github.com/coreyhaines31/marketingskills.git
cp -r marketingskills/skills/* .agents/skills/

Sources: README.md:1-10

Method 4: Git Submodule

For projects requiring version control over dependencies:

git submodule add https://github.com/coreyhaines31/marketingskills.git .agents/marketingskills

Reference skills from .agents/marketingskills/skills/.

Sources: README.md:1-10

Method 5: SkillKit

For multi-agent environments (Claude Code, Cursor, Copilot):

# 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

Sources: README.md:1-10

Available Skills

Marketing Skills includes the following categories:

Sources: 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

Sources: CONTRIBUTING.md:1-30

SKILL.md Format

Every skill requires a SKILL.md file with YAML frontmatter:

Related Pages

Related topics: Home, Conversion Optimization Skills, Content and Copy Skills, SEO and Discovery Skills

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.

Sources: 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:

Sources: CONTRIBUTING.md:18-26

Skill Hierarchy

The skills are organized into a hierarchical taxonomy based on marketing function:

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"]

Sources: README.md:35-60

Skill Structure Specification

Directory Naming Conventions

All skill directories must follow strict naming rules:

Sources: CONTRIBUTING.md:28-32

SKILL.md File Format

Each skill requires a SKILL.md file with YAML frontmatter:

Related Pages

Related topics: Analytics and Testing Skills, Content and Copy Skills, Retention and Growth Skills

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:

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:

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:

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

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:

Related Pages

Related topics: Conversion Optimization Skills, SEO and Discovery Skills, Sales and RevOps Skills

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.

graph TD
    COPY["Copywriting<br/>Marketing Page Copy"] --> EDIT["Copy-Editing<br/>Polish & Refine"]
    COPY --> EMAIL["Automated Emails<br/>Email Flows"]
    COLD["Cold Email<br/>B2B Outreach"] --> EMAIL
    EMAIL --> SOCIAL["Social Media<br/>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:

Sources: 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

Sources: 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.

Sources: 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.

Sources: 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

Sources: 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:

graph LR
    A["Subject Line<br/>Personalized Hook"] --> B["Opening<br/>Immediate Value"]
    B --> C["Body<br/>Problem/Solution"]
    C --> D["CTA<br/>Clear Next Step"]
    D --> E["Signature<br/>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

Sources: 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

Sources: 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.

Sources: 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

Sources: 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

Sources: 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:

Sources: 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

Sources: 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.

graph TD
    DRAFT["Draft Copy<br/>Copywriting"] --> EDIT["Edit & Polish<br/>Copy-Editing"]
    EDIT --> DIST["Distribute Content"]
    
    DIST --> COLD["Cold Outreach<br/>Cold Email"]
    DIST --> AUTO["Automated Flows<br/>Emails"]
    DIST --> SOCIAL["Social Posts<br/>Social Media"]
    
    COLD --> TRACK["Track & Optimize"]
    AUTO --> TRACK
    SOCIAL --> TRACK
    
    TRACK --> INSIGHTS["Insights<br/>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

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.

Related Pages

Related topics: Content and Copy Skills, Paid Advertising Skills

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

Architecture

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.

graph TD
    HUB["SEO Guide<br/>(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.

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.

<nav aria-label="Breadcrumb">
  <ol itemscope itemtype="https://schema.org/BreadcrumbList">
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <a itemprop="item" href="/"><span itemprop="name">Home</span></a>
      <meta itemprop="position" content="1" />
    </li>
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <a itemprop="item" href="/features"><span itemprop="name">Features</span></a>
      <meta itemprop="position" content="2" />
    </li>
    <li itemprop="itemListElement" itemscope itemtype="https://schema.org/ListItem">
      <span itemprop="name">Analytics</span>
      <meta itemprop="position" content="3" />
    </li>
  </ol>
</nav>

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

Sources: skills/seo-audit/references/ai-writing-detection.md

Technical SEO Components

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.

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.

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.

**[Topic/Question]**: [Complete, self-contained answer that makes sense without additional context. Include specific details, numbers, or examples in 2-3 sentences.]

Example:

**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.

[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:

FAQ Block Pattern

Use for "How do I...", "What is...", and "Why..." queries that commonly appear in featured snippets.

**[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.

## [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

Schema Skill

The schema skill provides structured data implementation guidelines for enhancing search result appearance through rich snippets.

Article / BlogPosting Schema

{
  "@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

{
  "@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

{
  "@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:

##### Step 2: Scrape Key Pages

firecrawl_scrape → each key page URL

Save results to competitor-profiles/raw/<competitor-slug>/<YYYY-MM-DD>/scrapes/<page-name>.md before extracting fields.

Data Extraction Matrix

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:

Editorial Workflow

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:

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:

Search Analytics Query Example:

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

DataForSEO Tools

Domain-Level Intelligence:

Workflow Summary

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

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

Related Pages

Related topics: SEO and Discovery Skills, Analytics and Testing Skills, Content and Copy Skills

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. Sources: skills/ads/SKILL.md:1-10

Architecture

Skill Components

graph TD
    subgraph "Paid Advertising System"
        ADS[ads<br/>Campaign Strategy & Optimization]
        AD_CREATIVE[ad-creative<br/>Ad Copy Generation]
        PLATFORM_SPECS[platform-specs<br/>Platform Specifications]
        COPY_TEMPLATES[ad-copy-templates<br/>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

Sources: skills/ads/SKILL.md:180-195

Campaign Structure Best Practices

Account Organization Hierarchy

graph TD
    ACCOUNT[Account] --> CAMPAIGN1[Campaign 1<br/>Objective - Audience/Product]
    ACCOUNT --> CAMPAIGN2[Campaign 2<br/>Objective - Audience/Product]
    
    CAMPAIGN1 --> ADSET1[Ad Set 1<br/>Targeting Variation]
    CAMPAIGN1 --> ADSET2[Ad Set 2<br/>Targeting Variation]
    
    ADSET1 --> AD1[Ad 1<br/>Creative Variation A]
    ADSET1 --> AD2[Ad 2<br/>Creative Variation B]
    ADSET1 --> AD3[Ad 3<br/>Creative Variation C]
    
    ADSET2 --> AD4[Ad 4<br/>Creative Variation D]

Naming Conventions

Sources: skills/ads/SKILL.md:85-110

Budget Allocation Strategy

Sources: 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 →

Sources: 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.

Sources: 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 →

Sources: 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

Sources: skills/ads/references/ad-copy-templates.md:60-90

Platform Specifications

Google Ads - Responsive Search Ads

Sources: skills/ad-creative/references/platform-specs.md:1-25

Google Ads Headline Mix Recommendation (15 headlines)

Sources: skills/ad-creative/references/platform-specs.md:26-40

Platform Selection Guide

Sources: skills/ads/SKILL.md:50-75

Workflow: Pull Data, Analyze, Generate

graph LR
    A[Pull Recent<br/>Ad Performance] --> B[Analyze Output<br/>Identify Winners]
    B --> C[Feed Winning Patterns<br/>Into Skill]
    C --> D[Generate New<br/>Variations]
    D --> E[Upload to<br/>Platform]
    
    subgraph "CLI Commands"
        A --> A1[node tools/clis/google-ads.js<br/>reports get]
    end

Implementation

# 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

Sources: 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

Sources: skills/ad-creative/SKILL.md:95-130

Platform Integration Reference

LinkedIn Ads

#### Campaign Types

#### Key Metrics

#### 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

Sources: 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

Sources: skills/ad-creative/SKILL.md:1-20

Related Documentation

Related Pages

Related topics: Conversion Optimization Skills, Paid Advertising Skills

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

Architecture

Integration Architecture

The analytics and testing infrastructure follows a layered integration pattern where tools connect through standardized APIs and CLI interfaces.

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

Sources: tools/integrations/google-search-console.md Sources: 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

Sources: 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

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"]

Sources: 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

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)

Sources: 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

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"]

Sources: skills/ab-testing/SKILL.md

Sample Size Determination

Proper sample size calculation ensures statistical validity of test results.

Sources: skills/ab-testing/references/sample-size-guide.md

Test Templates

Standardized templates accelerate test implementation:

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]

Sources: skills/ab-testing/references/test-templates.md

Optimizely Integration

Optimizely provides enterprise experimentation capabilities including A/B testing, feature flags, and personalization.

API Capabilities

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:

# List projects
optimizely projects list

# List experiments
optimizely experiments list --project-id <id>

# List pages
optimizely pages list --project-id <id>

# List options with pagination
optimizely options --page <n> --per-page <n> --status <status>

Sources: tools/integrations/optimizely.md Sources: tools/clis/optimizely.js

Google Search Console Integration

Google Search Console provides organic search performance data essential for SEO analytics.

API Operations

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:

Rate Limits

• 200 queries per minute
• 1,200 requests per minute

Query Example

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

{
  "dimensionFilterGroups": [{
    "filters": [{
      "dimension": "query",
      "operator": "contains",
      "expression": "keyword"
    }]
  }]
}

Sources: tools/integrations/google-search-console.md

Hotjar Integration

Hotjar provides qualitative analytics through heatmaps, session recordings, and user surveys.

Data Types

#### Heatmap Data

#### Recording Data

API Parameters

Survey Responses:

Recordings:

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

Sources: tools/integrations/hotjar.md

SEO Analytics Tools

SEMrush Integration

SEMrush provides comprehensive SEO intelligence including keyword research, competitive analysis, and backlink monitoring.

#### Export Columns

#### 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

Sources: tools/integrations/semrush.md

Keywords Everywhere

Keywords Everywhere provides keyword data including search volume, CPC, and competition scores.

#### Key Metrics

#### Parameters

#### Rate Limits

• 100 keywords per request
• Credit-based pricing (1 credit per keyword)

Sources: tools/integrations/keywords-everywhere.md

Workflow Integration

Analytics Workflow

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

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

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

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

Related Pages

Related topics: Conversion Optimization Skills, Sales and RevOps Skills, Content and Copy Skills

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:

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

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

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]

Sources: 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:

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

Sources: 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:

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

Sources: 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:

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

Sources: 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

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

Sources: 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:

Sources: 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:

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:

Sources: skills/community-marketing/SKILL.md

Implementation Guidelines

Skill Selection Matrix

Integration Patterns

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:

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

Related Pages

Related topics: Retention and Growth Skills, Content and 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 Pitfall Log

Doramagic extracted 16 source-linked risk signals. Review them before installing or handing real data to the project.

1. Project risk: Project risk needs validation

• Severity: medium
• Finding: Project risk is backed by a source signal: Project risk needs validation. Treat it as a review item until the current version is checked.
• User impact: The project should not be treated as fully validated until this signal is reviewed.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: identity.distribution | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | repo=marketingskills; install=skills

2. Installation risk: Add OpenAI Codex plugin support

• Severity: medium
• Finding: Installation risk is backed by a source signal: Add OpenAI Codex plugin support. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/coreyhaines31/marketingskills/issues/295

3. Installation risk: Create official marketing skills plugin for Claude Code plugin marketplace

• Severity: medium
• Finding: Installation risk is backed by a source signal: Create official marketing skills plugin for Claude Code plugin marketplace. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/coreyhaines31/marketingskills/issues/229

4. Installation risk: Feature Request: Add Prefix to skills

• Severity: medium
• Finding: Installation risk is backed by a source signal: Feature Request: Add Prefix to skills. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/coreyhaines31/marketingskills/issues/279

5. Installation risk: v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand

• Severity: medium
• Finding: Installation risk is backed by a source signal: v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/coreyhaines31/marketingskills/releases/tag/v1.3.0

6. Installation risk: v1.9.0 — image skill, video skill, plugin fix

• Severity: medium
• Finding: Installation risk is backed by a source signal: v1.9.0 — image skill, video skill, plugin fix. Treat it as a review item until the current version is checked.
• User impact: First-time setup may fail or require extra isolation and rollback planning.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: Source-linked evidence: https://github.com/coreyhaines31/marketingskills/releases/tag/v1.9.0

7. Configuration risk: Configuration risk needs validation

• Severity: medium
• Finding: Configuration risk is backed by a source signal: Configuration risk needs validation. Treat it as a review item until the current version is checked.
• User impact: Users may get misleading failures or incomplete behavior unless configuration is checked carefully.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: capability.host_targets | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | host_targets=claude, claude_code

8. Capability assumption: README/documentation is current enough for a first validation pass.

• Severity: medium
• Finding: README/documentation is current enough for a first validation pass.
• User impact: The project should not be treated as fully validated until this signal is reviewed.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: capability.assumptions | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | README/documentation is current enough for a first validation pass.

9. Maintenance risk: Maintainer activity is unknown

• Severity: medium
• Finding: Maintenance risk is backed by a source signal: Maintainer activity is unknown. Treat it as a review item until the current version is checked.
• User impact: Users cannot judge support quality until recent activity, releases, and issue response are checked.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: evidence.maintainer_signals | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | last_activity_observed missing

10. Security or permission risk: no_demo

• Severity: medium
• Finding: no_demo
• User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: downstream_validation.risk_items | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium

11. Security or permission risk: No sandbox install has been executed yet; downstream must verify before user use.

• Severity: medium
• Finding: No sandbox install has been executed yet; downstream must verify before user use.
• User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: risks.safety_notes | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | No sandbox install has been executed yet; downstream must verify before user use.

12. Security or permission risk: no_demo

• Severity: medium
• Finding: no_demo
• User impact: The project may affect permissions, credentials, data exposure, or host boundaries.
• Recommended check: Open the linked source, confirm whether it still applies to the current version, and keep the first run isolated.
• Evidence: risks.scoring_risks | github_repo:1135212071 | https://github.com/coreyhaines31/marketingskills | no_demo; severity=medium

Community Discussion Evidence

Doramagic exposes project-level community discussion separately from official documentation. Review these links before using marketingskills with real data or production workflows.

• Add OpenAI Codex plugin support - github / github_issue
• Create official marketing skills plugin for Claude Code plugin marketpla - github / github_issue
• Feature Request: Add Prefix to skills - github / github_issue
• v1.9.0 — image skill, video skill, plugin fix - github / github_release
• v1.8.0 — 2 new skills, security hardening, plugin fix - github / github_release
• v1.7.0 — ASO audit skill, Zapier SDK - github / github_release
• v1.5.0 — Customer Research, Nitrosend, Resend CLI, Firehose, Introw - github / github_release
• v1.3.0 — Sales & RevOps, Site Architecture & Multi-Agent Rebrand - github / github_release
• v1.2.0 — AI SEO, Churn Prevention, Ad Creative & 51 CLI Tools - github / github_release
• v1.1.0 — Tools Registry, Progressive Disclosure & More - github / github_release
• Project risk needs validation - GitHub / issue