Agent skill

User Research Synthesis

by shawnpang in shawnpang/startup-founder-skills

When the user has raw customer interview transcripts, survey responses, support tickets, or other qualitative data and needs to extract actionable insights.

MITAuto-check passedProduct & Project Management

Install User Research Synthesis

skills CLI
$ npx skills add shawnpang/startup-founder-skills --skill user-research-synthesis -a claude-code

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

GitHub CLI
$ gh skill install shawnpang/startup-founder-skills user-research-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/shawnpang/startup-founder-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/user-research-synthesis .claude/skills/user-research-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
user-research-synthesis
GitHub stars
343
Token cost
~2k tokens
SKILL.md length
1,017 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

When the user has raw customer interview transcripts, survey responses, support tickets, or other qualitative data and needs to extract actionable insights.

  • Works in 8 steps: Read the complete transcript -- Before… → Capture metadata -- Record interview… → Identify current solutions -- Document… → …
  • Has raw customer interview transcripts
  • SKILL.md covers When to Use, Context Required, Workflow and Output Format, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

User Research Synthesis is an agent skill from shawnpang/startup-founder-skills. When the user has raw customer interview transcripts, survey responses, support tickets, or other qualitative data and needs to extract actionable insights.

Its SKILL.md is about 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 Product & Project Management, covering User research and Customer support. The repository describes itself as: AI agent skills for tech startup founders — fundraising, sales, product, recruiting, engineering, legal, ops, and growth. Works with Claude Code, Cursor, Codex, and any Agent… The licence is MIT.

When your agent uses it

  • Has raw customer interview transcripts
  • Survey responses
  • Support tickets
  • Other qualitative data and needs to extract actionable insights

Example prompts

  • “/user-research-synthesis”

Workflow steps

8 steps, taken from the first numbered list in SKILL.md.

  1. Read the complete transcript -- Before summarizing, read the entire transcript or data source end-to-end. Do not begin summarizing until…
  2. Capture metadata -- Record interview date, participants, participant background, and context for the conversation.
  3. Identify current solutions -- Document what solutions the participant currently uses and their satisfaction level with each. This reveals…
  4. Extract problems and pain points -- Catalog every problem mentioned, using the participant's own language. Separate symptoms from root…
  5. Apply Jobs to Be Done framing -- For each major finding, frame it as a JTBD: "When [situation], I want to [motivation], so I can [expected…
  6. Flag unexpected discoveries -- Note any surprising insights, contradictions, or findings that challenge existing assumptions. These often…
  7. Define follow-up actions -- List specific next steps with ownership: who should do what based on these findings.
  8. Assess confidence levels -- Rate each insight as high/medium/low confidence based on data volume and consistency across sources.

What it can do on your machine

Read from SKILL.md and the folder at commit 4ad31b4. 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

    No URLs in SKILL.md.

    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

User Research Synthesis loads about 2k tokens when it runs. Until then it costs about 45 tokens; SKILL.md has 1,017 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~45
When it runs · the whole SKILL.md, loaded when a task matches
~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 shawnpang/startup-founder-skills at commit 4ad31b4, republished under its MIT licence (© shawnpang). 1,017 words, ~1,953 tokens.

