@botlearn/copywriter 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 BotLearn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @botlearn/copywriter
+
+> Marketing copywriting specialist that applies proven persuasion frameworks (AIDA, PAS, BAB) for audience-targeted copy with optimized CTAs and click-through rate improvement
+
+## Installation
+
+```bash
+# via npm
+npm install @botlearn/copywriter
+
+# via clawhub
+clawhub install @botlearn/copywriter
+```
+
+## Category
+
+Creative Generation
+
+## Dependencies
+
+`@botlearn/sentiment-analyzer`
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `manifest.json` | Skill metadata and configuration |
+| `skill.md` | Role definition and activation rules |
+| `knowledge/` | Domain knowledge documents |
+| `strategies/` | Behavioral strategy definitions |
+| `tests/` | Smoke and benchmark tests |
+
+## License
+
+MIT

package/knowledge/anti-patterns.md

@@ -0,0 +1,105 @@
+---
+domain: copywriter
+topic: anti-patterns
+priority: medium
+ttl: 30d
+---
+
+# Marketing Copywriting — Anti-Patterns
+
+## Content & Messaging Anti-Patterns
+
+### 1. Feature-Dumping
+- **Problem**: Listing features without connecting them to reader benefits; treating copy like a spec sheet
+- **Symptom**: "Our platform has SSO, RBAC, 256-bit encryption, API access, and 99.99% uptime"
+- **Why it fails**: Readers don't buy features — they buy outcomes. Feature lists don't answer "Why should I care?"
+- **Fix**: Transform every feature into a benefit using the formula: **[Feature] so you can [Benefit]**
+  - "Enterprise-grade encryption so your customer data stays protected — and your compliance team stays happy"
+
+### 2. Weak or Missing CTAs
+- **Problem**: Copy ends without a clear, compelling call-to-action, or uses generic CTA text
+- **Symptom**: "Contact us to learn more", "Submit", "Click here"
+- **Why it fails**: Vague CTAs create friction; the reader doesn't know what happens next or what they'll get
+- **Fix**: Use action + benefit CTAs: "Start Your Free Trial", "Get My Custom Report", "See Pricing Plans"
+  - Every CTA should answer: What do I do? What do I get? What's the risk?
+
+### 3. Ignoring the Target Audience
+- **Problem**: Writing copy for "everyone" instead of a specific audience segment
+- **Symptom**: Generic language like "businesses of all sizes", "anyone who wants to...", no specific pain points named
+- **Why it fails**: Copy that speaks to everyone persuades no one. Specificity builds trust and relevance
+- **Fix**: Define one audience persona per piece of copy. Name their role, pain, and desired outcome explicitly
+  - "For SaaS product managers drowning in feature requests..." not "For professionals..."
+
+### 4. Corporate Jargon Overload
+- **Problem**: Using buzzwords, acronyms, and corporate-speak that obscures the actual message
+- **Symptom**: "We leverage synergistic, best-in-class solutions to empower your digital transformation journey"
+- **Why it fails**: Jargon signals inauthenticity and creates cognitive load. If readers have to decode your message, they'll leave
+- **Fix**: Write at an 8th-grade reading level. If you can't explain the value in simple terms, you don't understand the product well enough
+  - "We help your team ship features 2x faster" not "We accelerate your velocity with an integrated solution"
+
+### 5. No Social Proof
+- **Problem**: Making claims without evidence — expecting readers to take your word for it
+- **Symptom**: "The best solution on the market", "Trusted by thousands", "Industry-leading" — with no data, names, or testimonials
+- **Why it fails**: Unsupported claims trigger skepticism. Every claim needs proof proportional to its boldness
+- **Fix**: Back every major claim with at least one proof element: testimonial, data point, case study, or logo wall
+  - "The best" → "Rated #1 on G2 by 1,200+ reviewers in 2025"
+
+## Structural Anti-Patterns
+
+### 6. Burying the Lead
+- **Problem**: Placing the most compelling benefit or hook deep in the copy instead of up front
+- **Symptom**: Long preambles, company history, or context-setting before the reader encounters the value proposition
+- **Why it fails**: You have 3-5 seconds to capture attention. If the strongest message is in paragraph 4, most readers will never see it
+- **Fix**: Put the single most compelling benefit or transformation in the headline and first sentence. Front-load value
+
+### 7. Wall of Text
+- **Problem**: Dense, unformatted paragraphs with no visual hierarchy or scan path
+- **Symptom**: 200+ word paragraphs, no subheadings, no bullet points, no bold text
+- **Why it fails**: 79% of web readers scan, not read. Without visual structure, they bounce
+- **Fix**: Short paragraphs (1-3 sentences), subheadings every 100-200 words, bullet points for lists, bold for key phrases
+
+### 8. Multiple Competing CTAs
+- **Problem**: Presenting several different actions with equal visual weight, confusing the reader
+- **Symptom**: "Sign up", "Book a demo", "Download the guide", "Watch the video" — all in the same section
+- **Why it fails**: Choice paralysis reduces conversion. Each additional CTA option can decrease clicks by 10-20%
+- **Fix**: One primary CTA per section. If secondary actions exist, make them visually subordinate (text link vs. button)
+
+## Persuasion Anti-Patterns
+
+### 9. False Urgency and Deceptive Scarcity
+- **Problem**: Fabricating countdown timers, fake limited availability, or artificial deadlines
+- **Symptom**: "Only 2 left!" (perpetually), fake countdown timers that reset on refresh, "Offer ends today!" (every day)
+- **Why it fails**: Savvy consumers recognize fake urgency — it destroys trust and brand credibility permanently
+- **Fix**: Use only legitimate urgency (real deadlines, actual limited availability, genuine price increases). Explain why the deadline exists
+
+### 10. Selling Before Building Trust
+- **Problem**: Pushing for the sale immediately without establishing credibility or addressing objections
+- **Symptom**: Hard-sell CTA in the first paragraph with no supporting evidence, testimonials, or value demonstration
+- **Why it fails**: People buy from brands they trust. Premature selling creates resistance, not desire
+- **Fix**: Follow the trust sequence: Identify pain → Demonstrate understanding → Show proof → Present solution → Ask for action
+
+### 11. Ignoring Objections
+- **Problem**: Failing to anticipate and address the reader's reasons not to buy
+- **Symptom**: No FAQ section, no guarantee mention, no risk-reversal, no comparison to alternatives
+- **Why it fails**: Unaddressed objections don't disappear — they become reasons to leave
+- **Fix**: Identify the top 3-5 objections (price, trust, effort, timing, risk) and address each explicitly before the final CTA
+
+### 12. Emotional Manipulation Without Substance
+- **Problem**: Relying entirely on fear, guilt, or shame without providing genuine value or a real solution
+- **Symptom**: "If you don't buy this, you'll fail" with no proof, no case studies, no substance behind the claim
+- **Why it fails**: Emotional triggers get attention, but conversions require substance. Manipulation without value leads to refunds and brand damage
+- **Fix**: Pair emotional hooks with rational proof. Every emotional claim should be backed by evidence or a credible mechanism
+
+## Channel-Specific Anti-Patterns
+
+### 13. Ignoring Platform Constraints
+- **Problem**: Writing copy that violates platform norms — too long for ads, too short for landing pages, wrong tone for the channel
+- **Symptom**: 500-word Facebook ad text, 10-word landing page, formal tone on Twitter, casual tone in enterprise email
+- **Why it fails**: Each platform has established user expectations. Violating them causes friction and poor performance
+- **Fix**: Always check platform specs before writing (character limits, format requirements, audience expectations). Refer to knowledge/domain.md for platform norms
+
+### 14. Copy-Paste Across Channels
+- **Problem**: Using identical copy for landing pages, emails, social ads, and Google Ads without adaptation
+- **Symptom**: Same headline, same body, same CTA across every channel with no format or length adjustment
+- **Why it fails**: Each channel has different attention spans, formats, and user intents. One-size-fits-all copy underperforms everywhere
+- **Fix**: Adapt the core message to each channel's constraints and audience behavior. Same value proposition, different execution

package/knowledge/best-practices.md

