Files
claude-skills-reference/marketing-skill/copywriting/references/copy-frameworks.md
Alireza Rezvani 52321c86bc feat: Marketing Division expansion — 7 → 42 skills (#266)
* feat: Skill Authoring Standard + Marketing Expansion plans

SKILL-AUTHORING-STANDARD.md — the DNA of every skill in this repo:
10 universal patterns codified from C-Suite innovations + Corey Haines' marketingskills patterns:

1. Context-First: check domain context, ask only for gaps
2. Practitioner Voice: expert persona, goal-oriented, not textbook
3. Multi-Mode Workflows: build from scratch / optimize existing / situation-specific
4. Related Skills Navigation: when to use, when NOT to, bidirectional
5. Reference Separation: SKILL.md lean (≤10KB), refs deep
6. Proactive Triggers: surface issues without being asked
7. Output Artifacts: request → specific deliverable mapping
8. Quality Loop: self-verify, confidence tagging
9. Communication Standard: bottom line first, structured output
10. Python Tools: stdlib-only, CLI-first, JSON output, sample data

Marketing expansion plans for 40-skill marketing division build.

* feat: marketing foundation — context + ops router + authoring standard

marketing-context/: Foundation skill every marketing skill reads first
  - SKILL.md: 3 modes (auto-draft, guided interview, update)
  - templates/marketing-context-template.md: 14 sections covering
    product, audience, personas, pain points, competitive landscape,
    differentiation, objections, switching dynamics, customer language
    (verbatim), brand voice, style guide, proof points, SEO context, goals
  - scripts/context_validator.py: Scores completeness 0-100, section-by-section

marketing-ops/: Central router for 40-skill marketing ecosystem
  - Full routing matrix: 7 pods + cross-domain routing to 6 skills in
    business-growth, product-team, engineering-team, c-level-advisor
  - Campaign orchestration sequences (launch, content, CRO sprint)
  - Quality gate matching C-Suite standard
  - scripts/campaign_tracker.py: Campaign status tracking with progress,
    overdue detection, pod coverage, blocker identification

SKILL-AUTHORING-STANDARD.md: Universal DNA for all skills
  - 10 patterns: context-first, practitioner voice, multi-mode workflows,
    related skills navigation, reference separation, proactive triggers,
    output artifacts, quality loop, communication standard, python tools
  - Quality checklist for skill completion verification
  - Domain context file mapping for all 5 domains

* feat: import 20 workspace marketing skills + standard sections

Imported 20 marketing skills from OpenClaw workspace into repo:

Content Pod (5):
  content-strategy, copywriting, copy-editing, social-content, marketing-ideas

SEO Pod (2):
  seo-audit (+ references enriched by subagent), programmatic-seo (+ refs)

CRO Pod (5):
  page-cro, form-cro, signup-flow-cro, onboarding-cro, popup-cro, paywall-upgrade-cro

Channels Pod (2):
  email-sequence, paid-ads

Growth + Intel + GTM (5):
  ab-test-setup, competitor-alternatives, marketing-psychology, launch-strategy, brand-guidelines

All 29 skills now have standard sections per SKILL-AUTHORING-STANDARD.md:
   Proactive Triggers (4-5 per skill)
   Output Artifacts table
   Communication standard reference
   Related Skills with WHEN/NOT disambiguation

Subagents enriched 8 skills with additional reference docs:
  seo-audit, programmatic-seo, page-cro, form-cro,
  onboarding-cro, popup-cro, paywall-upgrade-cro, email-sequence

43 files, 10,566 lines added.

* feat: build 13 new marketing skills + social-media-manager upgrade

All skills are 100% original work — inspired by industry best practices,
written from scratch in our own voice following SKILL-AUTHORING-STANDARD.md.

NEW Content Pod (2):
  content-production — full research→draft→optimize pipeline, content_scorer.py
  content-humanizer — AI pattern detection + voice injection, humanizer_scorer.py

NEW SEO Pod (3):
  ai-seo — AI search optimization (AEO/GEO/LLMO), entirely new category
  schema-markup — JSON-LD structured data, schema_validator.py
  site-architecture — URL structure + internal linking, sitemap_analyzer.py

NEW Channels Pod (2):
  cold-email — B2B outreach (distinct from email-sequence lifecycle)
  ad-creative — bulk ad generation + platform specs, ad_copy_validator.py

NEW Growth Pod (3):
  churn-prevention — cancel flows + save offers + dunning, churn_impact_calculator.py
  referral-program — referral + affiliate programs
  free-tool-strategy — engineering as marketing

NEW Intelligence Pod (1):
  analytics-tracking — GA4/GTM setup + event taxonomy, tracking_plan_generator.py

NEW Sales Pod (1):
  pricing-strategy — pricing, packaging, monetization

UPGRADED:
  social-media-analyzer → social-media-manager (strategy, calendar, community)

Totals: 42 skills, 27 Python scripts, 60 reference docs, 163 files, 43,265 lines

* feat: update index, marketplace, README for 42 marketing skills

- skills-index.json: 89 → 124 skills (42 marketing entries)
- marketplace.json: marketing-skills v2.0.0 (42 skills, 27 tools)
- README.md: badge 134 → 169, marketing row updated
- prompt-engineer-toolkit: added YAML frontmatter
- Removed build logs from repo
- Parity check: 42/42 passed (YAML + Related + Proactive + Output + Communication)

* fix: merge content-creator into content-production, split marketing-psychology

Quality audit fixes:

1. content-creator → DEPRECATED redirect
   - Scripts (brand_voice_analyzer.py, seo_optimizer.py) moved to content-production
   - SKILL.md replaced with redirect to content-production + content-strategy
   - Eliminates duplicate routing confusion

2. marketing-psychology → 24KB split to 6.8KB + reference
   - 70+ mental models moved to references/mental-models-catalog.md (397 lines)
   - SKILL.md now lean: categories overview, most-used models, quick reference
   - Saves ~4,300 tokens per invocation

* feat: add plugin configs, Codex/OpenClaw compatibility, ClawHub packaging

- marketing-skill/SKILL.md: ClawHub-compatible root with Quick Start for Claude Code, Codex CLI, OpenClaw
- marketing-skill/CLAUDE.md: Agent instructions (routing, context, anti-patterns)
- marketing-skill/.codex/instructions.md: Codex CLI skill routing
- .claude-plugin/marketplace.json: deduplicated, marketing-skills v2.0.0
- .codex/skills-index.json: content-creator marked deprecated, psychology updated
- Total: 42 skills, 27 Python tools, 60 references, 18 plugins

* feat: add 16 Python tools to knowledge-only skills

Enriched 12 previously tool-less skills with practical Python scripts:
- seo-audit/seo_checker.py — HTML on-page SEO analysis (0-100)
- copywriting/headline_scorer.py — headline quality scoring (0-100)
- copy-editing/readability_scorer.py — Flesch + passive + filler detection
- content-strategy/topic_cluster_mapper.py — keyword clustering
- page-cro/conversion_audit.py — HTML CRO signal analysis (0-100)
- paid-ads/roas_calculator.py — ROAS/CPA/CPL calculator
- email-sequence/sequence_analyzer.py — email sequence scoring (0-100)
- form-cro/form_field_analyzer.py — form field CRO audit (0-100)
- onboarding-cro/activation_funnel_analyzer.py — funnel drop-off analysis
- programmatic-seo/url_pattern_generator.py — URL pattern planning
- ab-test-setup/sample_size_calculator.py — statistical sample sizing
- signup-flow-cro/funnel_drop_analyzer.py — signup funnel analysis
- launch-strategy/launch_readiness_scorer.py — launch checklist scoring
- competitor-alternatives/comparison_matrix_builder.py — feature comparison
- social-media-manager/social_calendar_generator.py — content calendar
- readability_scorer.py — fixed demo mode for non-TTY execution

All 43/43 scripts pass execution. All stdlib-only, zero pip installs.
Total: 42 skills, 43 Python tools, 60+ reference docs.

* feat: add 3 more Python tools + improve 6 existing scripts

New tools from build agent:
- email-sequence/scripts/sequence_analyzer.py — email sequence scoring (91/100 demo)
- paid-ads/scripts/roas_calculator.py — ROAS/CPA/CPL/break-even calculator
- competitor-alternatives/scripts/comparison_matrix_builder.py — feature matrix

Improved scripts (better demo modes, fuller analysis):
- seo_checker.py, headline_scorer.py, readability_scorer.py,
  conversion_audit.py, topic_cluster_mapper.py, launch_readiness_scorer.py

Total: 42 skills, 47 Python tools, all passing.

* fix: remove duplicate scripts from deprecated content-creator

Scripts already live in content-production/scripts/. The content-creator
directory is now a pure redirect (SKILL.md only + legacy assets/refs).

* fix: scope VirusTotal scan to executable files only

Skip scanning .md, .py, .json, .yml — they're plain text files
that VirusTotal can't meaningfully analyze. This prevents 429 rate
limit errors on PRs with many text file changes (like 42 marketing skills).

Scan still covers: .js, .ts, .sh, .mjs, .cjs, .exe, .dll, .so, .bin, .wasm

---------

Co-authored-by: Leo <leo@openclaw.ai>
2026-03-06 03:56:16 +01:00

7.3 KiB

Copy Frameworks Reference

Headline formulas, page section types, and structural templates.

Headline Formulas

Outcome-Focused

{Achieve desirable outcome} without {pain point}

Understand how users are really experiencing your site without drowning in numbers

{Achieve desirable outcome} by {how product makes it possible}

Generate more leads by seeing which companies visit your site

Turn {input} into {outcome}

Turn your hard-earned sales into repeat customers

[Achieve outcome] in [timeframe]

Get your tax refund in 10 days


Problem-Focused

Never {unpleasant event} again

Never miss a sales opportunity again

{Question highlighting the main pain point}

Hate returning stuff to Amazon?

Stop [pain]. Start [pleasure].

Stop chasing invoices. Start getting paid on time.


Audience-Focused

{Key feature/product type} for {target audience}

Advanced analytics for Shopify e-commerce

{Key feature/product type} for {target audience} to {what it's used for}

An online whiteboard for teams to ideate and brainstorm together

You don't have to {skills or resources} to {achieve desirable outcome}

With Ahrefs, you don't have to be an SEO pro to rank higher and get more traffic


Differentiation-Focused

The {opposite of usual process} way to {achieve desirable outcome}

The easiest way to turn your passion into income

The [category] that [key differentiator]

The CRM that updates itself


Proof-Focused

[Number] [people] use [product] to [outcome]

50,000 marketers use Drip to send better emails

{Key benefit of your product}

Sound clear in online meetings


Additional Formulas

The simple way to {outcome}

The simple way to track your time

Finally, {category} that {benefit}

Finally, accounting software that doesn't suck

{Outcome} without {common pain}

Build your website without writing code

Get {benefit} from your {thing}

Get more revenue from your existing traffic

{Action verb} your {thing} like {admirable example}

Market your SaaS like a Fortune 500

What if you could {desirable outcome}?

What if you could close deals 30% faster?

Everything you need to {outcome}

Everything you need to launch your course

The {adjective} {category} built for {audience}

The lightweight CRM built for startups


Landing Page Section Types

Core Sections

Hero (Above the Fold)

  • Headline + subheadline
  • Primary CTA
  • Supporting visual (product screenshot, hero image)
  • Optional: Social proof bar

Social Proof Bar

  • Customer logos (recognizable > many)
  • Key metric ("10,000+ teams")
  • Star rating with review count
  • Short testimonial snippet

Problem/Pain Section

  • Articulate their problem better than they can
  • Create recognition ("that's exactly my situation")
  • Hint at cost of not solving it

Solution/Benefits Section

  • Bridge from problem to your solution
  • 3-5 key benefits (not 10)
  • Each: headline + explanation + proof if available

How It Works

  • 3-4 numbered steps
  • Reduces perceived complexity
  • Each step: action + outcome

Final CTA Section

  • Recap value proposition
  • Repeat primary CTA
  • Risk reversal (guarantee, free trial)

Supporting Sections

Testimonials

  • Full quotes with names, roles, companies
  • Photos when possible
  • Specific results over vague praise
  • Formats: quote cards, video, tweet embeds

Case Studies

  • Problem → Solution → Results
  • Specific metrics and outcomes
  • Customer name and context
  • Can be snippets with "Read more" links

Use Cases

  • Different ways product is used
  • Helps visitors self-identify
  • "For marketers who need X" format

Personas / "Built For" Sections

  • Explicitly call out target audience
  • "Perfect for [role]" blocks
  • Addresses "Is this for me?" question

FAQ Section

  • Address common objections
  • Good for SEO
  • Reduces support burden
  • 5-10 most common questions

Comparison Section

  • vs. competitors (name them or don't)
  • vs. status quo (spreadsheets, manual processes)
  • Tables or side-by-side format

Integrations / Partners

  • Logos of tools you connect with
  • "Works with your stack" messaging
  • Builds credibility

Founder Story / Manifesto

  • Why you built this
  • What you believe
  • Emotional connection
  • Differentiates from faceless competitors

Demo / Product Tour

  • Interactive demos
  • Video walkthroughs
  • GIF previews
  • Shows product in action

Pricing Preview

  • Teaser even on non-pricing pages
  • Starting price or "from $X/mo"
  • Moves decision-makers forward

Guarantee / Risk Reversal

  • Money-back guarantee
  • Free trial terms
  • "Cancel anytime"
  • Reduces friction

Stats Section

  • Key metrics that build credibility
  • "10,000+ customers"
  • "4.9/5 rating"
  • "$2M saved for customers"

Page Structure Templates

Feature-Heavy Page (Weak)

1. Hero
2. Feature 1
3. Feature 2
4. Feature 3
5. Feature 4
6. CTA

This is a list, not a persuasive narrative.


Varied, Engaging Page (Strong)

1. Hero with clear value prop
2. Social proof bar (logos or stats)
3. Problem/pain section
4. How it works (3 steps)
5. Key benefits (2-3, not 10)
6. Testimonial
7. Use cases or personas
8. Comparison to alternatives
9. Case study snippet
10. FAQ
11. Final CTA with guarantee

This tells a story and addresses objections.


Compact Landing Page

1. Hero (headline, subhead, CTA, image)
2. Social proof bar
3. 3 key benefits with icons
4. Testimonial
5. How it works (3 steps)
6. Final CTA with guarantee

Good for ad landing pages where brevity matters.


Enterprise/B2B Landing Page

1. Hero (outcome-focused headline)
2. Logo bar (recognizable companies)
3. Problem section (business pain)
4. Solution overview
5. Use cases by role/department
6. Security/compliance section
7. Integration logos
8. Case study with metrics
9. ROI/value section
10. Contact/demo CTA

Addresses enterprise buyer concerns.


Product Launch Page

1. Hero with launch announcement
2. Video demo or walkthrough
3. Feature highlights (3-5)
4. Before/after comparison
5. Early testimonials
6. Launch pricing or early access offer
7. CTA with urgency

Good for ProductHunt, launches, or announcements.


Section Writing Tips

Problem Section

Start with phrases like:

  • "You know the feeling..."
  • "If you're like most [role]..."
  • "Every day, [audience] struggles with..."
  • "We've all been there..."

Then describe:

  • The specific frustration
  • The time/money wasted
  • The impact on their work/life

Benefits Section

For each benefit, include:

  • Headline: The outcome they get
  • Body: How it works (1-2 sentences)
  • Proof: Number, testimonial, or example (optional)

How It Works Section

Each step should be:

  • Numbered: Creates sense of progress
  • Simple verb: "Connect," "Set up," "Get"
  • Outcome-oriented: What they get from this step

Example:

  1. Connect your tools (takes 2 minutes)
  2. Set your preferences
  3. Get automated reports every Monday

Testimonial Selection

Best testimonials include:

  • Specific results ("increased conversions by 32%")
  • Before/after context ("We used to spend hours...")
  • Role + company for credibility
  • Something quotable and specific

Avoid testimonials that just say:

  • "Great product!"
  • "Love it!"
  • "Easy to use!"