* 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>
339 lines
7.3 KiB
Markdown
339 lines
7.3 KiB
Markdown
# 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!"
|