How do I install the VoC Programme skill for Claude Code?

Run npx skills add Ask-Ditto/ditto-voc-programme in your terminal.

How much time does a VoC programme take?

About 2 hours per month: one 15-minute pulse check per month, plus a 45-minute deep dive per quarter. Total annual investment: ~24 hours vs $200,000+ for traditional VoC.

What is the language library?

Arguably the most commercially valuable deliverable. Exact customer words and phrases categorised as problem language, solution language, evaluation language, emotional language, and comparison language. Used for SEO, ad copy, sales messaging, and positioning.

Can I track trends over time?

Yes. After 4 quarters of deep dives, you have a longitudinal dataset showing trends in pain intensity, competitive landscape shifts, language evolution, and unmet needs emergence.

Do I need an API key?

Yes. If you're running Claude Code, run curl -sL https://cat.fish.dog/scripts/agent-register.sh | bash for an instant free key. Otherwise use the browser OAuth fallback at https://cat.fish.dog/docs/free-tier-oauth. Full guide: https://fish.dog/claude-code/free-tier-key.

Install the Voice of Customer Programme Skill for Claude Code

LLM summary: Run `npx skills add Ask-Ditto/ditto-voc-programme` to install Ditto's VoC programme skill. Always-on research calendar with monthly pulse checks, quarterly deep dives, and 6 deliverables.

Always-on VoC research: monthly pulse checks (15 min), quarterly deep dives (45 min), 6 deliverables, longitudinal tracking. Designed for CS managers, VoC programme managers, CX/UX researchers, and product managers running continuous feedback loops.

Key takeaways:

Install the skill with npx skills add Ask-Ditto/ditto-voc-programme.
Get a free-tier API key in one terminal call with agent-register.sh; OAuth remains available as fallback.
Use this skill for monthly pulse checks, quarterly deep dives, language libraries, journey maps, and longitudinal VoC tracking.

One-command install

npx skills add Ask-Ditto/ditto-voc-programme

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-voc-programme.git
cp -r ditto-voc-programme ~/.claude/skills/

Manual install (project-level - shared with team)

git clone https://github.com/Ask-Ditto/ditto-voc-programme.git
cp -r ditto-voc-programme /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.

Key Features

Always-on research calendar — monthly pulse (15 min), quarterly deep dive (45 min), ad-hoc probes (25 min)
6 VoC deliverables — customer journey map, pain priority matrix, language library, unmet needs report, decision criteria hierarchy, product feedback synthesis
Language library — the most commercially valuable deliverable: exact customer words categorised for SEO, ad copy, sales messaging
Longitudinal tracking — after 4 quarters, track pain intensity, competitive shifts, language evolution
Cross-segment VoC — identical questions across end users, team leads, leadership
Cross-market VoC — identical studies across USA, UK, Germany, Canada

How It Works

Just ask Claude Code. The skill activates automatically:

"Set up a VoC programme for our SaaS product. Run a quarterly deep dive with 10 US tech professionals."

"Run a monthly pulse check on customer sentiment. 3 questions, 6 personas."

"Build a customer journey map and language library from our latest VoC study."

Or invoke directly:

/ditto-voc-programme "your research brief here"

Claude Code will:

Set up an always-on research calendar (monthly pulse + quarterly deep dive)
Recruit or reuse panels matching your customer base
Run studies with proven VoC question frameworks (7Q deep dive, 3Q pulse)
Extract 6 VoC deliverables (journey map, pain matrix, language library, and more)
Track longitudinal trends across quarters

Troubleshooting

Skill not activating

Check it's in the right directory:

Personal: ~/.claude/skills/ditto-voc-programme/SKILL.md
Project: .claude/skills/ditto-voc-programme/SKILL.md

Verify with: ls ~/.claude/skills/ditto-voc-programme/SKILL.md

You can also invoke manually: /ditto-voc-programme

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.