* 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>
254 lines
9.8 KiB
Markdown
254 lines
9.8 KiB
Markdown
# Creative Frameworks — Headline and Copy Formulas by Platform and Funnel Stage
|
||
|
||
A working catalog of the copy frameworks that consistently outperform generic ads. Use these as starting points, not templates to fill in blindly.
|
||
|
||
---
|
||
|
||
## The Golden Rule
|
||
|
||
Every ad has one job: get the right person to stop, read, and take one action. If the copy is trying to do three things, it does none of them well. One message, one CTA, one next step.
|
||
|
||
---
|
||
|
||
## Framework Index
|
||
|
||
1. PAS — Problem, Agitate, Solution
|
||
2. BAB — Before, After, Bridge
|
||
3. FAB — Feature, Advantage, Benefit
|
||
4. AIDA — Attention, Interest, Desire, Action
|
||
5. Social Proof Frame
|
||
6. Contrarian Frame
|
||
7. Specificity Frame
|
||
8. How-It-Works Frame
|
||
|
||
---
|
||
|
||
## 1. PAS — Problem, Agitate, Solution
|
||
|
||
**Best for:** Awareness and consideration stage. Cold audiences who don't know your solution.
|
||
|
||
**Structure:**
|
||
- Problem: Name the pain in their words
|
||
- Agitate: Make them feel how bad it is (don't make it worse than reality — they'll know)
|
||
- Solution: Position your product as the obvious fix
|
||
|
||
**Example (SaaS — project management):**
|
||
```
|
||
Primary text: "Your team is shipping, but nobody knows who owns what. Deadlines are "this week"
|
||
not "Tuesday at 3pm." By the time the stand-up is over, everyone has a different version of
|
||
the plan. [Product] replaces the chaos with a single source of truth. Try it free for 14 days."
|
||
|
||
Headline: "Stop running projects in Slack threads"
|
||
```
|
||
|
||
**Length guidance:** PAS works long and short. Short for cold feed, long for warm retargeting.
|
||
|
||
---
|
||
|
||
## 2. BAB — Before, After, Bridge
|
||
|
||
**Best for:** Consideration and decision stage. Audiences who know the problem and are evaluating.
|
||
|
||
**Structure:**
|
||
- Before: Where they are now (the frustrating state)
|
||
- After: Where they want to be (the goal)
|
||
- Bridge: How your product gets them from here to there
|
||
|
||
**Example (B2B analytics tool):**
|
||
```
|
||
Headline: "From data chaos to clear answers"
|
||
Body: "Before [Product]: 6 spreadsheets, 4 dashboards, nobody agrees on the numbers.
|
||
After [Product]: One source of truth, automated weekly reports, decisions in minutes.
|
||
The bridge: connect your data sources once, and [Product] does the rest."
|
||
```
|
||
|
||
**Note:** BAB works especially well for case studies and social proof ads where you can show a real before/after with numbers.
|
||
|
||
---
|
||
|
||
## 3. FAB — Feature, Advantage, Benefit
|
||
|
||
**Best for:** Decision stage, retargeting, people who have visited your product page.
|
||
|
||
**Structure:**
|
||
- Feature: What it does (the thing you built)
|
||
- Advantage: How it works better than the alternative
|
||
- Benefit: What the customer actually gets in their life/work
|
||
|
||
**Common mistake:** Stopping at the feature. "Two-factor authentication" is a feature. "Bank-level security" is an advantage. "Sleep at night knowing your customer data is protected" is the benefit.
|
||
|
||
**Example (HR software):**
|
||
```
|
||
Feature: "Automated payroll that syncs with your accounting software"
|
||
Advantage: "No more manual data entry between systems"
|
||
Benefit: "Close the books on time, every time — without staying late"
|
||
|
||
Ad copy: "Payroll that closes itself. Automated payroll synced directly to QuickBooks —
|
||
no double entry, no reconciliation hell. Every month. On time. [Product] —
|
||
start your free trial."
|
||
```
|
||
|
||
---
|
||
|
||
## 4. AIDA — Attention, Interest, Desire, Action
|
||
|
||
**Best for:** Video ads, longer copy (LinkedIn, email), awareness campaigns.
|
||
|
||
**Structure:**
|
||
- Attention: Hook (first 3 seconds / first sentence)
|
||
- Interest: Why this matters to them specifically
|
||
- Desire: Make them want the outcome
|
||
- Action: One clear CTA
|
||
|
||
**Example (video script outline for SaaS):**
|
||
```
|
||
[0–3s] ATTENTION: "[Hook visual/statement]" — "Most companies spend 8 hours a week
|
||
on reports nobody reads."
|
||
[3–10s] INTEREST: "If you're a head of marketing, that's 32 hours of your team's time
|
||
each month — time they could spend on campaigns that actually drive revenue."
|
||
[10–20s] DESIRE: "[Product] automates the reporting. Your team gets that time back.
|
||
Your manager gets the data they asked for, without the nagging."
|
||
[20–25s] ACTION: "Start your 14-day free trial. No credit card."
|
||
```
|
||
|
||
---
|
||
|
||
## 5. Social Proof Frame
|
||
|
||
**Best for:** Decision stage. Works especially well for retargeting.
|
||
|
||
**Formulas:**
|
||
|
||
**Customer voice:**
|
||
```
|
||
"[Customer quote that speaks to the exact result — specific numbers preferred]"
|
||
— [Name, Title, Company]
|
||
[Product name] — [CTA]
|
||
```
|
||
|
||
**Results-led:**
|
||
```
|
||
Headline: "[Company] saved [X] hours per week with [Product]"
|
||
Body: "Before [Product], [Company] was manually tracking [problem]. Today,
|
||
they [specific result] — in [timeframe]. Here's how they did it."
|
||
```
|
||
|
||
**Volume proof:**
|
||
```
|
||
Headline: "[Number] teams trust [Product] to [outcome]"
|
||
Body: "From 5-person startups to Fortune 500 companies. Start your free trial."
|
||
```
|
||
|
||
**Note:** Specificity makes social proof work. "Many customers love it" → weak. "4,200 teams use [Product] to eliminate weekly reports" → strong.
|
||
|
||
---
|
||
|
||
## 6. Contrarian Frame
|
||
|
||
**Best for:** Awareness stage on saturated topics. Breaks through category fatigue.
|
||
|
||
**Structure:** Challenge the conventional wisdom in your category. Then reframe with your perspective.
|
||
|
||
**Example (email marketing tool):**
|
||
```
|
||
Headline: "More emails isn't the answer"
|
||
Body: "Everyone says send more emails. Better segmentation. More automation. More sequences.
|
||
But if your email is boring, more of it just means more unsubscribes.
|
||
[Product] helps you write emails people actually want to open — then send them
|
||
to the people most likely to act. Less volume. More revenue."
|
||
```
|
||
|
||
**Warning:** The contrarian frame needs substance behind it. If your product is "like everyone else but better," don't use this frame. Use it when you genuinely have a different approach.
|
||
|
||
---
|
||
|
||
## 7. Specificity Frame
|
||
|
||
**Best for:** All stages. Works everywhere. The most underused framework.
|
||
|
||
**Principle:** Specific claims outperform vague claims on every metric. Not "save time" — "save 3 hours per week." Not "grow your business" — "increase trial-to-paid conversion by 22%."
|
||
|
||
**Upgrade examples:**
|
||
| Vague | Specific |
|
||
|-------|---------|
|
||
| "Save time on reporting" | "Cut reporting time from 8 hours to 45 minutes" |
|
||
| "Trusted by leading companies" | "Used by 3,200+ growth teams in 60 countries" |
|
||
| "Improve your team's performance" | "Teams using [Product] ship 40% more features per quarter" |
|
||
| "Get better results" | "Average customer sees 28% higher conversion within 90 days" |
|
||
| "Easy to use" | "Set up in 15 minutes — no engineering required" |
|
||
|
||
If you don't have specific numbers: get them. Talk to 5 customers, ask for their before/after. One real number beats 10 marketing adjectives.
|
||
|
||
---
|
||
|
||
## 8. How-It-Works Frame
|
||
|
||
**Best for:** Consideration stage. Audiences who are curious but not yet convinced.
|
||
|
||
**Structure:** Show the mechanism — how your product produces the result. Remove mystery, reduce skepticism.
|
||
|
||
**Example (automation tool):**
|
||
```
|
||
Headline: "How [Product] works in 3 steps"
|
||
Body:
|
||
"1. Connect your tools (10 minutes, no coding)
|
||
2. Set your conditions ("when a lead scores over 80, do this")
|
||
3. Watch it run — 24/7, without your team touching it"
|
||
|
||
The result? Leads followed up in minutes, not days. Teams that spend time on deals,
|
||
not on data entry.
|
||
[CTA: See it in action — free demo]
|
||
```
|
||
|
||
---
|
||
|
||
## Platform-Specific Framework Match
|
||
|
||
| Platform | Best Frameworks | Why |
|
||
|----------|---------------|-----|
|
||
| Google RSA | Specificity, Benefit-first | Intent-driven — they searched for it |
|
||
| Meta Feed (cold) | PAS, Contrarian | Interrupt and engage fast |
|
||
| Meta Feed (retargeting) | BAB, Social Proof | They know you — sell the outcome |
|
||
| LinkedIn | AIDA, FAB, How-It-Works | Longer attention span, B2B mindset |
|
||
| TikTok | PAS (compressed), Hook-first | 3-second hook is everything |
|
||
| Twitter | Contrarian, Specificity | Opinionated content performs |
|
||
|
||
---
|
||
|
||
## Funnel Stage → Framework Selector
|
||
|
||
| Stage | Goal | Top Frameworks |
|
||
|-------|------|---------------|
|
||
| **Awareness** | Interrupt → Relevant → Curious | PAS, Contrarian, Specificity |
|
||
| **Consideration** | Educate → Differentiate → Trust | AIDA, FAB, How-It-Works, BAB |
|
||
| **Decision** | Prove → Remove risk → Action | Social Proof, BAB, Specificity + guarantee |
|
||
| **Retention/Upsell** | Remind value → Expand → Deepen | BAB, Feature highlight, milestone-based |
|
||
|
||
---
|
||
|
||
## Headline Formula Quick Reference
|
||
|
||
| Formula | Structure | Example |
|
||
|---------|-----------|---------|
|
||
| Benefit-First | [Verb] [outcome] [qualifier] | "Ship twice as fast without breaking prod" |
|
||
| Problem-Led | [Pain point they recognize] | "Still manually exporting to CSV every Monday?" |
|
||
| Number-Led | [Number] [thing] [result] | "14 days. Zero code. Full automation." |
|
||
| Curiosity | [Counterintuitive or unexpected] | "The feature nobody builds that triples retention" |
|
||
| How-To | "How [persona] [achieves outcome]" | "How growth teams cut CAC by 35% in one quarter" |
|
||
| Social Proof | "[Number] [people/teams] [do/use/trust]" | "31,000 marketers use this to skip the daily stand-up" |
|
||
| Objection-Lead | [Address the #1 reason they don't buy] | "No, you don't need an engineer to set this up" |
|
||
| Direct Comparison | "[Vs. their current approach]" | "Cheaper than Salesforce. More powerful than your spreadsheet." |
|
||
|
||
---
|
||
|
||
## Anti-Patterns to Avoid
|
||
|
||
| Anti-Pattern | Why It Fails | Fix |
|
||
|-------------|-------------|-----|
|
||
| "We are the #1 platform for..." | Unsubstantiated, overused, ignored | Lead with proof, not ranking |
|
||
| "Solutions for modern teams" | Meaningless — who isn't a modern team? | Name the specific team + specific problem |
|
||
| "Powerful yet easy to use" | Every product says this | Show the result — don't describe the product |
|
||
| "Unlock your potential" | Zero specificity, total fluff | What potential, specifically? Show it. |
|
||
| "Join thousands of happy customers" | Vague and dated | "3,400 companies use [Product] to [specific outcome]" |
|
||
| Emoji abuse | Looks desperate on LinkedIn, clutters Google | One emoji max, only if it adds meaning |
|