From grimoire
Converts raw user research session notes into structured, actionable insight statements using affinity mapping and thematic analysis.
How this skill is triggered — by the user, by Claude, or both
Slash command
/grimoire:write-research-synthesisThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Convert raw session notes into a structured insight set by grouping atomic observations into themes, then distilling themes into declarative insight statements that the team can act on.
Convert raw session notes into a structured insight set by grouping atomic observations into themes, then distilling themes into declarative insight statements that the team can act on.
Adopted by: IDEO's Design Thinking process treats synthesis as a mandatory phase between fieldwork and ideation; NNG's research training certifies affinity diagramming as the standard qualitative analysis method; Dovetail, Airtable, and Notion have each built dedicated research repository products around structured synthesis workflows, reflecting widespread adoption in product teams Impact: Unstructured synthesis — reviewing notes and writing a summary — produces conclusions dominated by recency bias (last session) and confirmation bias (findings that match existing hypotheses); structured affinity mapping surfaces patterns across all sessions with equal weight; NNG documents that teams using structured synthesis report significantly higher stakeholder confidence in research findings because conclusions are visibly grounded in evidence Why best: Reporting raw quotes without synthesis transfers the analytical burden to stakeholders who were not present in sessions; synthesizing to generic themes ("users want simplicity") without grounding in behavioral evidence produces insights too vague to act on; the atomic observation → cluster → insight chain creates a traceable path from evidence to recommendation
Sources: NNG "Affinity Diagrams: Learn How to Cluster and Bundle Ideas and Facts" (2023); IDEO "The Field Guide to Human-Centered Design" (IDEO.org, 2015); Portigal "Interviewing Users" Ch. 8 (Rosenfeld Media, 2013); Dovetail "Research Repository Best Practices" (2022)
Collect everything from sessions before analysis begins:
Do not begin clustering until all sessions are complete. Synthesizing mid-study introduces availability bias — early sessions get disproportionate weight.
Rewrite each note as a single, self-contained observation on a sticky note (physical or digital — Miro, FigJam, Dovetail):
✅ P3: "I always screenshot the confirmation page because I don't trust the email will arrive"
✅ P1: opened a separate spreadsheet to cross-reference pricing during the session
❌ "Users don't trust the system" — interpretation, not observation
A 60-minute session typically produces 20–40 atomic observations. For 6 sessions, expect 120–240 notes before clustering.
Arrange all notes on a shared canvas. Group notes that describe the same behavior, attitude, or context — without pre-defining the categories.
Process:
Rules for clustering:
Write a theme label that describes the pattern, not the feature:
❌ "Search problems"
✅ "Users rely on external tools when internal search fails"
❌ "Onboarding"
✅ "New users skip setup steps they perceive as optional, then hit errors later"
A cluster with fewer than 3 observations is a weak signal — note it but do not elevate it to a primary insight.
For each theme, write one declarative insight statement:
[User group] [behavior or belief] because [underlying reason],
which means [implication for design or product].
Example:
Power users maintain a personal spreadsheet alongside the product because the export
function doesn't include the columns they need, which means the data model needs
to support configurable exports before they will reduce spreadsheet use.
An insight is not:
Rate each insight:
| Dimension | How to assess |
|---|---|
| Frequency | How many participants exhibited this pattern? (out of N) |
| Severity | Does this block task completion, cause errors, or just create friction? |
| Actionability | Can the team act on this in the next sprint, quarter, or roadmap? |
Present the top 3–5 insights in the readout. Include the full set in an appendix for stakeholders who want depth.
Each insight in the readout should include:
Avoid presenting findings as a list of problems without recommendations — research without a clear path forward stalls in stakeholder review.
npx claudepluginhub jeffreytse/grimoire --plugin grimoireSynthesizes qualitative research via affinity mapping, thematic analysis, pattern recognition, and insight extraction. Use for interview analysis, usability findings, and actionable recommendations.
Synthesizes user research like interview transcripts, surveys, usability tests, and feedback into themes, insights, user segments, and prioritized recommendations.
Synthesizes user research interviews into actionable insights, patterns, and recommendations. Use after conducting user interviews, customer calls, or usability sessions.