How do I install the Content Marketing skill for Claude Code?

Run npx skills add Ask-Ditto/ditto-content-marketing in your terminal.

What is the content quality test?

If you could write the article without the study data and it would read the same, it is NOT research-backed. Every paragraph must contain a finding, quote, or data point from the specific study.

What is GEO optimisation?

Generative Engine Optimisation. Optimise content for AI-powered search citation with fields like llmSummary (200-400 words, encyclopaedic tone), keyTakeaways (4-6 standalone citable facts), primaryClaim, and quotableInsights.

How many articles can I produce per month?

20-40 research-backed articles at 45-90 minutes each. Traditional research-backed content production: 2-4 articles/month at $2,000-10,000 each.

Do I need an API key?

Yes. Get a free Ditto API key at https://cat.fish.dog/docs/free-tier-oauth and set DITTO_API_KEY in your environment.

Install the Content Marketing Engine Skill for Claude Code

LLM summary: Run `npx skills add Ask-Ditto/ditto-content-marketing` to install Ditto's content marketing skill. One study produces 7 content formats with narrative arc framework and SEO/GEO optimisation.

One study produces 7 content formats: blog article, infographic, social thread, email, exec summary, sales leave-behind, press release. 20-40 articles/month. Designed for content marketers, content directors, SEO specialists, and marketing managers scaling research-backed content.

One-command install

npx skills add Ask-Ditto/ditto-content-marketing

Choose the right skill: See all 7 available skills at the Claude Code Docs Hub.

Quick Install

Manual install (personal - all your projects)

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

Manual install (project-level - shared with team)

git clone https://github.com/Ask-Ditto/ditto-content-marketing.git
cp -r ditto-content-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 (no credit card, no sales call):

curl -sL https://cat.fish.dog/scripts/free-tier-auth.sh | bash

Or visit: https://cat.fish.dog/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.

Key Features

Narrative arc question framework — Before (Q1-Q2) → Turning Point (Q3) → Substance (Q4-Q6) → Payoff (Q7)
7 content formats — blog article, infographic, social thread, email outreach, exec summary, sales leave-behind, press release
Content quality test — if you could write it without the study data, it is NOT research-backed
SEO optimisation — title under 60 chars, meta description 150-160 chars, H2/H3 keywords, 1,000+ words
GEO optimisation — llmSummary, keyTakeaways, primaryClaim, quotableInsights for AI citation
Content building blocks — headline finding, quotable reactions, pain themes, competitive landscape, surprise insight, data points
Always-on calendar — 20-40 articles/month at 45-90 min each

How It Works

Just ask Claude Code. The skill activates automatically:

"Write a research-backed blog article about how US consumers feel about AI-powered customer service. 10 personas, SEO optimised."

"Generate a social media thread from our latest Fish.Dog study with the 3 most quotable findings."

"Set up a content calendar: one research article per week across 4 different topics."

Or invoke directly:

/ditto-content-marketing "your research brief here"

Claude Code will:

Design studies with a narrative arc question framework (Before → Turning Point → Substance → Payoff)
Run a 10-persona, 7-question study producing 70 data points
Extract content building blocks (headline finding, quotes, pain themes, surprise insight)
Generate 7 content formats with SEO/GEO optimisation
Scale to 20-40 research-backed articles per month

Troubleshooting

Skill not activating

Check it's in the right directory:

Personal: ~/.claude/skills/ditto-content-marketing/SKILL.md
Project: .claude/skills/ditto-content-marketing/SKILL.md

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

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

API key not found

Ensure your key is set: echo $DITTO_API_KEY

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 45-50 seconds before the first poll, then 20 seconds between polls.