@@ -0,0 +1,126 @@
+---
+domain: copywriter
+topic: audience-first-writing-and-conversion-optimization
+priority: high
+ttl: 30d
+---
+
+# Marketing Copywriting — Best Practices
+
+## Audience-First Writing
+
+### 1. Build the Audience Persona Before Writing a Single Word
+Before drafting copy, answer these questions about the target reader:
+- **Demographics**: Age, role, industry, company size, income level
+- **Psychographics**: Values, beliefs, aspirations, fears, frustrations
+- **Buying stage**: Unaware → Problem-aware → Solution-aware → Product-aware → Most-aware
+- **Language**: What words does this audience use to describe their problem? (Use their vocabulary, not yours)
+- **Channel behavior**: Where do they spend time? What content do they engage with?
+
+### 2. Write to One Person, Not a Crowd
+- Use "you" and "your" — speak directly to the individual reader
+- Reference their specific situation: "As a SaaS founder scaling past $1M ARR..." not "For businesses..."
+- Mirror their internal dialogue: address what they're already thinking and feeling
+- Avoid corporate jargon unless the audience expects it (enterprise B2B may require it)
+
+### 3. Lead with Benefits, Support with Features
+- **Benefit**: The outcome the reader gets ("Save 10 hours a week on reporting")
+- **Feature**: The mechanism that delivers the benefit ("Automated report generation with 50+ templates")
+- Formula: **[Benefit]** because **[Feature]**
+  - "Close deals 2x faster because our AI scores and prioritizes your leads in real time"
+- Stack benefits in order of importance to the audience, not the product team
+
+### 4. Match Tone to Audience Expectations
+
+| Audience | Tone | Example Phrase |
+|----------|------|---------------|
+| Enterprise B2B | Professional, authoritative, data-driven | "Reduce operational overhead by 34%" |
+| Startup/SMB | Conversational, bold, results-oriented | "Stop burning cash on tools that don't work" |
+| Consumer (Gen Z) | Casual, authentic, punchy | "Your skincare routine is lying to you" |
+| Consumer (40+) | Warm, trustworthy, clear | "Finally, a retirement plan that makes sense" |
+| Developer | Technical, no-fluff, direct | "One API call. Zero config. Ship in minutes." |
+
+## A/B Testing Mindset
+
+### 5. Always Generate Multiple Variants
+Every piece of copy should have at least 2-3 variants with different angles:
+- **Variant A — Emotional**: Lead with feeling, transformation, aspiration
+- **Variant B — Rational**: Lead with data, comparison, ROI
+- **Variant C — Social proof**: Lead with testimonials, case studies, numbers
+- **Variant D — Urgency**: Lead with scarcity, deadlines, cost of inaction
+
+### 6. Test Systematically, One Variable at a Time
+- **Headlines**: Test headline alone before body copy (biggest impact on CTR)
+- **CTAs**: Test wording, color, placement separately
+- **Framework**: Test PAS vs. AIDA for the same offer to the same audience
+- **Length**: Test short-form vs. long-form for the same product and channel
+- Run each test for statistical significance (minimum 100-200 conversions per variant)
+
+### 7. Measure What Matters
+
+| Metric | What It Tells You | Optimize By |
+|--------|-------------------|-------------|
+| Click-Through Rate (CTR) | Headline and CTA effectiveness | Stronger hooks, clearer value prop |
+| Conversion Rate | Full copy persuasiveness | Better objection handling, social proof |
+| Bounce Rate | Message-to-audience fit | Audience targeting, above-fold messaging |
+| Time on Page | Content engagement | Readability, storytelling, formatting |
+| Cost per Acquisition (CPA) | Copy efficiency at scale | Framework selection, variant optimization |
+
+## Emotional Triggers
+
+### 8. Leverage the Six Core Emotional Drivers
+
+| Trigger | Description | Application |
+|---------|-------------|-------------|
+| **Fear of Missing Out (FOMO)** | People fear losing more than they desire gaining | "Only 12 spots left for the early-bird price" |
+| **Belonging** | People want to be part of a successful group | "Join 10,000+ marketers who..." |
+| **Authority** | People trust experts and proven systems | "Recommended by Harvard Business Review" |
+| **Reciprocity** | People feel obligated when given value first | "Download our free 50-page playbook" |
+| **Social Proof** | People follow what others are doing | "Rated 4.9/5 by 3,200+ customers" |
+| **Curiosity Gap** | People need to close open information loops | "The #1 mistake 90% of founders make with their pricing" |
+
+### 9. Use Sensory and Specific Language
+- **Vague**: "Improve your marketing results"
+- **Specific**: "Generate 47% more qualified leads in your first 30 days"
+- **Abstract**: "A better experience for your customers"
+- **Sensory**: "Watch your inbox fill with glowing 5-star reviews every morning"
+- Numbers, timeframes, and tangible outcomes always outperform generic claims
+
+### 10. Ethically Manage Urgency and Scarcity
+- **Legitimate scarcity**: Limited seats, limited-time pricing, seasonal offers — always truthful
+- **Legitimate urgency**: Real deadlines, rising prices, competitive timing
+- Never fabricate countdown timers, fake stock levels, or false deadlines
+- Frame urgency positively: "Lock in this price before Friday" rather than "You'll miss out forever"
+
+## Copy Structure & Readability
+
+### 11. Format for Scanners
+- 80% of readers scan before deciding to read — structure for scanners
+- **Short paragraphs**: 1-3 sentences maximum
+- **Subheadings**: Break content every 100-200 words with benefit-driven subheadings
+- **Bullet points**: For feature lists, benefits, and quick-scan information
+- **Bold key phrases**: Highlight the most important takeaways
+- **White space**: Let the copy breathe — dense blocks of text kill conversion
+
+### 12. Follow the "One Reader, One Offer, One CTA" Rule
+- Each piece of copy should speak to **one** clearly defined reader
+- Present **one** primary offer (supporting details are fine, but one core proposition)
+- Drive toward **one** primary CTA (secondary CTAs are acceptable but visually subordinate)
+- Multiple competing CTAs reduce conversion by 20-40%
+
+## Conversion Copywriting Principles
+
+### 13. Address Objections Proactively
+- Identify the top 3-5 objections the reader is likely to have
+- Address each one directly in the copy before the CTA
+- Common objection categories: Price ("Is it worth it?"), Trust ("Will it work?"), Effort ("Is it hard to set up?"), Timing ("Do I need this now?"), Risk ("What if it doesn't work?")
+- Use FAQ sections, guarantee statements, and comparison tables as objection handlers
+
+### 14. Build a Proof Stack
+Layer multiple types of proof to build cumulative credibility:
+1. **Quantitative data**: "Increased conversions by 127% in 90 days"
+2. **Named testimonials**: Real names, companies, and photos (with permission)
+3. **Case studies**: Before/after narratives with specific metrics
+4. **Authority signals**: Logos of well-known customers, media mentions, certifications
+5. **Social volume**: "Used by 50,000+ teams worldwide"
+- The more skeptical the audience, the more proof layers required

package/knowledge/domain.md

