Agent skill

Voice Of Customer Synthesis

by growthack88 in growthack88/growth-marketing-os

Turn customer notes, call transcripts, sales feedback, and research into PMM-ready voice-of-customer inputs: pains, triggers, status quo, JTBD, exact language, objections, proof, and messaging…

MITAuto-check passedMarketing & SEO

Install Voice Of Customer Synthesis

skills CLI
$ npx skills add growthack88/growth-marketing-os --skill voice-of-customer-synthesis -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install growthack88/growth-marketing-os voice-of-customer-synthesis --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/growthack88/growth-marketing-os.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/community/voice-of-customer-synthesis .claude/skills/voice-of-customer-synthesis && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
voice-of-customer-synthesis
GitHub stars
116
Token cost
~2.2k tokens
SKILL.md length
1,154 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Turn customer notes, call transcripts, sales feedback, and research into PMM-ready voice-of-customer inputs: pains, triggers, status quo, JTBD, exact language, objections, proof, and messaging…

  • Works in 9 steps: Separate customer truth from PMM… → Identify the audience and buying roles → Extract the problem before the product → …
  • Tasks that involve Market research
  • SKILL.md covers When to use, Inputs, Workflow and Output format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Voice Of Customer Synthesis is an agent skill from growthack88/growth-marketing-os. Turn customer notes, call transcripts, sales feedback, and research into PMM-ready voice-of-customer inputs: pains, triggers, status quo, JTBD, exact language, objections, proof, and messaging implications.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Market research, User stories and Meeting notes and agendas. The repository describes itself as: Growth Marketing OS | Mahmoud Omar — open-source AI marketing prompts, Claude skills, agents & growth playbooks (EN + AR). The licence is MIT.

When your agent uses it

  • Tasks that involve Market research
  • Tasks that involve User stories
  • Tasks that involve Meeting notes and agendas

Example prompts

  • “/voice-of-customer-synthesis”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Separate customer truth from PMM interpretation
  2. Identify the audience and buying roles
  3. Extract the problem before the product
  4. Name the status quo
  5. Capture the buyer trigger
  6. Translate into Jobs To Be Done
  7. Pull exact language
  8. Identify objections and proof requirements
  9. Synthesize messaging implications

What it can do on your machine

Read from SKILL.md and the folder at commit c6b55c7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Voice Of Customer Synthesis loads about 2.2k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 1,154 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from growthack88/growth-marketing-os at commit c6b55c7, republished under its MIT licence (© growthack88). 1,154 words, ~2,231 tokens.

