user-research-synthesis
Skill2 starsChanged 5 months agoMITView on GitHub
Use after conducting user research and before making product decisions from it. Requires every insight to map to a decision. Blocks "users said X" reports that produce no actionable direction.
14 other projects use a version of this.
Adopted by
Most recently taken up by
- insight68/Skillstheir own version, first seen Nov 8, 2026
- codeApe-7/ai-agent-workflowGrouptheir own version, first seen Nov 1, 2026
- Maudeunfledged834/startup-founder-skillstheir own version, first seen Oct 25, 2026
- MaxMiksa/Autonomous-Companytheir own version, first seen Oct 15, 2026
- akachandan1/proofstacktheir own version, first seen Oct 11, 2026
- MaxMiksa/Auto-Companytheir own version, first seen Oct 2, 2026
Used with
Projects with it also use mvp-scoping, competitive-analysis and 1 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
shawnpangSkillmvp-scoping
When the user needs to decide what to build, cut, and defer for a first release or minimum viable version of a product or feature.
Also in 3 projects that use this
AnthropicSkillcompetitive-analysis
Framework for building competitive landscape decks — market positioning, competitor deep-dives, comparative analysis, strategic synthesis. Use when the user asks for a competitive landscape, competitor analysis, peer comparison, market positioning assessment, strategic review, or investment memo deck. Also triggers on "who are the competitors to X", "benchmark X against peers", "build a market map", or any request to systematically evaluate competitive dynamics across an industry.
Also in 4 projects that use this
silvainfmSkilllaunch-strategy
When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' or 'product update.' This skill covers phased launches, channel strategy, and ongoing launch momentum.
Also in 3 projects that use this
Other versions14 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 14
- MaxMiksa/Auto-Company★ 3.2ksame name
- MaxMiksa/Autonomous-Company★ 3.2ksame name
- shawnpang/startup-founder-skills★ 331same name
- nicepkg/auto-company★ 188same name
- NikitaDmitrieff/auto-co-meta★ 43same name
- aroyburman-codes/pm-skills★ 25same name
- codeApe-7/ai-agent-workflowGroup★ 18same name
- Maudeunfledged834/startup-founder-skills★ 8same name
- insight68/Skills★ 5same name
- Uwayxt/agent-skills★ 4same name
4 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository8 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- ab-test-designSkill
- ai-feature-validationSkill
- feature-scopingSkill
- metric-definitionSkill
- mvp-scope-validatorSkill
- prd-quality-gateSkill
The file
We split this skill into the rules it gives an agent
6 rules. 0 are common, 6 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 14 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 46
Do not include "they seemed to want..." at this stage — that is interpretation
- Distinctive: line 85
Every insight that produces a "we should think about this" response is an insight that will be ignored in the next planning cycle.
- Distinctive: line 89
Before the synthesis document is shared, run the decision audit:
- Distinctive: line 95
If any insight has no corresponding decision, the synthesis is incomplete.
- Distinctive: line 135
When user-research-synthesis is satisfied, state it like this:
- Distinctive: line 154
Every insight must map to a decision.
“Common” is measured: kept by at least 6 in 10 of the 14 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
User Research Synthesis
The Law
RESEARCH THAT DOES NOT PRODUCE A DECISION PRODUCES A DOCUMENT.
"Users said X" without "therefore we will Y" is observation without direction — the team reads the report, nods, and builds what they already planned.
An insight → decision chain, documented and traceable IS research synthesis.When to Use
Trigger after:
- Any user interview, usability test, or survey that informs a product decision
- Any discovery sprint before a new feature is scoped
- Any moment when "what do users want?" is used to justify a direction
When NOT to Use
- Competitive analysis (no user data involved — use a different framework)
- Usage analytics review (quantitative data without qualitative context — different synthesis process)
- Research stored for reference without an active product decision being made
The Synthesis Structure
Raw research is observation. Synthesis is the translation of observation into decision. Every step below must be completed before the synthesis is done.
1 — Observations
What did users actually do, say, or show? Only direct evidence — no interpretation yet.
Observation format:
[User type], [context], [verbatim quote or behaviour]:
"[exact quote]" or "[described behaviour]"Rules:
- Quote directly where possible — paraphrase introduces interpretation
- Include the context (what task were they doing? what were they trying to achieve?)
- Do not include "they seemed to want..." at this stage — that is interpretation
2 — Patterns
Which observations repeat across multiple users? A pattern requires at least 3 independent instances.
Pattern: [Name]
Instances: [User A, User B, User C] — each with reference to observation
Strength: strong (5+ instances) / moderate (3–4) / weak (< 3, noted as signal not pattern)Weak signals (< 3 instances) are noted but not used to drive decisions without supporting quantitative evidence.
3 — Insights
What do these patterns mean? One sentence per insight. Insight = pattern + implication.
Insight format:
[Pattern] suggests that [user population] [belief, expectation, or behaviour], which means [product implication].What does NOT count as an insight:
- "Users want a better experience" — no pattern, no implication
- "Users find X confusing" — observation, not insight (insight: "users find X confusing because they expect Y, which means the mental model mismatch is at [specific step]")
4 — Decisions
Each insight must map to exactly one of:
- Build decision: we will build [X] because [insight]
- Don't build decision: we will not build [Y] because [insight] shows it doesn't solve the underlying problem
- Further research needed: we cannot decide until we understand [specific question]; research method: [proposed method], timeline: [date]
What does NOT count as a decision:
- "We should think about this"
- "This is something to keep in mind"
- "We'll revisit this later"
Every insight that produces a "we should think about this" response is an insight that will be ignored in the next planning cycle.
The Decision Audit
Before the synthesis document is shared, run the decision audit:
- Count the insights. Count the decisions. They must be equal.
- For each decision, confirm it names a specific product action or a specific research question with a date.
- For each "further research needed" decision, confirm a method and timeline are named.
If any insight has no corresponding decision, the synthesis is incomplete.
The Process
Step 1 — Log All Observations
Immediately after each session, log observations in the standard format. Do not paraphrase without a quote to support it.
Step 2 — Identify Patterns
Group observations. Name patterns. Count instances. Mark weak signals.
Step 3 — Write Insights From Patterns
One insight per pattern. Test each insight: does it contain a pattern AND an implication? If not, it is still an observation.
Step 4 — Map Each Insight to a Decision
For every insight, write the decision it produces. Build / don't build / further research (with method + date).
Step 5 — Run the Decision Audit
Insights = decisions. No orphaned insights. No decisions without insights.
Step 6 — Store the Synthesis Document
Store at product/research/<project>-synthesis-<date>.md. This document is the evidence base for every product decision made from this research.
Rationalization Red Flags
These thoughts mean synthesis was not completed — stop:
- "The research speaks for itself" — research requires interpretation; interpretation requires documentation; undocumented interpretation cannot be challenged, revised, or learned from
- "Users want X" — how many users? in what context? doing what task? "users want X" without these is a summary that hides the evidence
- "We'll use this to inform future decisions" — this means the research will not produce a decision; "inform" is the word used when research is filed and forgotten
- "The team heard the sessions, they know the insights" — they know their interpretation of the sessions, which differs per person; the synthesis document is what makes the interpretation shared
- "We don't have time to synthesise, we need to move fast" — you will spend the time anyway, debating "what users really meant" in planning meetings; the synthesis front-loads that cost
Completion Statement Format
When user-research-synthesis is satisfied, state it like this:
Research synthesis complete.
File: product/research/<project>-synthesis-<date>.md ✓
Sessions: <N users, method: interview / usability test / survey>
Observations: <N logged with direct quotes/behaviours> ✓
Patterns: <N patterns — M strong (5+), K moderate (3-4), J weak signals noted>
Insights: <N total>
Decisions produced:
Build: <N decisions — feature/change named for each>
Don't build: <N decisions — with insight reference>
Further research: <N — method and date named for each>
Decision audit: insights (<N>) = decisions (<N>) ✓Every insight must map to a decision. "Informing future work" is not a decision.
Why This Matters
User research without synthesis produces a library of evidence for arguments that have already been decided. Teams that skip synthesis don't skip the decisions — they make them based on the most memorable quote from the sessions, which is usually the most dramatic one, not the most representative one. The synthesis document is what turns 10 hours of sessions into 3 concrete decisions.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

