Install the Product Marketing Skill for Claude Code

Purpose-built for Product Marketing Managers. Run positioning validation, messaging tests, competitive intelligence, pricing research, GTM validation, product launch studies, buyer persona development, and brand tracking directly from your terminal.

One-command install

npx skills add Ask-Ditto/ditto-product-marketing
Choose the right skill: Use this Product Marketing skill for PMM workflows. For general customer research and concept validation, see the Product Research skill.

Quick Install

Manual install (personal - all your projects)

git clone https://github.com/Ask-Ditto/ditto-product-marketing.git
cp -r ditto-product-marketing ~/.claude/skills/

Manual install (project-level - shared with team)

git clone https://github.com/Ask-Ditto/ditto-product-marketing.git
cp -r ditto-product-marketing /path/to/your/project/.claude/skills/

Project-level installation means the skill is committed to version control and shared with your team automatically.

API Key Setup

Get a free Ditto API key (no credit card, no sales call):

curl -sL https://app.askditto.io/scripts/free-tier-auth.sh | bash

Or visit: https://app.askditto.io/docs/free-tier-oauth

Set it as an environment variable:

export DITTO_API_KEY="rk_free_YOUR_KEY_HERE"

Free keys (rk_free_): ~12 shared personas, no custom demographic filters. Paid keys (rk_live_): 300,000+ personas, full demographic filtering, unlimited studies.

What Is in the Skill

The skill package contains five files (867 lines total):

File Lines Purpose
SKILL.md 240 Main skill file - PMM workflow, 8 study types, API essentials, common mistakes, failed attempts
study-templates.md 268 7-question frameworks for all 8 PMM study types
deliverables.md 196 What Claude Code generates from each study type (one study to many outputs)
examples/positioning-validation.md 130 Full 3-phase worked example with public study links
README.md 133 Installation guide and overview

The 8 PMM Study Types

Study Type When to Use Time
Positioning Validation Testing how your positioning lands with target customers ~30 min
Messaging Testing Comparing 3-4 messaging variants to find a winner ~25 min
Competitive Intelligence Understanding how the market perceives you vs competitors ~25 min
Pricing & Packaging Validating willingness-to-pay and feature-tier allocation ~25 min
GTM Validation Validating channel strategy, sales motion, outreach approach ~25 min
Product Launch Pre-launch concept validation or post-launch sentiment ~25 min
Buyer Persona Development Building data-backed personas from scratch ~30 min
Brand Perception Tracking brand health and competitive positioning ~25 min

How It Works

Just ask Claude Code to do PMM research. The skill activates automatically:

"Validate our positioning for [product] against [competitor].
Test with 10 US adults aged 30-50."

"Run a messaging test comparing these three taglines with
10 personas matching our ICP."

"I need a competitive battlecard for [product] vs [competitor].
Run a competitive perception study first."

"Test pricing for our new feature. Van Westendorp style,
10 personas, B2B SaaS buyers."

Or invoke directly:

/ditto-product-marketing "positioning validation for [product]"

Claude Code will:

  1. Research your product, market, and competitors
  2. Design the study with the appropriate question framework
  3. Recruit a demographically filtered panel (10 personas)
  4. Run the study (ask questions, poll for responses)
  5. Complete the study (triggers AI-generated analysis)
  6. Generate PMM deliverables from the results
  7. Provide a shareable link for stakeholders

One Study, Many Deliverables

A single 10-persona, 7-question study (~20 min) produces raw material for multiple PMM deliverables:

Total: ~60 minutes from zero to complete PMM kit. Traditional equivalent: 3-6 weeks, $15-50K in agency fees.

Multi-Segment and Cross-Market Research

Run the same study across multiple groups to compare segments:

Or across markets (Ditto covers 15+ countries):

Worked Example

The skill includes a full 3-phase worked example: CareQuarter, an elder care coordination startup validated entirely through Ditto in ~4 hours.

View the live studies:

Troubleshooting

Skill not activating

Check it's in the right directory:

Verify with: ls ~/.claude/skills/ditto-product-marketing/SKILL.md

You can also invoke manually: /ditto-product-marketing

API key not found

Ensure your key is set: echo $DITTO_API_KEY

If using a .env file, make sure Claude Code can read it.

State filter returning 0 personas

Use 2-letter codes: MI not Michigan, TX not Texas.

Questions failing

Questions must be asked one at a time. Wait for all job_ids to show finished before asking the next question.

This Skill vs Product Research Skill

Product Research Product Marketing
Focus General customer research PMM-specific workflows
Study types Open-ended (design your own) 8 pre-built frameworks
Question design General 7-question framework PMM-specific templates per study type
Deliverables Research insights + share link Battlecards, messaging hierarchies, positioning scorecards, sales enablement
Frameworks General April Dunford, Van Westendorp, StoryBrand
Best for Researchers, founders, analysts Product Marketing Managers
Install npx skills add Ask-Ditto/ditto-product-research-skill npx skills add Ask-Ditto/ditto-product-marketing

Links

Related Guides