Affinity Diagram

by owl-listener9a6930cf84a8No license2.8K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 4 weeks ago

Cluster many qualitative data points into themes and insight statements. Use when synthesising across multiple sessions or sources. For a single transcript use `summarize-interview`; for one segment's inner state use `empathy-map`.

Instructions onlyResearch & Analysis
AI-generated overview

Clusters qualitative research data into themed groups and writes prioritized insight statements.

What it does
Takes qualitative research material such as interview notes, observation data, or survey responses and extracts individual data points from it. It groups those points bottom-up into named clusters, arranges them into roughly three to five top-level themes, and writes an insight statement for each theme. It also notes patterns such as frequency and connections, ranks insights by impact on design decisions, and presents the result as a structured hierarchy with supporting evidence.
When to use it
Use it when synthesizing qualitative findings across multiple sessions, participants, or sources into themes and insights. For a single transcript, the skill points to a different skill, and for one segment's inner state it points to an empathy map.
Requirements
No scripts or special tooling; it is instructions only. It works on user-provided files such as interview notes, observation data, or survey responses, which the agent reads first.

Affinity Diagram

Organize qualitative research data into themed clusters and insight statements.

Context

You are a UX researcher synthesizing qualitative data for $ARGUMENTS. If the user provides files (interview notes, observation data, survey responses), read them first.

Instructions

  1. Extract data points: Pull individual observations, quotes, and notes from the raw data.
  2. Bottom-up clustering: Group related data points into natural clusters (do not start with predefined categories).
  3. Name each cluster: Create descriptive theme labels that capture the essence of each group.
  4. Create hierarchy: Organize clusters into higher-level themes (typically 3-5 top-level themes).
  5. Write insight statements: For each theme, write a clear insight statement that captures the "so what?"
  6. Identify patterns: Note frequency, intensity, and connections between themes.
  7. Prioritize: Rank insights by impact on design decisions.
  8. Present the affinity diagram as a structured hierarchy with insight statements and supporting evidence.

Cross-Interview Sampling Principle

Index evenly across all participants. When working from multiple interview transcripts, process each one fully before clustering. Do not over-represent early transcripts or the most recent input.

  • Treat each participant as an equal source of signal
  • Tag every observation with its participant ID (P1, P2, P3...) before grouping
  • After clustering, check that each participant appears at least once in the output — if any are absent, go back
  • Patterns that appear in only one interview should be flagged as single-source, not discarded

This prevents the common LLM failure mode of building themes from the first one or two transcripts and fitting the rest retroactively.

Source and attribution

Source:owl-listener/designer-skillsindesign-research/skills/affinity-diagramat commit9a6930c

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Affinity Diagram Agent Skill | SourceWeft