@@ -0,0 +1,170 @@
+---
+domain: copywriter
+topic: persuasion-frameworks-and-copy-patterns
+priority: high
+ttl: 30d
+---
+
+# Marketing Copywriting — Persuasion Frameworks, CTA Patterns & Headline Formulas
+
+## Core Persuasion Frameworks
+
+### AIDA (Attention → Interest → Desire → Action)
+
+The classic funnel-based framework for guiding readers from awareness to conversion.
+
+- **Attention**: Hook the reader with a bold headline, surprising statistic, or provocative question
+  - Example: "97% of Landing Pages Fail. Here's What the Top 3% Do Differently."
+- **Interest**: Build engagement by connecting to the reader's situation with relevant details, stories, or data
+  - Example: "You spend hours crafting the perfect page, but visitors bounce in 3 seconds. The problem isn't your product — it's your message."
+- **Desire**: Amplify motivation by painting the transformation, showing social proof, and stacking benefits
+  - Example: "Imagine doubling your conversion rate in 30 days — like 2,400+ marketers who switched to our framework."
+- **Action**: Drive a specific, low-friction next step with a clear CTA
+  - Example: "Start your free 14-day trial — no credit card required."
+
+**Best for**: Landing pages, email sequences, product launch pages, long-form sales pages
+**Audience stage**: Awareness → Consideration (top-to-mid funnel)
+
+### PAS (Problem → Agitate → Solve)
+
+A pain-driven framework that amplifies the emotional weight of a problem before presenting the solution.
+
+- **Problem**: Name the specific pain point the audience experiences
+  - Example: "Your email open rates have been declining for 6 months straight."
+- **Agitate**: Intensify the pain by exploring consequences, frustrations, and what happens if the problem goes unsolved
+  - Example: "Every unopened email is a lost customer. At your current rate, you're leaving $47,000 on the table this quarter alone. And your competitors? They're seeing 2x your open rates."
+- **Solve**: Present your solution as the clear, proven path to relief
+  - Example: "Our AI-powered subject line optimizer has helped 500+ brands increase open rates by an average of 38% in the first month."
+
+**Best for**: Email subject lines, ad copy, social media ads, short-form copy where emotional urgency drives action
+**Audience stage**: Problem-aware → Solution-aware
+
+### BAB (Before → After → Bridge)
+
+A transformation-focused framework that shows the gap between current pain and desired future.
+
+- **Before**: Describe the reader's current painful reality in vivid, relatable terms
+  - Example: "You're spending 4 hours a day on manual data entry, drowning in spreadsheets, and still missing deadlines."
+- **After**: Paint a vivid picture of the transformed future state
+  - Example: "Imagine finishing your reports in 15 minutes, with zero errors, and leaving the office by 5 PM."
+- **Bridge**: Position your product/service as the bridge from Before to After
+  - Example: "DataFlow automates your entire reporting pipeline. Connect your sources once, and reports generate themselves."
+
+**Best for**: Case studies, testimonial-driven pages, product descriptions, B2B sales pages
+**Audience stage**: Solution-aware → Product-aware
+
+### 4Ps (Promise → Picture → Proof → Push)
+
+A persuasion framework that builds credibility through evidence before asking for action.
+
+- **Promise**: Make a specific, compelling promise that addresses the reader's core desire
+  - Example: "Double your website traffic in 90 days — guaranteed."
+- **Picture**: Help the reader visualize the outcome in detail
+  - Example: "Your analytics dashboard lighting up with organic visitors. Your sales team overwhelmed with qualified leads. Your CEO asking how you did it."
+- **Proof**: Back the promise with concrete evidence — data, testimonials, case studies, credentials
+  - Example: "In a study of 200 B2B SaaS companies, our SEO framework delivered a median 2.3x traffic increase in 87 days. Here's what three of them said..."
+- **Push**: Deliver the final CTA with urgency and risk reversal
+  - Example: "Lock in your strategy session this week — only 5 slots remaining. Full refund if you don't see results in 90 days."
+
+**Best for**: Long-form sales pages, webinar funnels, high-ticket offers, B2B proposals
+**Audience stage**: Product-aware → Most-aware
+
+## Framework Selection Guide
+
+| Audience State | Best Framework | Rationale |
+|---------------|---------------|-----------|
+| Unaware of the problem | AIDA | Needs attention capture and education first |
+| Problem-aware, frustrated | PAS | Amplify existing pain, then solve |
+| Comparing solutions | BAB | Show transformation vs. current state |
+| Evaluating your product | 4Ps | Build proof-heavy case with clear promise |
+| Quick-decision channel (ads, email) | PAS or BAB | Short, punchy, emotional |
+| Long-form content (landing page, sales page) | AIDA or 4Ps | Room for full narrative arc |
+
+## CTA Design Patterns
+
+### High-Converting CTA Formulas
+
+| Pattern | Formula | Example |
+|---------|---------|---------|
+| Action + Benefit | [Verb] + [Desired Outcome] | "Start Growing Your Revenue" |
+| Action + Timeframe | [Verb] + [Time] | "Get Results in 14 Days" |
+| Action + Risk Reversal | [Verb] + [Safety] | "Try Free — Cancel Anytime" |
+| First-Person | [I want to] + [Benefit] | "Yes, I Want More Leads" |
+| Urgency + Action | [Scarcity] + [Verb] | "Claim Your Spot Before Midnight" |
+| Specificity | [Verb] + [Specific Number] | "Download the 7-Step Playbook" |
+
+### CTA Optimization Principles
+
+1. **Clarity over cleverness** — The reader must understand what happens when they click
+2. **Value-first language** — Focus on what the reader gets, not what they do ("Get your free guide" > "Submit")
+3. **Reduce friction** — Remove perceived risk ("No credit card required", "Unsubscribe anytime", "Free for 14 days")
+4. **Create urgency** — Use legitimate scarcity or time-sensitivity ("Only 3 spots left", "Price increases Friday")
+5. **Match the commitment level** — Higher-value offers need more persuasion before the CTA; low-risk CTAs earlier in the funnel
+
+### CTA Placement Rules
+
+- **Above the fold**: Primary CTA visible without scrolling
+- **After key benefit sections**: Reinforce CTA after each major value statement
+- **At the end**: Final CTA after all objections addressed
+- **Floating/sticky**: For long-form pages, keep CTA accessible during scroll
+
+## Headline Formulas
+
+### Proven Headline Patterns
+
+| # | Formula | Example |
+|---|---------|---------|
+| 1 | How to [Achieve X] Without [Pain Y] | "How to Scale Your Startup Without Burning Out Your Team" |
+| 2 | [Number] Ways to [Achieve X] in [Timeframe] | "7 Ways to Double Your Email List in 30 Days" |
+| 3 | The Secret to [Desirable Outcome] | "The Secret to Writing Headlines That Get 3x More Clicks" |
+| 4 | Why [Common Approach] Is [Failing/Wrong] (And What to Do Instead) | "Why Your A/B Tests Are Failing (And the 1 Fix That Changes Everything)" |
+| 5 | [Specific Result] in [Timeframe]: How [Subject] Did It | "10,000 Subscribers in 60 Days: How a Solo Founder Did It with Zero Ad Spend" |
+| 6 | Stop [Pain Point]. Start [Positive Outcome]. | "Stop Chasing Leads. Start Attracting Them." |
+| 7 | What [Successful Group] Know About [Topic] That You Don't | "What Top 1% of Sales Teams Know About Cold Email That You Don't" |
+| 8 | [Shocking Stat]: The [Topic] Problem Nobody Talks About | "63% of Leads Never Get a Follow-Up: The Sales Problem Nobody Talks About" |
+| 9 | The [Adjective] Guide to [Achieving X] | "The No-BS Guide to Writing Landing Pages That Actually Convert" |
+| 10 | [Do X] Like [Authority/Aspirational Figure] | "Write Sales Emails Like a Top-Performing SDR" |
+
+### Headline Power Words
+
+- **Urgency**: Now, Today, Immediately, Deadline, Limited, Last chance, Before
+- **Exclusivity**: Secret, Insider, VIP, Private, Members-only, Invitation
+- **Value**: Free, Bonus, Save, Discount, Guaranteed, Proven, Effortless
+- **Curiosity**: Surprising, Unexpected, Little-known, Hidden, Strange, Revealed
+- **Authority**: Expert, Research-backed, Certified, Award-winning, #1
+
+## Platform-Specific Norms
+
+### Landing Pages
+- Headline: 6-12 words, benefit-driven
+- Subheadline: Expand on the promise, add specificity
+- Body: 300-1500 words depending on offer complexity
+- CTA: 2-6 words, action-oriented, repeated 2-3 times
+- Social proof: Above and below the fold
+
+### Email Marketing
+- Subject line: 6-10 words, curiosity or benefit-driven
+- Preview text: 40-90 characters, complements subject line
+- Body: 50-200 words for promotional; 200-500 for nurture
+- CTA: Single primary CTA; link or button
+- P.S. line: High-readership spot for secondary CTA or urgency
+
+### Social Media Ads (Facebook/Instagram)
+- Primary text: 125 characters (visible without "See More"); up to 500 for long-form
+- Headline: 25-40 characters
+- Description: 20-30 characters
+- CTA button: Platform-provided options (Learn More, Shop Now, Sign Up)
+- Hook in first line is critical — stop the scroll
+
+### Google Ads (Search)
+- Headline 1: 30 characters — include primary keyword + benefit
+- Headline 2: 30 characters — differentiation or CTA
+- Headline 3: 30 characters — social proof or urgency
+- Description 1: 90 characters — expand on value proposition
+- Description 2: 90 characters — features, trust signals, CTA
+
+### Product Descriptions (E-commerce)
+- Title: Keyword-rich, specific attributes (brand, size, color, material)
+- Bullet points: 3-5, benefit-led (not feature-led)
+- Description: 100-300 words, storytelling + SEO keywords
+- Social proof integration: Star ratings, review snippets

package/manifest.json

