User Research Cookiy
cookiy-ai/user-research-skill
End-to-end user research assistant — qualitative and quantitative.
Customer interview synthesis: raw transcripts to themed insights, an opportunity solution tree, and follow-up questions (Teresa Torres continuous discovery).
Install Interview Synthesis
$ npx skills add borghei/Claude-Skills --skill interview-synthesis -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install borghei/Claude-Skills interview-synthesis --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/project-management/discovery/interview-synthesis .claude/skills/interview-synthesis && rm -rf skills-srcUse ~/.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/
Install the "interview-synthesis" agent skill from https://github.com/borghei/Claude-Skills/tree/main/project-management/discovery/interview-synthesis into .claude/skills/interview-synthesis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "interview-synthesis", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/borghei/Claude-Skills/tree/main/project-management/discovery/interview-synthesisType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add borghei/Claude-Skills --skill interview-synthesis -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install borghei/Claude-Skills interview-synthesis --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/project-management/discovery/interview-synthesis .agents/skills/interview-synthesis && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "interview-synthesis" agent skill from https://github.com/borghei/Claude-Skills/tree/main/project-management/discovery/interview-synthesis into .agents/skills/interview-synthesis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "interview-synthesis", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill interview-synthesis -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install borghei/Claude-Skills interview-synthesis --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/project-management/discovery/interview-synthesis .cursor/skills/interview-synthesis && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "interview-synthesis" agent skill from https://github.com/borghei/Claude-Skills/tree/main/project-management/discovery/interview-synthesis into .cursor/skills/interview-synthesis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "interview-synthesis", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/borghei/Claude-Skills.git --path project-management/discovery/interview-synthesis--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add borghei/Claude-Skills --skill interview-synthesis -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install borghei/Claude-Skills interview-synthesis --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/project-management/discovery/interview-synthesis .gemini/skills/interview-synthesis && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "interview-synthesis" agent skill from https://github.com/borghei/Claude-Skills/tree/main/project-management/discovery/interview-synthesis into .gemini/skills/interview-synthesis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "interview-synthesis", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install borghei/Claude-Skills interview-synthesisInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add borghei/Claude-Skills --skill interview-synthesis -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/project-management/discovery/interview-synthesis .github/skills/interview-synthesis && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "interview-synthesis" agent skill from https://github.com/borghei/Claude-Skills/tree/main/project-management/discovery/interview-synthesis into .github/skills/interview-synthesis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "interview-synthesis", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add borghei/Claude-Skills --skill interview-synthesis -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install borghei/Claude-Skills interview-synthesis --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/borghei/Claude-Skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/project-management/discovery/interview-synthesis .opencode/skills/interview-synthesis && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "interview-synthesis" agent skill from https://github.com/borghei/Claude-Skills/tree/main/project-management/discovery/interview-synthesis into .opencode/skills/interview-synthesis/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "interview-synthesis", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
interview-synthesis- GitHub stars
- 874
- Token cost
- ~1.7k tokens
- SKILL.md length
- 669 words
- Files
- 8 (incl. scripts, references, assets)
- Skills in repo
- 364
- Repo updated
- First seen
- Licence
- MIT
At a glance
Customer interview synthesis: raw transcripts to themed insights, an opportunity solution tree, and follow-up questions (Teresa Torres continuous discovery).
- Post-interview synthesis
- SKILL.md covers Overview, Core Capabilities, Clarify First and Quick Start, plus 3 more sections
- Runs Python scripts from its folder; calls python
- Opportunity mapping
What it does
Interview Synthesis is an agent skill from borghei/Claude-Skills. Customer interview synthesis: raw transcripts to themed insights, an opportunity solution tree, and follow-up questions (Teresa Torres continuous discovery). Use for post-interview synthesis, opportunity mapping, and evidence gap analysis.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 11 other files, including scripts, reference files and assets (for example `assets/interview_input_template.json`, `assets/opportunity_tree_template.md` and `examples/wayfinder-8-interview-synthesis.md`).
It sits in Product & Project Management, covering User research. The repository describes itself as: 385 AI skills, 77 expert agents, and 900 stdlib Python tools for every team: engineering, PM, marketing, C-level, compliance, business ops, research, and a LinkedIn toolkit… The licence is MIT.
When your agent uses it
- Post-interview synthesis
- Opportunity mapping
- Evidence gap analysis
Example prompts
- “/interview-synthesis”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit c9a1487. 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
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
python
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
Interview Synthesis loads about 1.7k tokens when it runs, and up to ~9.1k if it reads all its reference files. Until then it costs about 65 tokens; SKILL.md has 669 words of instructions outside code blocks.
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); the scripts in this folder are not scanned.
SKILL.md
The full file from borghei/Claude-Skills at commit c9a1487, republished under its MIT licence (© borghei). 669 words, ~1,694 tokens.
Download SKILL.mdSave it as
.claude/skills/interview-synthesis/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.- name
- interview-synthesis
- description
- Customer interview synthesis: raw transcripts to themed insights, an opportunity solution tree, and follow-up questions (Teresa Torres continuous discovery). Use for post-interview synthesis, opportunity mapping, and evidence gap analysis.
- license
- MIT + Commons Clause
- metadata.version
- 1.0.1
- metadata.author
- borghei
- metadata.category
- project-management
- metadata.domain
- pm-discovery
- metadata.updated
- 2026-06-15
- metadata.python-tools
- interview_synthesizer.py
- metadata.tech-stack
- customer-interviews, opportunity-solution-tree, jobs-to-be-done
Customer Interview Synthesis Expert
Overview
Turn customer interview transcripts into actionable product opportunities. This skill takes raw question-and-answer transcripts and produces three artifacts: (1) themed insight clusters, (2) an opportunity solution tree mapping outcomes to opportunities and candidate solutions, and (3) a prioritized list of follow-up questions to close evidence gaps.
The synthesis approach is grounded in Teresa Torres' Continuous Discovery Habits (opportunity solution trees), Steve Portigal's interview methodology (looking for stories and contradictions), and the Jobs-To-Be-Done synthesis approach popularized by Alan Klement (situation-motivation-outcome decomposition).
Core Capabilities
- Snippet extraction & coding — stories, contradictions, surprises, emotions coded by need/job/pain/gain and evidence strength
- Theme clustering — evidence thresholds (>=3 snippets from >=2 participants) with scannable headlines
- Opportunity solution tree — measurable outcome → customer-side opportunities → candidate solutions, with intact evidence trails
- Follow-up generation — story-prompt questions targeting weak-evidence themes and unmapped assumptions
- Multi-format output — markdown, JSON, mermaid, confluence, notion, linear
When to Use
- Post-interview synthesis -- You have 3-20 interview transcripts and need to extract themes before they become stale.
- Opportunity space mapping -- Building an opportunity solution tree before committing to solutions.
- Discovery sprint readout -- Sharing findings with the product trio (PM, Design, Engineering) and stakeholders.
- Evidence gap analysis -- Identifying which assumptions still lack interview evidence and need targeted follow-ups.
When NOT to Use
- Quantitative survey synthesis -- use a data analysis skill instead.
- Usability test debriefs -- use a UX research-specific workflow.
- Sales call analysis for win/loss -- use
business-growth/skills.
Clarify First
Before synthesizing, confirm these inputs. If any is unknown or vague, ASK — do not assume:
- The transcripts — how many (3-20) and their quality (synthesis is bounded by interview quality; thin input yields thin themes)
- Target outcome — the measurable outcome that becomes the root of the opportunity solution tree
- Evidence threshold — what counts as a theme (default ≥3 snippets from ≥2 participants; raising/lowering it changes which clusters surface)
- Output consumer — markdown / mermaid / Notion / Linear (sets the
--formatand shape of the deliverable)
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Quick Start
python scripts/interview_synthesizer.py --input interviews.json --format markdown --output synthesis.md
python scripts/interview_synthesizer.py --input interviews.json --format mermaid # tree onlyPrepare input per assets/interview_input_template.json (one entry per interview: participant id, role, q/a pairs). See the references for the full framework and flag reference.
Show full SKILL.md (301 more words)Show less
References
Load the reference that matches the task — keep this file lean and pull detail on demand:
- references/synthesis-framework-and-tooling.md — the full 5-step framework (snippet extraction, coding, theme clustering, opportunity solution tree, follow-ups), end-to-end workflow, troubleshooting, success criteria, and the
interview_synthesizer.pyflag reference. Read when doing the synthesis or running the tool. - references/synthesis-methodology-guide.md — full methodology with worked examples bundling Torres, Portigal, and Klement. Read for the deeper "why" and end-to-end playbook.
- references/red-flags.md — concrete bad-vs-good examples of how synthesis output goes wrong and how to fix it. Read before sharing themes, a tree, or a readout.
- assets/interview_input_template.json — JSON schema for interview transcripts.
- assets/opportunity_tree_template.md — editable opportunity solution tree template.
Scope & Limitations
In Scope:
- Qualitative synthesis of 3-20 customer interview transcripts
- Theme clustering with evidence thresholds
- Opportunity solution tree generation (Mermaid + Markdown)
- Follow-up question generation for evidence gaps
- Multi-format output (Markdown, JSON, Mermaid, Confluence, Notion, Linear)
Out of Scope:
- Live interview facilitation -- this skill works on completed transcripts
- Quantitative analysis (survey statistics, click-stream data)
- Sentiment scoring via ML -- the tool uses deterministic keyword and code matching only
- Win/loss analysis -- use
business-growth/skills - Persona generation -- the output is opportunity-centric, not persona-centric
Important Caveats:
- Synthesis quality is bounded by interview quality. Garbage in, garbage out.
- The opportunity solution tree is a thinking aid, not a roadmap. Solutions still need experiment validation.
- Teresa Torres' methodology assumes continuous discovery (weekly touchpoints). One-off interview rounds produce shallower trees.
Integration Points
| Integration | Direction | What Flows |
|---|---|---|
discovery/brainstorm-experiments/ | Feeds into | Validated opportunities become hypotheses for lean experiments |
discovery/identify-assumptions/ | Bidirectional | Assumptions inform follow-up questions; interview evidence resolves assumptions |
discovery/brainstorm-ideas/ | Feeds into | Themed insights seed Product Trio ideation sessions |
discovery/pre-mortem/ | Feeds into | Pain themes surface candidate risks for pre-mortem analysis |
execution/create-prd/ | Feeds into | Top opportunities + supporting evidence populate PRD Background and Market Segments sections |
execution/job-stories/ | Feeds into | Klement-format job codes convert directly into When/Want/So job stories |
© borghei, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 7 other files (scripts, references, assets) in project-management/discovery/interview-synthesis of borghei/Claude-Skills.
- SKILL.md
- assets/interview_input_template.json
- assets/opportunity_tree_template.md
- examples/wayfinder-8-interview-synthesis.md
- references/red-flags.md
- references/synthesis-framework-and-tooling.md
- references/synthesis-methodology-guide.md
- scripts/interview_synthesizer.py
Open the folder on GitHubat commit c9a1487
Compare with similar skills
Interview 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Interview Synthesis this skillborghei/Claude-Skills | 874 | — | ~1.7k | Automated safety check: Pass | MIT | |
| User Research Cookiycookiy-ai/user-research-skill | 1.6k | — | ~954 | Automated safety check: Pass | MIT | |
| Fable DomainSahir619/fable-method | 2.3k | — | ~2.6k | Automated safety check: Pass | MIT | |
| Produck Feedback To Buildtryproduck/produck-skills | 511 | — | ~1k | Automated safety check: Pass | Apache-2.0 | |
| MITRE Problem Framing Canvasdeanpeters/Product-Manager-Skills | 7.2k | 2 repos | ~4.5k | Automated safety check: Pass | Custom licence | |
| Customer InterviewsRefoundAI/lenny-skills | 1.4k | — | ~1.7k | Automated safety check: Pass | MIT |
Similar skills
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…
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.
MITRE Problem Framing Canvas
deanpeters/Product-Manager-Skills
Guides a three-phase canvas, looking inward, looking outward, then reframing, to produce an equity-aware problem statement.
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.
Product Discovery Brief Builder
open-mercato/skills
Guides a product discovery conversation and writes product-brief.md with the problem, evidence, scope, decisions and the next open question, for existing, client or own ideas.
More from borghei/Claude-Skills
All 364 skills in this repoAgents In The Team
borghei/Claude-Skills
Run delivery when AI coding and ops agents take tickets. An agent skill from borghei/Claude-Skills.
AI Content Disclosure
borghei/Claude-Skills
Check AI-generated marketing content and reviews for required disclosures under the EU AI Act, FTC rules and platform AI-label policies.
AI Prototyping
borghei/Claude-Skills
Idea to AI-generated prototype to customer validation to engineering handoff.
Analytics Engineer
borghei/Claude-Skills
Analytics engineering across data modeling, dbt, transformation, and semantic layers.
Ansoff Matrix
borghei/Claude-Skills
Ansoff Matrix — 4-quadrant framework for growth options: market penetration, market/product development, and diversification.
Brainstorm Okrs
borghei/Claude-Skills
OKR brainstorming and validation using the Radical Focus framework — outcome objectives, measurable key results, counter-metrics.
Related
Categories
Questions about Interview Synthesis
What does Interview Synthesis do?
Customer interview synthesis: raw transcripts to themed insights, an opportunity solution tree, and follow-up questions (Teresa Torres continuous discovery). Interview Synthesis is an agent skill from borghei/Claude-Skills. Customer interview synthesis: raw transcripts to themed insights, an opportunity solution tree, and follow-up questions (Teresa Torres continuous discovery).
When should I use Interview Synthesis?
Interview Synthesis fits situations like: post-interview synthesis; opportunity mapping; evidence gap analysis.
How do I install Interview Synthesis in Claude Code?
Run `npx skills add borghei/Claude-Skills --skill interview-synthesis -a claude-code`. Or copy the skill folder (project-management/discovery/interview-synthesis in borghei/Claude-Skills) into .claude/skills/interview-synthesis in your project. Claude Code loads it when a task matches its description.
How do I install Interview Synthesis in Codex?
Run `npx skills add borghei/Claude-Skills --skill interview-synthesis -a codex`. Or copy the skill folder (project-management/discovery/interview-synthesis in borghei/Claude-Skills) into .agents/skills/interview-synthesis in your project. Codex loads it when a task matches its description.
Can I use Interview 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 borghei/Claude-Skills --skill interview-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/interview-synthesis, .gemini/skills/interview-synthesis, .github/skills/interview-synthesis and .opencode/skills/interview-synthesis in your project.
What does Interview Synthesis need to run?
Going by SKILL.md and its folder, Interview Synthesis needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.
Does Interview 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 Interview 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Interview Synthesis use?
Interview Synthesis is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Interview Synthesis use?
About 1.7k tokens (SKILL.md is roughly 6.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.4k tokens, read only when the agent opens those files.
What are the alternatives to Interview Synthesis?
Skills that share tags, products or a category with Interview Synthesis: User Research Cookiy (cookiy-ai/user-research-skill, 1.6k stars), Fable Domain (Sahir619/fable-method, 2.3k stars), Produck Feedback To Build (tryproduck/produck-skills, 511 stars) and MITRE Problem Framing Canvas (deanpeters/Product-Manager-Skills, 7.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Interview Synthesis?
borghei (a GitHub user) maintains it in borghei/Claude-Skills, which has 874 GitHub stars. The repository holds 364 skills in this directory. The repository was last updated on October 7, 2026.
Source: borghei/Claude-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.