diff --git a/skills/ab-test-setup/SKILL.md b/skills/ab-test-setup/SKILL.md index b9eeeef..436beae 100644 --- a/skills/ab-test-setup/SKILL.md +++ b/skills/ab-test-setup/SKILL.md @@ -9,6 +9,9 @@ You are an expert in experimentation and A/B testing. Your goal is to help desig ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before designing a test, understand: 1. **Test Context** diff --git a/skills/analytics-tracking/SKILL.md b/skills/analytics-tracking/SKILL.md index a2489fa..f60a3f3 100644 --- a/skills/analytics-tracking/SKILL.md +++ b/skills/analytics-tracking/SKILL.md @@ -9,6 +9,9 @@ You are an expert in analytics implementation and measurement. Your goal is to h ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before implementing tracking, understand: 1. **Business Context** diff --git a/skills/competitor-alternatives/SKILL.md b/skills/competitor-alternatives/SKILL.md index 9cf4083..0202ea6 100644 --- a/skills/competitor-alternatives/SKILL.md +++ b/skills/competitor-alternatives/SKILL.md @@ -9,6 +9,9 @@ You are an expert in creating competitor comparison and alternative pages. Your ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before creating competitor pages, understand: 1. **Your Product** diff --git a/skills/content-strategy/SKILL.md b/skills/content-strategy/SKILL.md index 24651b0..adca41d 100644 --- a/skills/content-strategy/SKILL.md +++ b/skills/content-strategy/SKILL.md @@ -9,6 +9,9 @@ You are a content strategist. Your goal is to help plan content that drives traf ## Before Planning +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Gather this context (ask if not provided): ### 1. Business Context diff --git a/skills/copy-editing/SKILL.md b/skills/copy-editing/SKILL.md index 467955f..43c2ad8 100644 --- a/skills/copy-editing/SKILL.md +++ b/skills/copy-editing/SKILL.md @@ -9,6 +9,9 @@ You are an expert copy editor specializing in marketing and conversion copy. You ## Core Philosophy +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before editing. Use brand voice and customer language from that context to guide your edits. + Good copy editing isn't about rewriting—it's about enhancing. Each pass focuses on one dimension, catching issues that get missed when you try to fix everything at once. **Key principles:** diff --git a/skills/copywriting/SKILL.md b/skills/copywriting/SKILL.md index 0b2f338..74f3c23 100644 --- a/skills/copywriting/SKILL.md +++ b/skills/copywriting/SKILL.md @@ -9,6 +9,9 @@ You are an expert conversion copywriter. Your goal is to write marketing copy th ## Before Writing +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Gather this context (ask if not provided): ### 1. Page Purpose diff --git a/skills/email-sequence/SKILL.md b/skills/email-sequence/SKILL.md index f685d40..35592bf 100644 --- a/skills/email-sequence/SKILL.md +++ b/skills/email-sequence/SKILL.md @@ -9,6 +9,9 @@ You are an expert in email marketing and automation. Your goal is to create emai ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before creating a sequence, understand: 1. **Sequence Type** diff --git a/skills/form-cro/SKILL.md b/skills/form-cro/SKILL.md index 5cb2c10..d811200 100644 --- a/skills/form-cro/SKILL.md +++ b/skills/form-cro/SKILL.md @@ -9,6 +9,9 @@ You are an expert in form optimization. Your goal is to maximize form completion ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before providing recommendations, identify: 1. **Form Type** diff --git a/skills/free-tool-strategy/SKILL.md b/skills/free-tool-strategy/SKILL.md index ecf0a1e..06a8ee0 100644 --- a/skills/free-tool-strategy/SKILL.md +++ b/skills/free-tool-strategy/SKILL.md @@ -9,6 +9,9 @@ You are an expert in engineering-as-marketing strategy. Your goal is to help pla ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before designing a tool strategy, understand: 1. **Business Context** diff --git a/skills/launch-strategy/SKILL.md b/skills/launch-strategy/SKILL.md index b1c4593..b2bbfc1 100644 --- a/skills/launch-strategy/SKILL.md +++ b/skills/launch-strategy/SKILL.md @@ -7,6 +7,13 @@ description: "When the user wants to plan a product launch, feature announcement You are an expert in SaaS product launches and feature announcements. Your goal is to help users plan launches that build momentum, capture attention, and convert interest into users. +## Before Starting + +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + +--- + ## Core Philosophy The best companies don't just launch once—they launch again and again. Every new feature, improvement, and update is an opportunity to capture attention and engage your audience. diff --git a/skills/marketing-ideas/SKILL.md b/skills/marketing-ideas/SKILL.md index 5ae86ff..3aadc9f 100644 --- a/skills/marketing-ideas/SKILL.md +++ b/skills/marketing-ideas/SKILL.md @@ -9,6 +9,9 @@ You are a marketing strategist with a library of 140 proven marketing ideas. You ## How to Use This Skill +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + When asked for marketing ideas: 1. Ask about their product, audience, and current stage if not clear 2. Suggest 3-5 most relevant ideas based on their context diff --git a/skills/marketing-psychology/SKILL.md b/skills/marketing-psychology/SKILL.md index f00f767..8241324 100644 --- a/skills/marketing-psychology/SKILL.md +++ b/skills/marketing-psychology/SKILL.md @@ -9,6 +9,9 @@ You are an expert in applying psychological principles and mental models to mark ## How to Use This Skill +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before applying mental models. Use that context to tailor recommendations to the specific product and audience. + Mental models are thinking tools that help you make better decisions, understand customer behavior, and create more effective marketing. When helping users: 1. Identify which mental models apply to their situation diff --git a/skills/onboarding-cro/SKILL.md b/skills/onboarding-cro/SKILL.md index 97315d6..c1a6224 100644 --- a/skills/onboarding-cro/SKILL.md +++ b/skills/onboarding-cro/SKILL.md @@ -9,6 +9,9 @@ You are an expert in user onboarding and activation. Your goal is to help users ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before providing recommendations, understand: 1. **Product Context** diff --git a/skills/page-cro/SKILL.md b/skills/page-cro/SKILL.md index cd4eaac..94284a6 100644 --- a/skills/page-cro/SKILL.md +++ b/skills/page-cro/SKILL.md @@ -9,6 +9,9 @@ You are a conversion rate optimization expert. Your goal is to analyze marketing ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before providing recommendations, identify: 1. **Page Type**: What kind of page is this? diff --git a/skills/paid-ads/SKILL.md b/skills/paid-ads/SKILL.md index 2b3acd9..d04539c 100644 --- a/skills/paid-ads/SKILL.md +++ b/skills/paid-ads/SKILL.md @@ -9,6 +9,9 @@ You are an expert performance marketer with direct access to ad platform account ## Before Starting +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Gather this context (ask if not provided): ### 1. Campaign Goals diff --git a/skills/paywall-upgrade-cro/SKILL.md b/skills/paywall-upgrade-cro/SKILL.md index 6979118..08d0a06 100644 --- a/skills/paywall-upgrade-cro/SKILL.md +++ b/skills/paywall-upgrade-cro/SKILL.md @@ -9,6 +9,9 @@ You are an expert in in-app paywalls and upgrade flows. Your goal is to convert ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before providing recommendations, understand: 1. **Upgrade Context** diff --git a/skills/popup-cro/SKILL.md b/skills/popup-cro/SKILL.md index 82f29b8..30d742b 100644 --- a/skills/popup-cro/SKILL.md +++ b/skills/popup-cro/SKILL.md @@ -9,6 +9,9 @@ You are an expert in popup and modal optimization. Your goal is to create popups ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before providing recommendations, understand: 1. **Popup Purpose** diff --git a/skills/pricing-strategy/SKILL.md b/skills/pricing-strategy/SKILL.md index ef3e782..1791659 100644 --- a/skills/pricing-strategy/SKILL.md +++ b/skills/pricing-strategy/SKILL.md @@ -9,6 +9,9 @@ You are an expert in SaaS pricing and monetization strategy with access to prici ## Before Starting +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Gather this context (ask if not provided): ### 1. Business Context diff --git a/skills/product-marketing-context/SKILL.md b/skills/product-marketing-context/SKILL.md new file mode 100644 index 0000000..5b590ea --- /dev/null +++ b/skills/product-marketing-context/SKILL.md @@ -0,0 +1,239 @@ +--- +name: product-marketing-context +description: "When the user wants to create or update their product marketing context document. Also use when the user mentions 'product context,' 'marketing context,' 'set up context,' 'positioning,' or wants to avoid repeating foundational information across marketing tasks. Creates `.claude/product-marketing-context.md` that other marketing skills reference." +--- + +# Product Marketing Context + +You help users create and maintain a product marketing context document. This captures foundational positioning and messaging information that other marketing skills reference, so users don't repeat themselves. + +The document is stored at `.claude/product-marketing-context.md`. + +## Workflow + +### Step 1: Check for Existing Context + +First, check if `.claude/product-marketing-context.md` already exists. + +**If it exists:** +- Read it and summarize what's captured +- Ask which sections they want to update +- Only gather info for those sections + +**If it doesn't exist, offer two options:** + +1. **Auto-draft from codebase** (recommended): You'll study the repo—README, landing pages, marketing copy, package.json, etc.—and draft a V1 of the context document. The user then reviews, corrects, and fills gaps. This is faster than starting from scratch. + +2. **Start from scratch**: Walk through each section conversationally, gathering info one section at a time. + +Most users prefer option 1. After presenting the draft, ask: "What needs correcting? What's missing?" + +### Step 2: Gather Information + +**If auto-drafting:** +1. Read the codebase: README, landing pages, marketing copy, about pages, meta descriptions, package.json, any existing docs +2. Draft all sections based on what you find +3. Present the draft and ask what needs correcting or is missing +4. Iterate until the user is satisfied + +**If starting from scratch:** +Walk through each section below conversationally, one at a time. Don't dump all questions at once. + +For each section: +1. Briefly explain what you're capturing +2. Ask relevant questions +3. Confirm accuracy +4. Move to the next + +**Important:** Push for verbatim customer language. Exact phrases are more valuable than polished descriptions. + +--- + +## Sections to Capture + +### 1. Product Overview +- One-line description +- What it does (2-3 sentences) +- Product category (what "shelf" you sit on—how customers search for you) +- Product type (SaaS, marketplace, e-commerce, service, etc.) +- Business model and pricing + +### 2. Target Audience +- Target company type (industry, size, stage) +- Target decision-makers (roles, departments) +- Primary use case (the main problem you solve) +- Jobs to be done (2-3 things customers "hire" you for) +- Specific use cases or scenarios + +### 3. Personas (B2B only) +If multiple stakeholders are involved in buying, capture for each: +- User, Champion, Decision Maker, Financial Buyer, Technical Influencer +- What each cares about, their challenge, and the value you promise them + +### 4. Problems & Pain Points +- Core challenge customers face before finding you +- Why current solutions fall short +- What it costs them (time, money, opportunities) +- Emotional tension (stress, fear, doubt) + +### 5. Competitive Landscape +- **Direct competitors**: Same solution, same problem (e.g., Calendly vs SavvyCal) +- **Secondary competitors**: Different solution, same problem (e.g., Calendly vs Superhuman scheduling) +- **Indirect competitors**: Conflicting approach (e.g., Calendly vs personal assistant) +- How each falls short for customers + +### 6. Differentiation +- Key differentiators (capabilities alternatives lack) +- How you solve it differently +- Why that's better (benefits) +- Why customers choose you over alternatives + +### 7. Objections & Anti-Personas +- Top 3 objections heard in sales and how to address them +- Who is NOT a good fit (anti-persona) + +### 8. Switching Dynamics +The JTBD Four Forces: +- **Push**: What frustrations drive them away from current solution +- **Pull**: What attracts them to you +- **Habit**: What keeps them stuck with current approach +- **Anxiety**: What worries them about switching + +### 9. Customer Language +- How customers describe the problem (verbatim) +- How they describe your solution (verbatim) +- Words/phrases to use +- Words/phrases to avoid +- Glossary of product-specific terms + +### 10. Brand Voice +- Tone (professional, casual, playful, etc.) +- Communication style (direct, conversational, technical) +- Brand personality (3-5 adjectives) + +### 11. Proof Points +- Key metrics or results to cite +- Notable customers/logos +- Testimonial snippets +- Main value themes and supporting evidence + +### 12. Goals +- Primary business goal +- Key conversion action (what you want people to do) +- Current metrics (if known) + +--- + +## Step 3: Create the Document + +After gathering information, create `.claude/product-marketing-context.md` with this structure: + +```markdown +# Product Marketing Context + +*Last updated: [date]* + +## Product Overview +**One-liner:** +**What it does:** +**Product category:** +**Product type:** +**Business model:** + +## Target Audience +**Target companies:** +**Decision-makers:** +**Primary use case:** +**Jobs to be done:** +- +**Use cases:** +- + +## Personas +| Persona | Cares about | Challenge | Value we promise | +|---------|-------------|-----------|------------------| +| | | | | + +## Problems & Pain Points +**Core problem:** +**Why alternatives fall short:** +- +**What it costs them:** +**Emotional tension:** + +## Competitive Landscape +**Direct:** [Competitor] — falls short because... +**Secondary:** [Approach] — falls short because... +**Indirect:** [Alternative] — falls short because... + +## Differentiation +**Key differentiators:** +- +**How we do it differently:** +**Why that's better:** +**Why customers choose us:** + +## Objections +| Objection | Response | +|-----------|----------| +| | | + +**Anti-persona:** + +## Switching Dynamics +**Push:** +**Pull:** +**Habit:** +**Anxiety:** + +## Customer Language +**How they describe the problem:** +- "[verbatim]" +**How they describe us:** +- "[verbatim]" +**Words to use:** +**Words to avoid:** +**Glossary:** +| Term | Meaning | +|------|---------| +| | | + +## Brand Voice +**Tone:** +**Style:** +**Personality:** + +## Proof Points +**Metrics:** +**Customers:** +**Testimonials:** +> "[quote]" — [who] +**Value themes:** +| Theme | Proof | +|-------|-------| +| | | + +## Goals +**Business goal:** +**Conversion action:** +**Current metrics:** +``` + +--- + +## Step 4: Confirm and Save + +- Show the completed document +- Ask if anything needs adjustment +- Save to `.claude/product-marketing-context.md` +- Tell them: "Other marketing skills will now use this context automatically. Run `/product-marketing-context` anytime to update it." + +--- + +## Tips + +- **Be specific**: Ask "What's the #1 frustration that brings them to you?" not "What problem do they solve?" +- **Capture exact words**: Customer language beats polished descriptions +- **Ask for examples**: "Can you give me an example?" unlocks better answers +- **Validate as you go**: Summarize each section and confirm before moving on +- **Skip what doesn't apply**: Not every product needs all sections (e.g., Personas for B2C) diff --git a/skills/programmatic-seo/SKILL.md b/skills/programmatic-seo/SKILL.md index 55d0b9f..e174939 100644 --- a/skills/programmatic-seo/SKILL.md +++ b/skills/programmatic-seo/SKILL.md @@ -9,6 +9,9 @@ You are an expert in programmatic SEO—building SEO-optimized pages at scale us ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before designing a programmatic SEO strategy, understand: 1. **Business Context** diff --git a/skills/referral-program/SKILL.md b/skills/referral-program/SKILL.md index f6a1e28..2164036 100644 --- a/skills/referral-program/SKILL.md +++ b/skills/referral-program/SKILL.md @@ -9,6 +9,9 @@ You are an expert in viral growth and referral marketing with access to referral ## Before Starting +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Gather this context (ask if not provided): ### 1. Program Type diff --git a/skills/schema-markup/SKILL.md b/skills/schema-markup/SKILL.md index 715c5a2..d5a1a9d 100644 --- a/skills/schema-markup/SKILL.md +++ b/skills/schema-markup/SKILL.md @@ -9,6 +9,9 @@ You are an expert in structured data and schema markup. Your goal is to implemen ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before implementing schema, understand: 1. **Page Type** diff --git a/skills/seo-audit/SKILL.md b/skills/seo-audit/SKILL.md index dd3ed3c..ba68ce6 100644 --- a/skills/seo-audit/SKILL.md +++ b/skills/seo-audit/SKILL.md @@ -9,6 +9,9 @@ You are an expert in search engine optimization. Your goal is to identify SEO is ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before auditing, understand: 1. **Site Context** diff --git a/skills/signup-flow-cro/SKILL.md b/skills/signup-flow-cro/SKILL.md index 26615e0..66489b2 100644 --- a/skills/signup-flow-cro/SKILL.md +++ b/skills/signup-flow-cro/SKILL.md @@ -9,6 +9,9 @@ You are an expert in optimizing signup and registration flows. Your goal is to r ## Initial Assessment +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Before providing recommendations, understand: 1. **Flow Type** diff --git a/skills/social-content/SKILL.md b/skills/social-content/SKILL.md index 12fa7ef..1f64aa9 100644 --- a/skills/social-content/SKILL.md +++ b/skills/social-content/SKILL.md @@ -9,6 +9,9 @@ You are an expert social media strategist with direct access to a scheduling pla ## Before Creating Content +**Check for product marketing context first:** +If `.claude/product-marketing-context.md` exists, read it before asking questions. Use that context and only ask for information not already covered or specific to this task. + Gather this context (ask if not provided): ### 1. Goals