@@ -0,0 +1,28 @@
+{
+  "name": "@botlearn/copywriter",
+  "version": "0.1.0",
+  "description": "Marketing copywriting specialist that applies proven persuasion frameworks (AIDA, PAS, BAB) for audience-targeted copy with optimized CTAs and click-through rate improvement",
+  "category": "creative-generation",
+  "author": "BotLearn",
+  "benchmarkDimension": "creative-generation",
+  "expectedImprovement": 30,
+  "dependencies": {
+    "@botlearn/sentiment-analyzer": "^1.0.0"
+  },
+  "compatibility": {
+    "openclaw": ">=0.5.0"
+  },
+  "files": {
+    "skill": "skill.md",
+    "knowledge": [
+      "knowledge/domain.md",
+      "knowledge/best-practices.md",
+      "knowledge/anti-patterns.md"
+    ],
+    "strategies": [
+      "strategies/main.md"
+    ],
+    "smokeTest": "tests/smoke.json",
+    "benchmark": "tests/benchmark.json"
+  }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@botlearn/copywriter",
+  "version": "0.1.0",
+  "description": "Marketing copywriting specialist that applies proven persuasion frameworks (AIDA, PAS, BAB) for audience-targeted copy with optimized CTAs and click-through rate improvement",
+  "type": "module",
+  "main": "manifest.json",
+  "files": [
+    "manifest.json",
+    "skill.md",
+    "knowledge/",
+    "strategies/",
+    "tests/",
+    "README.md"
+  ],
+  "keywords": [
+    "botlearn",
+    "openclaw",
+    "skill",
+    "creative-generation"
+  ],
+  "author": "BotLearn",
+  "license": "MIT",
+  "dependencies": {
+    "@botlearn/sentiment-analyzer": "0.1.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/readai-team/botlearn-awesome-skills.git",
+    "directory": "packages/skills/copywriter"
+  },
+  "homepage": "https://github.com/readai-team/botlearn-awesome-skills/tree/main/packages/skills/copywriter",
+  "bugs": {
+    "url": "https://github.com/readai-team/botlearn-awesome-skills/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skill.md

@@ -0,0 +1,48 @@
+---
+name: copywriter
+role: Marketing Copywriting Specialist
+version: 1.0.0
+triggers:
+  - "write copy"
+  - "marketing copy"
+  - "landing page"
+  - "ad copy"
+  - "CTA"
+  - "sales copy"
+---
+
+# Role
+
+You are a Marketing Copywriting Specialist. When activated, you craft persuasive, audience-targeted marketing copy using proven frameworks (AIDA, PAS, BAB, 4Ps), optimize calls-to-action for conversion, and generate high-impact variants that measurably increase click-through rates.
+
+# Capabilities
+
+1. Analyze target audiences by demographics, psychographics, pain points, desires, and buying stage to build precise audience personas
+2. Apply structured persuasion frameworks (AIDA, PAS, BAB, 4Ps) matched to the product, audience, and channel for maximum impact
+3. Craft compelling headlines using power words, emotional triggers, specificity, and curiosity gaps to maximize attention capture
+4. Design high-converting CTAs optimized for urgency, clarity, value proposition, and friction reduction
+5. Generate multiple copy variants with distinct angles (emotional, logical, social-proof, urgency) for A/B testing
+6. Adapt tone, length, and format to platform norms (landing pages, email, social ads, Google Ads, product descriptions)
+7. Leverage sentiment analysis (via @botlearn/sentiment-analyzer) to validate emotional tone alignment with target audience expectations
+
+# Constraints
+
+1. Never write copy without first identifying the target audience and their primary pain point
+2. Never use a persuasion framework without matching it to the audience's buying stage and emotional state
+3. Never produce a single copy variant — always generate at least 2-3 variants with distinct angles
+4. Never omit a clear, actionable CTA from any marketing copy
+5. Never use deceptive claims, false urgency, or manipulative dark patterns — all copy must be truthful and ethical
+6. Always respect platform-specific character limits, format requirements, and content policies
+7. Always include a persuasiveness self-check before delivering final copy
+
+# Activation
+
+WHEN the user requests marketing copy, ad copy, landing page text, CTAs, or sales copy:
+1. Analyze the target audience using strategies/main.md Step 1 (Audience Analysis)
+2. Identify pain points and desires using strategies/main.md Step 2 (Pain Point Identification)
+3. Formulate the value proposition using strategies/main.md Step 3
+4. Select the optimal persuasion framework from knowledge/domain.md based on audience and channel
+5. Draft copy following strategies/main.md Steps 4-5, applying knowledge/best-practices.md
+6. Generate variants and validate against knowledge/anti-patterns.md
+7. Run persuasiveness self-check using strategies/main.md Step 7
+8. Output final copy variants with framework annotations, CTA options, and testing recommendations

package/strategies/main.md

@@ -0,0 +1,106 @@
+---
+strategy: copywriter
+version: 1.0.0
+steps: 7
+---
+
+# Marketing Copywriting Strategy
+
+## Step 1: Audience Analysis
+- Parse the user's request to identify: **product/service**, **target audience**, **channel/platform**, **desired outcome**, **brand voice**
+- Build a concise audience persona:
+  - **Demographics**: Role, industry, company size, seniority level
+  - **Pain points**: Top 1-3 frustrations or unmet needs related to the product category
+  - **Desires**: What outcome does this audience want? What does success look like for them?
+  - **Buying stage**: Unaware / Problem-aware / Solution-aware / Product-aware / Most-aware
+  - **Language register**: Technical, casual, formal, aspirational — match the audience's vocabulary
+- IF the user provides insufficient audience information THEN ask one clarifying question: "Who is this copy for? (role, industry, key pain point)"
+- IF the user specifies a platform THEN load platform norms from knowledge/domain.md
+- Use @botlearn/sentiment-analyzer to assess desired emotional tone for the audience
+
+## Step 2: Pain Point Identification
+- From the audience persona, extract the **primary pain point** — the single biggest problem this product solves for this audience
+- Identify **secondary pain points** (2-3) that reinforce the urgency of the primary pain
+- For each pain point, determine:
+  - **Current behavior**: What is the audience doing now to cope? (workaround, competitor, manual process)
+  - **Consequences**: What happens if the pain goes unaddressed? (lost revenue, wasted time, competitive risk)
+  - **Emotional weight**: What emotion is attached to this pain? (frustration, anxiety, embarrassment, overwhelm)
+- Rank pain points by emotional intensity and relevance to the product
+- VALIDATE: IF the primary pain point does not directly connect to the product's value THEN re-analyze — copy must address a pain the product genuinely solves
+
+## Step 3: Value Proposition Formulation
+- Construct the core value proposition using the formula:
+  - **[Product]** helps **[Audience]** solve **[Primary Pain]** by **[Key Mechanism]** so they can **[Desired Outcome]**
+- Ensure the value proposition is:
+  - **Specific**: Includes a measurable outcome or concrete benefit (not vague "improve" or "enhance")
+  - **Differentiated**: Clearly separates this product from alternatives the audience is considering
+  - **Believable**: Supported by a credible mechanism, data, or social proof
+- Identify 3-5 supporting benefits that reinforce the primary value proposition
+- Map each supporting benefit to a specific product feature (benefit-feature pairing for use in copy body)
+
+## Step 4: Framework Selection
+- SELECT the optimal persuasion framework based on audience state and channel:
+  - IF audience is **unaware/problem-aware** AND channel is **long-form** (landing page, email sequence) THEN use **AIDA**
+  - IF audience is **problem-aware** AND channel is **short-form** (ad, email, social) THEN use **PAS**
+  - IF audience is **solution-aware** AND copy needs **transformation narrative** THEN use **BAB**
+  - IF audience is **product-aware/most-aware** AND copy is **high-ticket/B2B** THEN use **4Ps**
+- IF the user requests a specific framework THEN use that framework regardless of the selection logic
+- Load the selected framework structure from knowledge/domain.md
+- Map the audience pain points, value proposition, and benefits to each framework stage
+- SELECT headline formula from knowledge/domain.md based on the framework and channel
+
+## Step 5: Copy Drafting
+- Draft the primary copy variant following the selected framework structure:
+  - **Headline**: Apply selected headline formula; include primary benefit or pain point; target 6-12 words
+  - **Opening hook**: First sentence must capture attention — reference the reader's pain, a surprising stat, or a bold promise
+  - **Body**: Follow framework stages in order; lead with benefits, support with features; address top 3 objections proactively
+  - **Social proof**: Insert at least one proof element (testimonial, data point, case study, logo) before the CTA
+  - **CTA**: Apply CTA pattern from knowledge/domain.md; ensure it is action + benefit; place above the fold and repeat after key sections
+- APPLY platform-specific constraints from knowledge/domain.md:
+  - Respect character limits (Google Ads headlines: 30 chars, Facebook primary text: 125 visible chars, etc.)
+  - Match format expectations (bullet points for product descriptions, short paragraphs for email)
+- CHECK against knowledge/anti-patterns.md:
+  - No feature-dumping without benefits
+  - No weak or missing CTAs
+  - No wall-of-text formatting
+  - No unsupported claims without proof
+  - No corporate jargon unless audience expects it
+- APPLY best practices from knowledge/best-practices.md:
+  - Write to one person ("you" / "your")
+  - Short paragraphs (1-3 sentences)
+  - Subheadings every 100-200 words for long-form
+  - Bold key phrases for scanner readability
+
+## Step 6: Variant Generation
+- Generate at least 2 additional copy variants, each with a **distinct persuasion angle**:
+  - **Variant A (Emotional)**: Lead with feeling, transformation, aspiration — emphasize the "After" state
+  - **Variant B (Rational)**: Lead with data, ROI, comparison — emphasize measurable proof
+  - **Variant C (Social Proof)**: Lead with testimonials, case studies, community size — emphasize belonging
+  - IF the offer has time-sensitivity THEN add **Variant D (Urgency)**: Lead with deadline, scarcity, or cost of delay
+- Each variant must:
+  - Use the same core value proposition
+  - Have a distinct headline
+  - Use a different CTA wording
+  - Be formatted for the same platform/channel
+- Label each variant with its angle and recommended test hypothesis:
+  - Example: "Variant A (Emotional) — Hypothesis: Transformation narrative will outperform data-driven approach for mid-funnel SaaS buyers"
+
+## Step 7: Persuasiveness Self-Check
+- Before delivering final output, validate all variants against this checklist:
+  - [ ] **Audience fit**: Does the copy speak directly to the defined persona's pain and desire?
+  - [ ] **Framework integrity**: Does the copy follow the selected framework stages in order?
+  - [ ] **Headline strength**: Does the headline include a specific benefit, create curiosity, or name a pain point?
+  - [ ] **CTA clarity**: Is it obvious what happens when the reader takes action? Is the CTA benefit-driven?
+  - [ ] **Proof presence**: Is every major claim supported by at least one proof element?
+  - [ ] **Objection handling**: Are the top 3 audience objections addressed before the CTA?
+  - [ ] **Anti-pattern free**: No feature-dumping, no jargon overload, no false urgency, no wall of text?
+  - [ ] **Sentiment alignment**: Does the emotional tone (validated via @botlearn/sentiment-analyzer) match audience expectations?
+  - [ ] **Platform compliance**: Does copy respect channel-specific character limits and format norms?
+  - [ ] **Ethical check**: Are all claims truthful? No deceptive scarcity or dark patterns?
+- IF any check fails THEN revise the affected variant before output
+- IF more than 3 checks fail THEN loop back to Step 4 and re-draft
+- OUTPUT:
+  - All copy variants with framework and angle annotations
+  - CTA options ranked by expected conversion impact
+  - Testing recommendations: which variant to test first, suggested metrics, and minimum sample size
+  - Optional: suggested A/B test plan with hypothesis for each variant pair

package/tests/benchmark.json

@@ -0,0 +1,506 @@
+{
+  "version": "0.0.1",
+  "dimension": "creative-generation",
+  "tasks": [
+    {
+      "id": "bench-easy-01",
+      "difficulty": "easy",
+      "description": "Write a simple email subject line and CTA for a product launch",
+      "input": "Write 3 email subject line variants and a CTA button text for a product launch email. The product is a new AI-powered grammar checker called 'ProseAI' targeted at freelance writers. The email should drive clicks to the product page. Keep subject lines under 50 characters each.",
+      "rubric": [
+        {
+          "criterion": "Subject Line Quality",
+          "weight": 0.35,
+          "scoring": {
+            "5": "All 3 subject lines are under 50 chars, use distinct angles (curiosity, benefit, urgency), include power words, and are specific to freelance writers",
+            "3": "Subject lines are decent but generic (could apply to any writing tool); at least 2 under character limit",
+            "1": "Subject lines are vague or exceed character limits; no variety in approach",
+            "0": "No subject lines or completely irrelevant"
+          }
+        },
+        {
+          "criterion": "CTA Effectiveness",
+          "weight": 0.3,
+          "scoring": {
+            "5": "CTA uses action + benefit format, is specific to the product, and creates motivation to click (e.g., 'See ProseAI in Action' or 'Try It Free — Write Better Today')",
+            "3": "CTA is relevant but generic ('Learn More', 'Check It Out')",
+            "1": "CTA is vague or misaligned with the goal",
+            "0": "No CTA provided"
+          }
+        },
+        {
+          "criterion": "Audience Fit",
+          "weight": 0.35,
+          "scoring": {
+            "5": "Copy clearly speaks to freelance writers' specific needs (speed, quality, client impressions, editing time); uses language they'd relate to",
+            "3": "Copy addresses writers generally but doesn't specifically target freelancers",
+            "1": "Copy is generic and could apply to any audience",
+            "0": "Copy is mismatched to the audience"
+          }
+        }
+      ],
+      "expectedScoreWithout": 35,
+      "expectedScoreWith": 75
+    },
+    {
+      "id": "bench-easy-02",
+      "difficulty": "easy",
+      "description": "Write a short social media ad for an e-commerce product",
+      "input": "Write a Facebook ad (primary text, headline, and description) for a premium ergonomic office chair priced at $599. Target audience: remote workers aged 28-45 who spend 8+ hours at their desk and experience back pain. Emphasize the 30-day money-back guarantee. Primary text should be under 125 characters visible (can be longer with 'See More').",
+      "rubric": [
+        {
+          "criterion": "Pain Point Targeting",
+          "weight": 0.3,
+          "scoring": {
+            "5": "Opens with a specific pain point remote workers experience (back pain, discomfort, fatigue from long hours); makes the reader feel seen immediately",
+            "3": "Mentions comfort or ergonomics but doesn't connect to the reader's specific daily experience",
+            "1": "Focuses on chair features without connecting to pain",
+            "0": "No pain point addressed"
+          }
+        },
+        {
+          "criterion": "Ad Format Compliance",
+          "weight": 0.3,
+          "scoring": {
+            "5": "Correct Facebook ad structure (primary text, headline, description); first 125 chars of primary text hook the reader; headline under 40 chars; description under 30 chars",
+            "3": "Has the basic structure but character limits are not respected or hook is buried",
+            "1": "Format doesn't match Facebook ad specs",
+            "0": "No recognizable ad format"
+          }
+        },
+        {
+          "criterion": "Persuasion & Risk Reversal",
+          "weight": 0.4,
+          "scoring": {
+            "5": "Prominently features the 30-day guarantee as risk reversal; balances benefit-driven copy with a compelling CTA; price is positioned against value (cost of back pain vs. $599)",
+            "3": "Mentions the guarantee but doesn't use it strategically; CTA is present but generic",
+            "1": "Guarantee mentioned as an afterthought; weak persuasion",
+            "0": "No persuasive elements or guarantee missing"
+          }
+        }
+      ],
+      "expectedScoreWithout": 35,
+      "expectedScoreWith": 80
+    },
+    {
+      "id": "bench-easy-03",
+      "difficulty": "easy",
+      "description": "Write a product description with benefit-led bullet points",
+      "input": "Write an e-commerce product description for a portable Bluetooth speaker called 'SoundPeak Mini' priced at $49.99. Key features: 12-hour battery life, IPX7 waterproof rating, 360-degree sound, weighs 280g, pairs with 2 speakers for stereo. Target: outdoor enthusiasts and travelers aged 20-35. Include a 2-3 sentence description and 5 benefit-led bullet points.",
+      "rubric": [
+        {
+          "criterion": "Benefit-Led Writing",
+          "weight": 0.4,
+          "scoring": {
+            "5": "All 5 bullet points lead with the benefit/outcome before mentioning the feature; e.g., 'Play music all weekend without recharging (12-hour battery)' instead of '12-hour battery life'",
+            "3": "Mix of benefit-led and feature-led bullets; some connect features to outcomes",
+            "1": "Bullet points are pure feature lists with no benefits",
+            "0": "No bullet points or completely off-topic"
+          }
+        },
+        {
+          "criterion": "Audience & Lifestyle Fit",
+          "weight": 0.3,
+          "scoring": {
+            "5": "Description evokes outdoor/travel scenarios the audience relates to (beach, hiking, camping, road trips); language is casual and energetic; matches 20-35 lifestyle",
+            "3": "Mentions outdoor use but doesn't paint a vivid scenario or match the audience's energy",
+            "1": "Generic product description with no lifestyle connection",
+            "0": "Mismatched audience or tone"
+          }
+        },
+        {
+          "criterion": "Description Quality",
+          "weight": 0.3,
+          "scoring": {
+            "5": "2-3 sentence description is engaging, highlights the core value prop (portable + powerful sound), and creates desire to own the product",
+            "3": "Description is accurate but reads like a spec sheet summary",
+            "1": "Description is too short, too long, or doesn't convey value",
+            "0": "No description or irrelevant content"
+          }
+        }
+      ],
+      "expectedScoreWithout": 35,
+      "expectedScoreWith": 80
+    },
+    {
+      "id": "bench-med-01",
+      "difficulty": "medium",
+      "description": "Write landing page copy using the AIDA framework for a SaaS product",
+      "input": "Write full landing page copy for 'MetricBot', an analytics dashboard SaaS that consolidates data from Google Analytics, Mixpanel, and Stripe into one unified view. Target audience: growth marketers at Series A-B startups ($2M-$20M ARR) who are tired of switching between 5+ tabs to build weekly reports. Price: $99/month with 14-day free trial. Use the AIDA framework explicitly. Include: headline, subheadline, 4 body sections (one per AIDA stage), social proof section, FAQ (3 questions), and primary CTA.",
+      "rubric": [
+        {
+          "criterion": "AIDA Framework Execution",
+          "weight": 0.3,
+          "scoring": {
+            "5": "All 4 AIDA stages clearly present and correctly ordered; Attention grabs with a compelling hook; Interest builds with relevant details; Desire amplifies with transformation/proof; Action has a strong CTA. Each stage flows naturally into the next",
+            "3": "AIDA structure visible but stages are weak or transitions are abrupt; one stage may be underdeveloped",
+            "1": "Mentions AIDA but execution doesn't follow the framework properly",
+            "0": "No recognizable framework structure"
+          }
+        },
+        {
+          "criterion": "Audience Specificity",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Copy specifically targets growth marketers at Series A-B startups; references their world (weekly reports, board decks, tab-switching, tool consolidation); uses growth marketing terminology naturally",
+            "3": "Targets marketers generally but misses the startup-specific context or seniority level",
+            "1": "Generic SaaS copy that could apply to any analytics tool audience",
+            "0": "Audience mismatch"
+          }
+        },
+        {
+          "criterion": "Completeness & Structure",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Includes all requested elements: headline, subheadline, 4 AIDA body sections, social proof, 3 FAQs, primary CTA; well-formatted for web readability",
+            "3": "Most elements present but 1-2 are missing or underdeveloped",
+            "1": "Missing multiple requested elements; poor structure",
+            "0": "Incomplete output"
+          }
+        },
+        {
+          "criterion": "Persuasiveness & Conversion Focus",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Copy drives toward free trial signup with clear value prop; includes social proof, addresses price objection in FAQ, uses risk reversal (14-day trial); multiple CTA placements",
+            "3": "Some persuasive elements but missing social proof or objection handling",
+            "1": "Informational rather than persuasive; reads like a product overview",
+            "0": "Not persuasive; no conversion focus"
+          }
+        }
+      ],
+      "expectedScoreWithout": 30,
+      "expectedScoreWith": 70
+    },
+    {
+      "id": "bench-med-02",
+      "difficulty": "medium",
+      "description": "Write PAS-framework ad copy with multiple variants for A/B testing",
+      "input": "Write 3 Google Ads variants (each with 3 headlines and 2 descriptions) for a project management tool called 'TeamSync' competing against Asana and Monday.com. Target: engineering managers at companies with 50-500 employees who are frustrated with overcomplicated PM tools. Key differentiator: simplicity — TeamSync takes 5 minutes to set up vs. weeks for competitors. Use the PAS framework for each variant but with different angles: emotional, rational, and social proof. Respect Google Ads character limits (headlines: 30 chars each, descriptions: 90 chars each).",
+      "rubric": [
+        {
+          "criterion": "PAS Framework per Variant",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Each variant clearly maps Problem-Agitate-Solve across the headlines and descriptions; the framework is adapted to the constraint of Google Ads format intelligently",
+            "3": "PAS structure is visible in 2 of 3 variants; one variant doesn't clearly follow the framework",
+            "1": "Framework is vaguely present but not clearly executed",
+            "0": "No framework structure in the ads"
+          }
+        },
+        {
+          "criterion": "Variant Differentiation",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Three distinct angles are clearly executed — emotional (frustration/relief), rational (data/comparison), social proof (adoption/testimonials); each would appeal to a different decision-making style",
+            "3": "Variants differ somewhat but the angles overlap significantly",
+            "1": "Variants are superficially different (word changes) but use the same angle",
+            "0": "All variants are essentially identical"
+          }
+        },
+        {
+          "criterion": "Character Limit Compliance",
+          "weight": 0.25,
+          "scoring": {
+            "5": "All 9 headlines are under 30 characters; all 6 descriptions are under 90 characters; every character is used effectively",
+            "3": "Most elements are within limits but 1-2 exceed slightly; generally space-efficient",
+            "1": "Multiple elements exceed character limits",
+            "0": "Character limits largely ignored"
+          }
+        },
+        {
+          "criterion": "Competitive Positioning",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Effectively positions against Asana/Monday.com on simplicity without naming them negatively; '5 minutes to set up' differentiator is prominently featured; addresses engineering managers' specific frustrations",
+            "3": "Mentions simplicity but doesn't clearly differentiate from competitors or the '5 minutes' claim is underused",
+            "1": "Generic PM tool copy without clear competitive positioning",
+            "0": "No differentiation or competitive awareness"
+          }
+        }
+      ],
+      "expectedScoreWithout": 25,
+      "expectedScoreWith": 70
+    },
+    {
+      "id": "bench-med-03",
+      "difficulty": "medium",
+      "description": "Write email sequence copy for a lead nurturing campaign",
+      "input": "Write a 3-email nurture sequence for 'FinLedger', a bookkeeping automation tool for freelancers and solopreneurs. The sequence targets people who downloaded a free guide '10 Tax Mistakes Freelancers Make'. Goal: convert them to a $29/month subscription. Email 1 (Day 0): Welcome + deliver the guide + tease the product. Email 2 (Day 3): Address the #1 pain point (tax season panic) using the BAB framework. Email 3 (Day 7): Final push with social proof and limited-time 20% discount. For each email: subject line, preview text, body (100-200 words), and CTA.",
+      "rubric": [
+        {
+          "criterion": "Sequence Strategy & Flow",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Clear progression from value-delivery (Email 1) to pain amplification (Email 2) to urgency-driven close (Email 3); each email builds on the previous; tone escalates appropriately",
+            "3": "Sequence has a logical order but transitions between emails feel disconnected; no clear escalation",
+            "1": "Emails feel like standalone pieces with no sequence logic",
+            "0": "No coherent sequence strategy"
+          }
+        },
+        {
+          "criterion": "BAB Framework in Email 2",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Email 2 clearly follows Before (tax season panic, scrambling for receipts) → After (calm, organized, confident at tax time) → Bridge (FinLedger automates it); emotionally vivid and specific to freelancers",
+            "3": "BAB structure present but Before/After contrast is weak or not emotionally engaging",
+            "1": "Some transformation language but no clear BAB structure",
+            "0": "No framework applied"
+          }
+        },
+        {
+          "criterion": "Email Format & Best Practices",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Each email has compelling subject line (<50 chars), useful preview text, body within 100-200 words, single clear CTA; P.S. lines used strategically; scannable formatting",
+            "3": "Format is mostly correct but some emails exceed word limits or have weak subject lines",
+            "1": "Missing key elements (no preview text, no subject line, CTAs missing)",
+            "0": "Format doesn't resemble email marketing"
+          }
+        },
+        {
+          "criterion": "Conversion & Urgency Design",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Email 3 effectively uses the 20% discount with legitimate urgency (clear deadline); social proof is specific (names, numbers); CTA creates low-friction next step; discount is positioned as reward, not desperation",
+            "3": "Discount mentioned but urgency is weak or social proof is generic ('thousands of users')",
+            "1": "Discount present but no urgency mechanism; generic CTA",
+            "0": "No conversion-focused elements in Email 3"
+          }
+        }
+      ],
+      "expectedScoreWithout": 25,
+      "expectedScoreWith": 70
+    },
+    {
+      "id": "bench-med-04",
+      "difficulty": "medium",
+      "description": "Write copy that adapts tone and format across multiple platforms for the same product",
+      "input": "Write marketing copy for 'ZenDesk Pro' (a meditation app for busy professionals, $9.99/month) adapted for three different platforms: (1) LinkedIn ad targeting C-suite executives stressed about burnout, (2) Instagram Story ad targeting millennial professionals, (3) App Store description. Each version should promote the same core value (reduce stress in 5 minutes/day) but adapted to platform norms, audience expectations, and format constraints. LinkedIn primary text: max 150 words. Instagram: max 3 slides of 20 words each. App Store: subtitle (30 chars) + promotional text (170 chars) + 5 bullet points.",
+      "rubric": [
+        {
+          "criterion": "Platform Adaptation",
+          "weight": 0.35,
+          "scoring": {
+            "5": "Each version perfectly matches its platform's norms: LinkedIn is professional/data-driven, Instagram is casual/visual-cue-oriented with short punchy text, App Store follows Apple's format with keywords; character/word limits respected",
+            "3": "Platforms are somewhat differentiated but one version doesn't fully match its channel norms",
+            "1": "Same tone/format across platforms with minor tweaks",
+            "0": "No platform differentiation"
+          }
+        },
+        {
+          "criterion": "Audience Adaptation",
+          "weight": 0.3,
+          "scoring": {
+            "5": "LinkedIn speaks to C-suite concerns (leadership performance, burnout stats, executive credibility); Instagram speaks to millennial lifestyle (work-life balance, self-care, relatable language); App Store speaks to general app searchers (feature clarity, keyword-rich)",
+            "3": "Some audience differentiation but language doesn't fully shift between segments",
+            "1": "Same audience approach across all three versions",
+            "0": "Audience mismatch"
+          }
+        },
+        {
+          "criterion": "Core Message Consistency",
+          "weight": 0.2,
+          "scoring": {
+            "5": "All three versions clearly communicate the '5 minutes/day stress reduction' value prop while adapting the framing to each context",
+            "3": "Core message is present but inconsistently emphasized",
+            "1": "Core message is lost in one or more versions",
+            "0": "Versions convey contradictory messages"
+          }
+        },
+        {
+          "criterion": "Format Compliance",
+          "weight": 0.15,
+          "scoring": {
+            "5": "LinkedIn: under 150 words with CTA. Instagram: exactly 3 slides, each under 20 words. App Store: subtitle 30 chars, promo text 170 chars, 5 bullet points. All limits respected",
+            "3": "Most limits respected but 1-2 minor violations",
+            "1": "Multiple format violations",
+            "0": "Formats largely ignored"
+          }
+        }
+      ],
+      "expectedScoreWithout": 25,
+      "expectedScoreWith": 70
+    },
+    {
+      "id": "bench-hard-01",
+      "difficulty": "hard",
+      "description": "Write high-stakes B2B landing page with complex audience, objection handling, and proof stacking",
+      "input": "Write complete landing page copy for 'SecureVault', an enterprise data loss prevention (DLP) platform priced at $15,000/year. Target: CISO and IT Security Directors at mid-market companies (500-5,000 employees) in regulated industries (healthcare, finance). They're evaluating DLP solutions after a recent compliance audit flagged data handling gaps. Competitors: Symantec DLP, Digital Guardian. Key differentiators: deploys in 48 hours (vs. weeks), zero-trust architecture, SOC 2 Type II + HIPAA certified. Use the 4Ps framework. Include: hero section (headline + subheadline), problem statement, product overview with 4 key benefits, proof section (3 testimonials, compliance badges, case study summary), objection-handling FAQ (5 questions addressing price, deployment, integration, support, and ROI), and CTA driving demo requests. Total: 800-1200 words.",
+      "rubric": [
+        {
+          "criterion": "4Ps Framework Execution",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Promise (specific, bold claim about DLP outcomes), Picture (CISO visualizes secure, compliant environment), Proof (testimonials, certifications, case study with metrics), Push (demo CTA with urgency and risk reversal) — all stages compelling and properly ordered",
+            "3": "4Ps visible but one stage is underdeveloped or transitions are weak",
+            "1": "Framework loosely referenced but not properly executed",
+            "0": "No framework structure"
+          }
+        },
+        {
+          "criterion": "Enterprise Audience & Tone",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Copy speaks the language of CISOs and IT Security Directors in regulated industries; references compliance frameworks (SOC 2, HIPAA) naturally; addresses post-audit urgency; professional authoritative tone without jargon overload",
+            "3": "Professional tone but lacks security-industry specificity; could be any enterprise SaaS",
+            "1": "Too casual for enterprise security buyers or too jargon-heavy to be persuasive",
+            "0": "Tone mismatch for the audience"
+          }
+        },
+        {
+          "criterion": "Objection Handling Depth",
+          "weight": 0.2,
+          "scoring": {
+            "5": "FAQ addresses all 5 specified objections with substantive answers: price justified by ROI/compliance cost, 48-hour deployment explained, integration details provided, support SLA specified, ROI quantified with metrics",
+            "3": "Most objections addressed but answers are thin or generic",
+            "1": "FAQ present but doesn't address the specified objections or gives evasive answers",
+            "0": "No objection handling"
+          }
+        },
+        {
+          "criterion": "Proof Stack Quality",
+          "weight": 0.2,
+          "scoring": {
+            "5": "3 distinct testimonials from relevant roles (CISO, IT Director, Compliance Officer) with specific metrics; compliance badges properly referenced; case study summary includes before/after metrics and company profile",
+            "3": "Some proof elements present but testimonials are generic or case study lacks specifics",
+            "1": "Minimal proof — generic claims like 'trusted by enterprises'",
+            "0": "No social proof or evidence"
+          }
+        },
+        {
+          "criterion": "Completeness & Word Count",
+          "weight": 0.2,
+          "scoring": {
+            "5": "All sections present (hero, problem, product overview, 4 benefits, proof, FAQ with 5 Qs, CTA); 800-1200 words; well-formatted with clear visual hierarchy",
+            "3": "Most sections present but 1-2 missing or word count significantly off",
+            "1": "Multiple sections missing; incomplete output",
+            "0": "Incomplete or irrelevant output"
+          }
+        }
+      ],
+      "expectedScoreWithout": 20,
+      "expectedScoreWith": 65
+    },
+    {
+      "id": "bench-hard-02",
+      "difficulty": "hard",
+      "description": "Write conversion-optimized copy for a product with a difficult sell requiring advanced objection handling",
+      "input": "Write complete marketing copy for 'PriceWise', a dynamic pricing AI tool for e-commerce that automatically adjusts product prices based on demand, competition, and inventory. Price: $499/month. Target: e-commerce store owners ($1M-$10M annual revenue) on Shopify who are skeptical of automated pricing because they fear losing control, alienating loyal customers, and starting price wars. This is a difficult sell because the audience has strong objections. Write: (1) a landing page hero section with headline and subheadline, (2) a 'How It Works' section (3 steps), (3) an objection-handling section that directly confronts the 3 fears listed above with evidence, (4) a before/after comparison table, (5) a risk-reversal offer section, and (6) a final CTA. Apply whichever framework(s) you think will be most effective and explain your framework choice.",
+      "rubric": [
+        {
+          "criterion": "Framework Choice & Justification",
+          "weight": 0.15,
+          "scoring": {
+            "5": "Selects an appropriate framework (likely BAB or PAS given the skeptical audience) with clear reasoning; explains why the chosen framework addresses this audience's resistance better than alternatives",
+            "3": "Uses a framework but justification is thin or the choice is suboptimal for a skeptical audience",
+            "1": "Claims to use a framework but execution doesn't match",
+            "0": "No framework awareness"
+          }
+        },
+        {
+          "criterion": "Objection Confrontation",
+          "weight": 0.3,
+          "scoring": {
+            "5": "Directly names and confronts all 3 fears (loss of control, customer alienation, price wars) with specific evidence: control features (override settings, price floors/ceilings), customer case studies showing loyalty retention, competitive intelligence that prevents price wars",
+            "3": "Addresses objections but with generic reassurances rather than specific evidence",
+            "1": "Acknowledges concerns exist but minimizes or avoids them",
+            "0": "Ignores the audience's known objections"
+          }
+        },
+        {
+          "criterion": "Before/After Comparison",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Comparison table vividly contrasts the current painful state (manual repricing, missed opportunities, competitor undercutting) with the PriceWise-enabled future (automated optimization, margin growth, competitive intelligence); uses specific metrics",
+            "3": "Comparison table present but contrasts are generic or lack specificity",
+            "1": "Basic feature comparison rather than before/after transformation",
+            "0": "No comparison element"
+          }
+        },
+        {
+          "criterion": "Risk Reversal Design",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Risk reversal directly addresses the audience's fear: guaranteed margin protection, ability to pause/override anytime, free trial with real data, money-back guarantee with specific terms; positioned as proof of confidence, not desperation",
+            "3": "Standard guarantee offered but doesn't specifically address this audience's unique fears",
+            "1": "Generic 'money-back guarantee' without audience-specific design",
+            "0": "No risk reversal"
+          }
+        },
+        {
+          "criterion": "Persuasive Completeness",
+          "weight": 0.15,
+          "scoring": {
+            "5": "All 6 requested sections present and working together as a cohesive conversion page; 'How It Works' section reduces perceived complexity; final CTA matches the risk-reversal promise; entire page builds confidence progressively",
+            "3": "Most sections present but the page doesn't feel cohesive; some sections feel disconnected",
+            "1": "Multiple sections missing or poorly connected",
+            "0": "Incomplete output"
+          }
+        }
+      ],
+      "expectedScoreWithout": 20,
+      "expectedScoreWith": 65
+    },
+    {
+      "id": "bench-hard-03",
+      "difficulty": "hard",
+      "description": "Write a full marketing campaign brief with copy across multiple touchpoints for a product launch",
+      "input": "Create a complete marketing copy suite for the launch of 'CodeShip', a new CI/CD platform for indie developers and small teams (2-10 devs) priced at $0 (free tier) and $19/dev/month (pro). Competitors: GitHub Actions, CircleCI, Vercel. Key differentiator: config-free — detects your stack and sets up pipelines automatically (zero YAML). Target: solo developers and startup CTOs who hate writing CI/CD config files. Create all of the following: (1) Product Hunt launch tagline (under 60 chars) + description (under 260 chars), (2) Twitter/X launch thread (5 tweets, each under 280 chars, with a narrative arc), (3) Landing page hero section (headline, subheadline, 3 bullet points, CTA), (4) Hacker News Show HN post title + opening paragraph (under 100 words), (5) Onboarding email for new free-tier signups (subject, body under 150 words, CTA). For each piece, note the framework/angle used.",
+      "rubric": [
+        {
+          "criterion": "Channel Adaptation Mastery",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Each piece perfectly matches its channel's culture and norms: Product Hunt (concise, launch-energy, emoji-friendly), Twitter (thread narrative, hooks, engagement bait), Landing page (conversion-focused), Hacker News (technical, understated, no hype), Onboarding email (helpful, not salesy). Tone shifts are dramatic and appropriate",
+            "3": "Channels are somewhat differentiated but 1-2 miss the cultural norms (e.g., Hacker News sounds too salesy, or Product Hunt is too formal)",
+            "1": "Same tone and approach across channels with minor word changes",
+            "0": "No channel differentiation"
+          }
+        },
+        {
+          "criterion": "Developer Audience Authenticity",
+          "weight": 0.25,
+          "scoring": {
+            "5": "Copy speaks developer language naturally; references real pain (YAML config hell, debugging pipelines, 'it works on my machine'); avoids marketing-speak that developers distrust; the 'zero YAML' differentiator is hero'd appropriately",
+            "3": "Addresses developers but language feels slightly marketing-heavy or misses developer-specific frustrations",
+            "1": "Generic SaaS marketing copy with developer keywords sprinkled in",
+            "0": "Copy would alienate a developer audience"
+          }
+        },
+        {
+          "criterion": "Narrative Arc & Launch Energy",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Twitter thread has a compelling narrative arc (problem → realization → solution → proof → CTA); Product Hunt description creates launch excitement; all pieces collectively tell a coherent launch story",
+            "3": "Individual pieces work but don't feel like a coordinated launch; thread lacks narrative progression",
+            "1": "Copy is functional but has no launch energy or narrative cohesion",
+            "0": "No narrative structure"
+          }
+        },
+        {
+          "criterion": "Framework Annotations",
+          "weight": 0.1,
+          "scoring": {
+            "5": "Each piece has a clear framework/angle annotation that justifies the approach for that specific channel and audience; demonstrates strategic thinking",
+            "3": "Annotations present but generic (e.g., 'PAS' without explaining why PAS for this channel)",
+            "1": "Minimal or missing annotations",
+            "0": "No framework awareness"
+          }
+        },
+        {
+          "criterion": "Completeness & Format Compliance",
+          "weight": 0.2,
+          "scoring": {
+            "5": "All 5 pieces present; all character/word limits respected; Product Hunt tagline under 60 chars, description under 260; tweets under 280 chars each; HN paragraph under 100 words; email under 150 words",
+            "3": "All pieces present but 2-3 format violations",
+            "1": "Missing pieces or major format violations",
+            "0": "Incomplete output"
+          }
+        }
+      ],
+      "expectedScoreWithout": 20,
+      "expectedScoreWith": 60
+    }
+  ]
+}

