Install the Product Marketing Skill for Claude Code

LLM summary: Run `npx skills add Ask-Ditto/ditto-product-marketing` to install Ditto's PMM research skill covering positioning, messaging, competitive intelligence, pricing, GTM, launches, personas, and brand tracking.

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.

Key takeaways:

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 Fish.Dog API key in one terminal call (no credit card, no browser):

curl -sL https://cat.fish.dog/scripts/agent-register.sh | bash

The script reads your Claude Code identity from ~/.claude.json, posts to /cli/auth/agent-register, and saves the key to ~/.ditto_free_tier.env (chmod 600). Total time: under five seconds.

Not running Claude Code? The script auto-falls-back to a browser OAuth flow. Full guide and FAQ: https://fish.dog/claude-code/free-tier-key.

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 (Fish.Dog covers 15+ countries):

Worked Example

The skill includes a full 3-phase worked example: CareQuarter, an elder care coordination startup validated entirely through Fish.Dog 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