Download SKILL.mdSave it as .claude/skills/voice-of-customer-synthesis/SKILL.md (or your agent's skills folder).
name
voice-of-customer-synthesis
description
Turn customer notes, call transcripts, sales feedback, and research into PMM-ready voice-of-customer inputs: pains, triggers, status quo, JTBD, exact language, objections, proof, and messaging implications.
<!--
COMMUNITY SKILL — included under its original MIT license.
Source: https://github.com/adam-lagerhausen/b2b-marketing-skills by Adam Lagerhausen (MIT).
License text: ../LICENSE-b2b-marketing-skills.txt
Curated into Growth Marketing OS by Mahmoud Omar (mahmoudomar.com) — this file
is NOT original work by the repo author; see /skills/community/README.md.
-->

Voice of Customer Synthesis

When to use

Use this skill when you have raw customer input and need to turn it into useful product marketing judgment.

Good inputs include:

  • Customer interview notes
  • Sales call transcripts
  • Win/loss notes
  • Support tickets or community threads
  • Customer advisory board notes
  • Gong/Zoom summaries
  • Survey verbatims
  • Founder or sales-team anecdotes that need structure

Use it before positioning, messaging, launch planning, customer stories, sales narratives, website copy, or enablement. Voice of customer is the currency for PMM. Without it you have opinion. With it you can say, "I talked to 10 customers and here's what they said."

Inputs

Ask for or infer the following:

  • Product or company context
  • Target audience or segment
  • Buyer, decision-maker, user, and influencer if known
  • Raw customer notes, transcript excerpts, survey responses, sales notes, or research
  • Business model, ACV, market, or GTM motion if relevant
  • The desired downstream use: positioning, messaging, launch, sales enablement, customer story, or research synthesis

If the input is thin, still synthesize it, but label conclusions by confidence:

  • High confidence: directly supported by multiple customer statements
  • Medium confidence: supported by one clear statement or repeated pattern in weaker notes
  • Low confidence: plausible inference that needs validation

Workflow

1. Separate customer truth from PMM interpretation

Do not blend quotes, facts, and strategy into one mush.

For each finding, distinguish:

  • What the customer actually said
  • What behavior or business reality it points to
  • What PMM should infer from it
  • What still needs validation
2. Identify the audience and buying roles

Clarify who is speaking and who matters in the deal.

Look for:

  • End user pain
  • Decision-maker pain
  • Economic buyer concerns
  • Admin or implementation concerns
  • Champion language
  • Procurement, security, IT, finance, or legal blockers

Do not assume the loudest user is the buyer. Do not assume the buyer is the daily user.

3. Extract the problem before the product

Start with fundamentals:

  • Who is the target audience?
  • What problem do they have?
  • How do they solve it today?
  • Why is the current way painful, risky, slow, expensive, or incomplete?
  • What event makes the problem urgent now?
  • How does the product solve it better?
  • What value is created?
  • How should GTM let the market know?

Do not jump straight to features.

4. Name the status quo

The real competition is often not another vendor. It is the make-do process customers already tolerate.

Look for current alternatives such as:

  • Spreadsheets
  • Email threads
  • Manual handoffs
  • Meetings
  • Internal tools
  • Consultants or agencies
  • Doing nothing
  • Waiting until the pain becomes urgent
  • A partial tool used outside its intended job

Explain why the status quo persists. Common reasons: no owner, low urgency, switching cost, habit, budget timing, fear of implementation, or the pain is invisible until something breaks.

5. Capture the buyer trigger

Find the specific event that made the customer act.

Use this pattern:

  • Situation: the old make-do process
  • Trigger: the specific event that made them act
  • Solution: how the product made the job better
  • Result: the tangible outcome

Triggers can be reactive or proactive.

Reactive buyer moments:

  • A failure, missed deadline, customer escalation, audit, outage, lost deal, cost spike, compliance issue, or executive complaint

Proactive buyer moments:

  • New team, new market, new regulation, growth target, platform change, strategic initiative, budget cycle, or leadership mandate
6. Translate into Jobs To Be Done

Write jobs in plain buyer language.

Format:

  • When [situation/trigger], I need to [job], so I can [desired outcome].

Separate:

  • Functional job: the task they need done
  • Emotional job: the anxiety, confidence, control, or peace of mind they seek
  • Social job: how they need to be perceived by leadership, peers, customers, or their team
7. Pull exact language

Capture short, useful phrases customers actually used.

Prioritize language that is:

  • Specific
  • Emotional
  • Repeated
  • Plain-English
  • A better alternative to internal jargon
  • Close to how a buyer would describe the problem to a peer

Never polish a customer quote until it becomes generic marketing copy. Preserve the edge.

Show full SKILL.md (505 more words)Show less
8. Identify objections and proof requirements

Extract what could stop the deal or weaken belief.

Look for objections around:

  • Cost or budget
  • Urgency
  • Implementation effort
  • Trust, risk, security, or compliance
  • Integration fit
  • Data quality
  • Change management
  • Executive buy-in
  • Whether the pain is big enough to solve now

Map each objection to the proof needed:

  • Customer proof
  • Quantified outcome
  • Demo moment
  • Technical validation
  • Security documentation
  • ROI model
  • Before/after workflow
  • Executive narrative
9. Synthesize messaging implications

Turn the patterns into PMM direction.

Cover:

  • Primary message
  • Secondary messages
  • What to stop saying
  • What to say instead
  • Best-fit audience
  • Segment or persona nuance
  • Proof points to gather
  • Sales discovery questions
  • Content or campaign angles
  • Risks if the team overclaims

Messaging should come from customer reality, not clever copy.

Output format

Return a structured synthesis with these sections:

  1. Executive summary

    • 3-5 bullets on the strongest customer truths
  2. Audience and buying roles

    • User
    • Decision-maker
    • Economic buyer
    • Champion
    • Blockers or influencers
    • Confidence level
  3. Pains

    • Pain
    • Evidence from notes
    • Business impact
    • Confidence
  4. Triggers

    • Situation
    • Trigger
    • Reactive or proactive
    • Why now
    • Evidence
  5. Current workaround / status quo

    • What they do today
    • Why it persists
    • Where it breaks
    • Real competition
  6. Jobs To Be Done

    • Functional job
    • Emotional job
    • Social job
    • JTBD statement
  7. Exact customer language

    • Quote or phrase
    • Who said it, if known
    • Why it matters
    • Potential use in messaging or sales
  8. Objections and risks

    • Objection
    • Who holds it
    • Why it matters
    • Proof needed
  9. Proof and outcomes

    • Stated result
    • Quantified proof, if available
    • Anecdotal proof
    • Proof gaps
  10. Messaging implications

  • Recommended message
  • What to avoid
  • Sales discovery questions
  • Content, launch, or enablement angles
  • Follow-up research needed
  1. Unknowns and validation plan
  • Unknown
  • Why it matters
  • How to validate it

Quality bar

A strong synthesis:

  • Uses customer evidence, not PMM opinion, as the starting point
  • Names the status quo clearly
  • Distinguishes decision-maker pain from user pain
  • Identifies the moment that made the customer act
  • Shows whether the buyer is reactive or proactive
  • Pulls exact language that sounds like a real person
  • States what is known, inferred, and unknown
  • Connects pains to business impact
  • Connects objections to proof requirements
  • Produces messaging implications a sales or marketing team could use immediately
  • Avoids inventing claims, outcomes, or market patterns not supported by the input

Anti-patterns

Avoid:

  • Writing generic SaaS messaging from thin evidence
  • Treating every feature mention as a customer pain
  • Ignoring the current workaround
  • Assuming the competitor is only another vendor
  • Confusing user enthusiasm with budget authority
  • Turning quotes into sanitized marketing language
  • Claiming ROI, savings, or business impact not present in the notes
  • Averaging all personas into one vague buyer
  • Hiding uncertainty
  • Producing a summary that is interesting but not actionable for GTM
  • positioning-messaging-framework: Use after this synthesis to define positioning, messaging pillars, and reasons to believe.
  • sales-narrative-deck: Use after positioning to turn customer truth into a first-call sales story.
  • customer-story-engine: Planned future skill for turning strong before/after stories into reusable proof assets.
  • launch-tier-framework: Planned future skill for using audience, narrative, and GTM priority to size launches.

© growthack88, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/community/voice-of-customer-synthesis of growthack88/growth-marketing-os.

Open the folder on GitHubat commit c6b55c7

Compare with similar skills

Voice Of Customer Synthesis next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Voice Of Customer Synthesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Voice Of Customer Synthesis this skillgrowthack88/growth-marketing-os116—~2.2kAutomated safety check: PassMIT
Customer ResearchNexus-JPF/note-companion8706 repos~3.2kAutomated safety check: PassMIT
Customer Researchunifapi-agent/agents589—~2.1kAutomated safety check: PassMIT
51 Audience Research Globalminhnv0807/ai-business-skills609—~2.8kAutomated safety check: PassMIT
Market Research Digestamplitude/builder-skills159—~853Automated safety check: PassNone
Voice Of Customer Programmohitagw15856/pm-claude-skills1.4k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Customer Research

    Nexus-JPF/note-companion

    When the user wants to conduct, analyze, or synthesize customer research.

    870 GitHub starsUsed in 6 repos~3.2k tokens
    Marketing & SEOAuto-check passed
  • Customer Research

    unifapi-agent/agents

    When the user wants to research customers from public communities, or synthesize customer language, pains, and objections.

    589 GitHub stars~2.1k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • 51 Audience Research Global

    minhnv0807/ai-business-skills

    A skill your agent uses when paid ad AUDIENCES must be researched and defined before launch — target profile, interest and behavior mapping per platform, audience sizing, cold, warm, and hot…

    609 GitHub stars~2.8k tokensUpdated 29 days ago
    Marketing & SEOAuto-check passed
  • Market Research Digest

    amplitude/builder-skills

    Synthesize Drive files, Granola meeting notes, and web signals into a weekly Markdown research summary with Trends, Competitors, Ideas, and Risks sections.

    159 GitHub stars~853 tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed
  • Voice Of Customer Program

    mohitagw15856/pm-claude-skills

    Stand up a Voice of Customer (VoC) program that turns feedback into action.

    1.4k GitHub stars~1.1k tokensUpdated 2 days ago
    Sales & SupportAuto-check passed
  • Creative Director

    smixs/creative-director-skill

    AI creative director with recursive self-assessment. An agent skill from smixs/creative-director-skill.

    247 GitHub stars~5.1k tokensUpdated 2 mo ago
    Marketing & SEOAuto-check passed

More from growthack88/growth-marketing-os

All 14 skills in this repo
  • Experiment Coach

    growthack88/growth-marketing-os

    Experiment Coach — validates ideas before launch and runs growth experiments after it, from inside the chat.

    116 GitHub stars~2.8k tokensUpdated yesterday
    Auto-check passed
  • Mena Ads

    growthack88/growth-marketing-os

    MENA Ads Command Center — a complete paid-ads operating system for the Arab world (Egypt, KSA, UAE, GCC, Levant, North Africa) and global accounts.

    116 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Arabic Copy Localizer

    growthack88/growth-marketing-os

    Marketing copy localization skill that converts English marketing copy (ads, landing pages, emails, CTAs) into native Egyptian Arabic عامية — or GCC dialect on request — with natural English…

    116 GitHub stars~1k tokensUpdated yesterday
    Auto-check passed
  • Benchmark Analyst

    growthack88/growth-marketing-os

    Marketing benchmark triage skill. An agent skill from growthack88/growth-marketing-os.

    116 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Cod Operations Analyst

    growthack88/growth-marketing-os

    COD (cash-on-delivery) e-commerce operations skill. An agent skill from growthack88/growth-marketing-os.

    116 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Conversion Copywriter

    growthack88/growth-marketing-os

    Direct-response copywriting skill. An agent skill from growthack88/growth-marketing-os.

    116 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Voice Of Customer Synthesis

What does Voice Of Customer Synthesis do?

Turn customer notes, call transcripts, sales feedback, and research into PMM-ready voice-of-customer inputs: pains, triggers, status quo, JTBD, exact language, objections, proof, and messaging…. Voice Of Customer Synthesis is an agent skill from growthack88/growth-marketing-os. Turn customer notes, call transcripts, sales feedback, and research into PMM-ready voice-of-customer inputs: pains, triggers, status quo, JTBD, exact language, objections, proof, and messaging implications.

When should I use Voice Of Customer Synthesis?

Voice Of Customer Synthesis fits situations like: tasks that involve Market research; tasks that involve User stories; tasks that involve Meeting notes and agendas.

How do I install Voice Of Customer Synthesis in Claude Code?

Run `npx skills add growthack88/growth-marketing-os --skill voice-of-customer-synthesis -a claude-code`. Or copy the skill folder (skills/community/voice-of-customer-synthesis in growthack88/growth-marketing-os) into .claude/skills/voice-of-customer-synthesis in your project. Claude Code loads it when a task matches its description.

How do I install Voice Of Customer Synthesis in Codex?

Run `npx skills add growthack88/growth-marketing-os --skill voice-of-customer-synthesis -a codex`. Or copy the skill folder (skills/community/voice-of-customer-synthesis in growthack88/growth-marketing-os) into .agents/skills/voice-of-customer-synthesis in your project. Codex loads it when a task matches its description.

Can I use Voice Of Customer Synthesis in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add growthack88/growth-marketing-os --skill voice-of-customer-synthesis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/voice-of-customer-synthesis, .gemini/skills/voice-of-customer-synthesis, .github/skills/voice-of-customer-synthesis and .opencode/skills/voice-of-customer-synthesis in your project.

What does Voice Of Customer Synthesis need to run?

SKILL.md names no scripts, command-line tools or credentials: Voice Of Customer Synthesis is instructions for the agent only.

Does Voice Of Customer Synthesis access the network?

SKILL.md names 1 domain. As links in the text: github.com. This is read from the text; nothing was executed.

Is Voice Of Customer Synthesis safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Voice Of Customer Synthesis use?

Voice Of Customer Synthesis is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Voice Of Customer Synthesis use?

About 2.2k tokens (SKILL.md is roughly 8.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Voice Of Customer Synthesis?

Skills that share tags, products or a category with Voice Of Customer Synthesis: Customer Research (Nexus-JPF/note-companion, 870 stars), Customer Research (unifapi-agent/agents, 589 stars), 51 Audience Research Global (minhnv0807/ai-business-skills, 609 stars) and Market Research Digest (amplitude/builder-skills, 159 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Voice Of Customer Synthesis?

growthack88 (a GitHub user) maintains it in growthack88/growth-marketing-os, which has 116 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 2, 2026.

Source: growthack88/growth-marketing-os on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.