Affinity Mapping

Synthesize interview transcripts into evidenced themes and user needs, then render an interactive HTML evidence map. Use when synthesizing interviews, affinity mapping, or preparing opportunities for discovery.

298 stars 25 forksFrontend & Design Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add superhero-tech/superhero-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add superhero-tech/superhero-skills --skill affinity-mapping
Manual install
git clone --depth 1 https://github.com/superhero-tech/superhero-skills.git /tmp/superhero-skills
mkdir -p ~/.claude/skills
cp -r /tmp/superhero-skills/plugins/product-discovery/skills/product-discovery/affinity-mapping ~/.claude/skills/affinity-mapping

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Affinity Mapping: from transcripts to themes and opportunities

Turn raw user interviews into **structured themes and opportunities** (needs/pains/desires), ready to drop into an Opportunity Solution Tree. Every conclusion stays **evidenced** - it traces back to a verbatim quote and its source. Finish with a self-contained, interactive `affinity/map.html` that makes the evidence trail inspectable.

Respond and produce all artifacts in the user's conversation language.

Before extraction, read `references/writing-quality.md`. Apply it to all agent-authored observations, labels, opportunities, and summaries; preserve source quotes verbatim. Titles and previews must describe the actual person, situation, and need on their own. Check clarity again after shortening, before saving JSON, HTML, or a handoff; this skill owns that quality without depending on a separate editor.

## Core rule: TWO-STEP synthesis (and why it matters)

The most common mistake (human and AI alike) is to dump all transcripts in at once and write themes immediately. That loses nuance, smooths over outliers, and - with AI - burns context and produces hallucinated quotes.

Work in two steps, **and step 1 is sacred**:
1. **Per-transcript extraction** - read ONE interview, extract atomic observations (nuggets), write them to a file, move to the next. Never hold all transcripts in your head at once.
2. **Cross-interview clustering** - work ONLY from the nuggets file (small); do not return to the transcripts.
Read the full skill on GitHub

Details

Skill name
affinity-mapping
Path
plugins/product-discovery/skills/product-discovery/affinity-mapping/SKILL.md
License
MIT
Repo updated
13 November 2026

FAQ

What does the Affinity Mapping skill do?

Synthesize interview transcripts into evidenced themes and user needs, then render an interactive HTML evidence map. Use when synthesizing interviews, affinity mapping, or preparing opportunities for discovery.

How do I install the Affinity Mapping skill?

Claude Code plugin: /plugin marketplace add superhero-tech/superhero-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Affinity Mapping popular?

It lives in superhero-tech/superhero-skills, which has 298 GitHub stars and 25 forks.

Related skills

Ab Test Design

298

superhero-tech/superhero-skills

Design an A/B test and decide whether available traffic can detect a useful effect. Use when planning a randomized product comparison, checking sample size or test duration, or creating an interactive A/B test card.

Testing & QA25

Build Figma Library

298

superhero-tech/superhero-skills

Build or extend a Figma token and component library from product documentation, code, or an existing UI. Prepare it for another agent by checking component properties, composition examples, and handoff, including publishing when reuse spans files. Use for reconstructing design systems and making libraries reusable; screen-only design and documentation of existing components have separate workflows.

Frontend & Design25

Code Event Storming

298

superhero-tech/superhero-skills

Reconstruct an EventStorming board from business behavior evidenced in an existing codebase. Use to map current processes, commands, domain events, read models, and open questions in a self-contained HTML board.

Software Development25

Wpds

211

Automattic/agent-skills

Use when building UIs leveraging the WordPress Design System (WPDS) and its components, tokens, patterns, etc.

Frontend & Design37

Document Design System Components

298

superhero-tech/superhero-skills

Twórz dokumentację komponentów design systemu dla designerów na podstawie dokumentacji wizualnej istniejącego projektu strony: zrzutów ekranów, makiet, plansz lub specyfikacji wizualnej. Analizuj widoczne warianty, właściwości, anatomię, tokeny, odległości, typografię, zastosowania i dostępność. Pokaż pełny wynik do oceny. Używaj przy dokumentowaniu istniejącego interfejsu. Po ukończeniu dokumentacji dla designerów zaproponuj opcjonalny pakiet dla agenta: design.md, style lub komponenty oraz przykłady użycia; przygotuj go po zgodzie.

Frontend & Design25

Wp Project Triage

211

Automattic/agent-skills

Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) including tooling/tests/version hints, and a structured JSON report to guide workflows and guardrails.

Frontend & Design37

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.