Skip to content
alyn
Owl-Listener

Affinity Diagram skill

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`.

$npx skills add Owl-Listener/designer-skills --skill affinity-diagram
View this skill on GitHubOwl-Listener/designer-skills/design-research/skills/affinity-diagram/SKILL.md
Pack stars
3,314
Pack installs
237k
Alyn Score
61/99
Updated
2 months ago
License
MIT
– views – installs via Alyn

Owl-Listener

Affinity Diagram

Install Affinity Diagram

Pick your agent. Every command is ready to paste.

$npx skills add Owl-Listener/designer-skills --skill affinity-diagram

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads affinity-diagram when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the affinity-diagram skill”. In Codex, type $affinity-diagram.

The skill itself

SKILL.md

FolderGitHub

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.

Tips for Affinity Diagram

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Affinity Diagram

What does the Affinity Diagram skill do?

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`.

How do I install Affinity Diagram?

Run "npx skills add Owl-Listener/designer-skills --skill affinity-diagram" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Affinity Diagram work in Cursor and Codex?

Yes. Affinity Diagram uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Affinity Diagram free?

Affinity Diagram is open source on GitHub under the MIT license. It is free to install; check the license before commercial use.

Who made Affinity Diagram?

Affinity Diagram is published by Owl-Listener in the Owl-Listener/designer-skills repository, together with 29 other skills.

Similar skills. From other creators.