Download SKILL.mdSave it as .claude/skills/user-research-synthesis/SKILL.md (or your agent's skills folder).
name
user-research-synthesis
description
When the user has raw customer interview transcripts, survey responses, support tickets, or other qualitative data and needs to extract actionable insights.
related
prd-writing, competitive-analysis
reads
startup-context

User Research Synthesis

When to Use

Activate when a founder or PM provides raw qualitative research data and needs it synthesized into structured insights. This includes customer interview transcripts, survey open-ended responses, support ticket logs, NPS verbatims, sales call notes, app store reviews, or community forum posts. Trigger phrases include "summarize these interviews," "what are customers telling us," "synthesize this feedback," or "help me analyze these customer conversations."

Context Required

  • From startup-context: product stage, current customer segments, known hypotheses being tested, existing personas (if any).
  • From the user: the raw data sources (transcripts, notes, recordings), research questions being investigated, participant background information, any specific hypotheses to validate or invalidate.

Workflow

  1. Read the complete transcript -- Before summarizing, read the entire transcript or data source end-to-end. Do not begin summarizing until you have processed all material. This prevents recency bias and ensures nothing is missed.
  2. Capture metadata -- Record interview date, participants, participant background, and context for the conversation.
  3. Identify current solutions -- Document what solutions the participant currently uses and their satisfaction level with each. This reveals the competitive landscape from the user's perspective.
  4. Extract problems and pain points -- Catalog every problem mentioned, using the participant's own language. Separate symptoms from root causes.
  5. Apply Jobs to Be Done framing -- For each major finding, frame it as a JTBD: "When [situation], I want to [motivation], so I can [expected outcome]." This shifts focus from features to outcomes.
  6. Flag unexpected discoveries -- Note any surprising insights, contradictions, or findings that challenge existing assumptions. These often hold the most strategic value.
  7. Define follow-up actions -- List specific next steps with ownership: who should do what based on these findings.
  8. Assess confidence levels -- Rate each insight as high/medium/low confidence based on data volume and consistency across sources.

Output Format

Interview Summary (per transcript)

For each individual transcript or data source:

  • Metadata: Date, participant name/role, participant background
  • Current solutions: What they use today and satisfaction level
  • What they like: Positive signals about current product or workflow
  • Problems identified: Pain points in their own words, with direct quotes
  • Key discoveries: Unexpected findings or insights that challenge assumptions
  • Follow-up actions: Specific next steps with suggested ownership
Cross-Interview Synthesis (when multiple sources provided)
Jobs to Be Done Map
Job StatementFrequencySegmentsConfidence
When [situation], I want to [motivation], so I can [outcome]X of N sourcesSegment namesHigh/Med/Low
Actionable Insights

Numbered list of insight statements using the format: "We learned that [finding] which means [implication] so we should [recommendation]."

Open Questions

What the data did NOT answer and recommended next research steps.

Frameworks & Best Practices

  • Jobs to Be Done (JTBD). Frame every finding as a job the customer is trying to accomplish, not a feature they want. Customers hire products to make progress in their lives.
  • Read before you summarize. Always process the complete transcript before writing any summary. Partial reads produce biased synthesis.
  • Plain language over jargon. Write summaries that are accessible to anyone on the team, including non-technical stakeholders. Avoid PM jargon unless the team uses it consistently.
  • Preserve direct quotes. The most powerful data points are verbatim quotes that capture the participant's emotion, specificity, and language. "I spent 3 hours last Tuesday rebuilding the report" beats "reporting is hard."
  • Separate satisfaction from problems. Explicitly track what users like about current solutions alongside what frustrates them. Knowing strengths prevents accidentally breaking them.
  • Current solutions reveal competitors. Documenting what participants use today (including spreadsheets, manual processes, and workarounds) reveals the true competitive landscape, which is broader than direct product competitors.
  • Frequency is not importance. A pain point mentioned by 2 of 10 users may be more critical than one mentioned by 8 if those 2 users represent your ideal customer profile.
  • Bias awareness. Note recruitment bias (who was NOT interviewed), leading question bias (review the interview script), and survivorship bias (current users vs. churned users).
  • Minimum viable sample. For qualitative research, 5-8 interviews per segment typically reach thematic saturation. Flag if the sample is below this threshold.
  • Triangulation. Cross-reference findings across data types. An insight supported by interviews AND support tickets AND survey data is stronger than one source alone.
  • Continuous discovery. Treat interview synthesis as an ongoing practice, not a one-time project. Regular weekly interviews compound into deep customer understanding over time.
Show full SKILL.md (306 more words)Show less
  • prd-writing -- Chain research synthesis directly into the Background and Market Segments sections of a PRD.
  • competitive-analysis -- Combine customer insights with competitive data to identify underserved jobs where competitors fall short.
  • feedback-synthesis -- Chain when you have a mix of structured feedback data (tickets, NPS) alongside interview transcripts.

Examples

Example 1: Single interview summary

User: "Here's a transcript from our discovery interview with a logistics manager. Summarize it."

Good output excerpt:

Metadata: March 10, 2026 | Sarah Chen, Logistics Manager at MidCo (150 employees)

Current solutions: Uses a combination of Excel spreadsheets and email chains to coordinate shipments. Satisfaction: 3/10. "It works but I lose about 5 hours a week just keeping everything in sync."

Problems identified:

  • No single source of truth for shipment status (mentioned 4 times)
  • Cannot see driver availability in real time; relies on phone calls
  • Reporting to management requires manual data compilation every Friday

Key discovery: Sarah's team has built an informal Slack channel as a workaround for real-time updates. This was not anticipated in our research plan and suggests messaging integration may be higher priority than dashboard features.

Example 2: Multi-interview synthesis

User: "I just finished 8 customer interviews for our B2B scheduling tool. Here are the transcripts. What are the key takeaways?"

Good output excerpt:

JTBD #1 (7/8 interviews, High confidence): "When I'm coordinating meetings across 3+ time zones, I want to see everyone's availability in one view, so I can book a slot without 6 back-and-forth emails."

Insight: We learned that multi-timezone scheduling is the primary job, not calendar management broadly. This means our positioning should lead with "global team coordination" rather than "smart calendar." We should prioritize the timezone overlay feature in the next sprint.

Open question: None of the 8 participants were solo users. We still do not know whether the product has value for individuals without teams.

© shawnpang, 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/user-research-synthesis of shawnpang/startup-founder-skills.

Open the folder on GitHubat commit 4ad31b4

Compare with similar skills

User Research 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.

User Research Synthesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
User Research Synthesis this skillshawnpang/startup-founder-skills343—~2kAutomated safety check: PassMIT
Pm Synthesize Researchevolution-foundation/evo-nexus545—~4.3kAutomated safety check: PassCustom licence
Research Decision Roomnexu-io/open-design100k—~1.6kAutomated safety check: PassApache-2.0
User Research Cookiycookiy-ai/user-research-skill1.6k—~954Automated safety check: PassMIT
Fable DomainSahir619/fable-method2.3k—~2.6kAutomated safety check: PassMIT
Produck Feedback To Buildtryproduck/produck-skills511—~1kAutomated safety check: PassApache-2.0

Similar skills

  • Pm Synthesize Research

    evolution-foundation/evo-nexus

    Synthesize user research from interviews, surveys, and feedback into structured insights.

    545 GitHub stars~4.3k tokensUpdated 5 mo ago
    Product & Project ManagementAuto-check passed
  • Research Decision Room

    nexu-io/open-design

    Turn messy user research notes, interviews, support tickets, surveys, and product context into an evidence-backed decision room: a single HTML artifact with an evidence ledger, theme map, confidence…

    100k GitHub stars~1.6k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • User Research Cookiy

    cookiy-ai/user-research-skill

    End-to-end user research assistant — qualitative and quantitative.

    1.6k GitHub stars~954 tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Fable Domain

    Sahir619/fable-method

    Discuss a domain with the user, research it from real sources, then generate a trusted skill bundle for it - a step-by-step workflow with a flowchart, a domain adapter, a trap fixture, and a smoke…

    2.3k GitHub stars~2.6k tokensUpdated 8 days ago
    Product & Project ManagementAuto-check passed
  • Produck Feedback To Build

    tryproduck/produck-skills

    Pulls full in-context user feedback tickets through the Produck MCP server and turns them into an aligned product change instead of a guess.

    511 GitHub stars~1k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Customer Interviews

    RefoundAI/lenny-skills

    Help users conduct high-impact customer interviews that move beyond surface-level feature requests to identify root emotional frustrations and specific causal triggers.

    1.4k GitHub stars~1.7k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed

More from shawnpang/startup-founder-skills

All 50 skills in this repo
  • Accelerator Application

    shawnpang/startup-founder-skills

    When the user wants to apply to startup accelerators, incubators, or fellowship programs.

    343 GitHub stars~2.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Architecture Design

    shawnpang/startup-founder-skills

    When the user needs to design or evaluate system architecture — service boundaries, data models, API contracts, infrastructure topology, database selection, or dependency analysis.

    343 GitHub stars~2.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Board Update

    shawnpang/startup-founder-skills

    When the user needs to write a monthly or quarterly investor update, prepare a board deck, or communicate company progress to stakeholders.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Churn Analysis

    shawnpang/startup-founder-skills

    When the user needs to identify at-risk accounts, understand why customers are leaving, reduce churn rate, build health scores, design save plays, or create win-back campaigns.

    343 GitHub stars~2.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Cicd Setup

    shawnpang/startup-founder-skills

    When the user needs to set up or improve CI/CD pipelines — GitHub Actions, GitLab CI, deployment automation, or says "set up CI", "automate deployment", "add tests to pipeline", "fix my build".

    343 GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Code Review

    shawnpang/startup-founder-skills

    When the user asks for a code review, shares code for feedback, or says "review this", "check my code", "what's wrong with this".

    343 GitHub stars~1.9k tokensUpdated 6 mo ago
    Auto-check passed

Questions about User Research Synthesis

What does User Research Synthesis do?

When the user has raw customer interview transcripts, survey responses, support tickets, or other qualitative data and needs to extract actionable insights. User Research Synthesis is an agent skill from shawnpang/startup-founder-skills. When the user has raw customer interview transcripts, survey responses, support tickets, or other qualitative data and needs to extract actionable insights.

When should I use User Research Synthesis?

User Research Synthesis fits situations like: has raw customer interview transcripts; survey responses; support tickets; other qualitative data and needs to extract actionable insights.

How do I install User Research Synthesis in Claude Code?

Run `npx skills add shawnpang/startup-founder-skills --skill user-research-synthesis -a claude-code`. Or copy the skill folder (skills/user-research-synthesis in shawnpang/startup-founder-skills) into .claude/skills/user-research-synthesis in your project. Claude Code loads it when a task matches its description.

How do I install User Research Synthesis in Codex?

Run `npx skills add shawnpang/startup-founder-skills --skill user-research-synthesis -a codex`. Or copy the skill folder (skills/user-research-synthesis in shawnpang/startup-founder-skills) into .agents/skills/user-research-synthesis in your project. Codex loads it when a task matches its description.

Can I use User Research 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 shawnpang/startup-founder-skills --skill user-research-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/user-research-synthesis, .gemini/skills/user-research-synthesis, .github/skills/user-research-synthesis and .opencode/skills/user-research-synthesis in your project.

What does User Research Synthesis need to run?

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

Does User Research Synthesis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is User Research 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 User Research Synthesis use?

User Research 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 User Research Synthesis use?

About 2k tokens (SKILL.md is roughly 7.8k 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 User Research Synthesis?

Skills that share tags, products or a category with User Research Synthesis: Pm Synthesize Research (evolution-foundation/evo-nexus, 545 stars), Research Decision Room (nexu-io/open-design, 100k stars), User Research Cookiy (cookiy-ai/user-research-skill, 1.6k stars) and Fable Domain (Sahir619/fable-method, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains User Research Synthesis?

shawnpang (a GitHub user) maintains it in shawnpang/startup-founder-skills, which has 343 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on March 16, 2026.

Source: shawnpang/startup-founder-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.