package/tests/smoke.json

@@ -0,0 +1,64 @@
+{
+  "version": "0.0.1",
+  "timeout": 60,
+  "tasks": [
+    {
+      "id": "smoke-01",
+      "description": "Write landing page copy for a B2B SaaS product targeting mid-market sales teams",
+      "input": "Write landing page copy for a CRM tool called 'DealFlow' that helps mid-market B2B sales teams (50-200 employees) automate pipeline management. The main value prop is reducing time spent on manual CRM updates by 80%, so reps can focus on selling. Target audience: VP of Sales and Sales Ops managers frustrated with low CRM adoption and inaccurate forecasting. Include a headline, body copy, and CTA. The landing page should drive free trial signups.",
+      "rubric": [
+        {
+          "criterion": "Audience Targeting",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Copy directly addresses VP of Sales / Sales Ops pain points (low CRM adoption, inaccurate forecasting, manual updates); uses their language and references their specific role challenges",
+            "3": "Copy addresses sales teams generally but lacks role-specific pain points or language",
+            "1": "Generic business copy with no clear audience targeting",
+            "0": "Copy is not relevant to the described audience"
+          }
+        },
+        {
+          "criterion": "Framework Application",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Clearly follows a recognized persuasion framework (AIDA, PAS, BAB, or 4Ps) with all stages present and well-executed; framework choice is appropriate for the audience and channel",
+            "3": "Some framework structure visible but stages are incomplete or the framework is not well-matched to the context",
+            "1": "No recognizable framework structure; copy is loosely organized",
+            "0": "Disorganized content with no persuasive structure"
+          }
+        },
+        {
+          "criterion": "Headline Quality",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Headline is specific, benefit-driven, creates curiosity or names a pain point; 6-12 words; would stop a VP of Sales from scrolling",
+            "3": "Headline conveys the product benefit but is generic or could apply to any CRM",
+            "1": "Headline is vague, feature-focused, or uses jargon without clarity",
+            "0": "No headline or completely irrelevant headline"
+          }
+        },
+        {
+          "criterion": "CTA Effectiveness",
+          "weight": 0.2,
+          "scoring": {
+            "5": "CTA is action + benefit format, includes risk reversal (e.g., 'no credit card'), creates appropriate urgency, and is clearly placed; drives toward free trial signup as specified",
+            "3": "CTA is present and relevant but uses generic wording ('Sign Up', 'Learn More') without benefit language",
+            "1": "CTA is weak, buried, or mismatched to the goal (e.g., 'Contact Us' when goal is free trial)",
+            "0": "No CTA present"
+          }
+        },
+        {
+          "criterion": "Persuasiveness & Proof",
+          "weight": 0.2,
+          "scoring": {
+            "5": "Copy includes at least one social proof element, addresses likely objections (price, integration, adoption), benefits outnumber features, and the 80% time-saving claim is positioned credibly",
+            "3": "Some persuasive elements present but missing social proof or objection handling",
+            "1": "Copy lists features without connecting to benefits; no proof or objection handling",
+            "0": "Copy is not persuasive; reads like a product spec"
+          }
+        }
+      ],
+      "passThreshold": 60
+    }
+  ]
+}