think-affinity-mapping SKILL.md skillA

think-affinity-mapping from product-on-purpose/thinking-framework-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add product-on-purpose/thinking-framework-skills/think-affinity-mapping@v0.1.0

Pins v0.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
product-on-purpose/thinking-framework-skills
Path
skills/think-affinity-mapping/SKILL.md
Versions recorded
1
Latest version
v0.1.0, committed Jun 1, 2026
Size
6,146 bytes
Repository stars
21
License
Apache-2.0

Produces a clustered theme map that groups many raw notes, observations, quotes, or data points bottom-up into a small set of named, traceable themes (the KJ method). Use when a scattered pile of dozens to hundreds of existing items needs to become a few emergent themes, such as synthesizing user-research notes, support tickets, survey free-text, or retro stickies, and the right structure should emerge from the data rather than be imposed.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

<!-- thinking-framework-skills | https://github.com/product-on-purpose/thinking-framework-skills | Apache-2.0 -->
# Affinity Mapping

Affinity mapping takes a pile of many individual items - raw notes, observations, quotes, data points - and groups them *bottom-up by felt similarity* until a small set of emergent themes appears, then names each theme so the names become the structure. The load-bearing move is **deferred, bottom-up categorization**: you do not sort items into predefined buckets, you let the categories surface from the items themselves. This externalizes comparison so patterns hidden in a linear list become visible, resists the frame you walked in with, and compresses many items into a few themes while keeping every item traceable to its theme. The output is a **clustered theme map**, not a discussion.

## When to Use

- When dozens to hundreds of existing items - user-research notes, interview quotes, support tickets, survey free-text, retro stickies, workshop output - need to become a few themes.
- When the right structure is not known in advance and should emerge from the data rather than be imposed.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add product-on-purpose/thinking-framework-skills/think-affinity-mapping@sha256:82f5b92d3c5593ba

The line at the top of this page pins the label v0.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rdmdnc5yzveybxiw.svg)](https://markdownregistry.com/a/art_rdmdnc5yzveybxiw)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jun 1, 2026.

versioncommittedcommitsizeaudit
v0.1.0 latest2026-06-01 5bad9cb 6,146 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (6146 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

product-on-purpose/thinking-framework-skills · 21 stars · license Apache-2.0 · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_rdmdnc5yzveybxiw
GET https://markdownregistry.com/api/v1/resolve?ref=product-on-purpose/thinking-framework-skills/think-affinity-mapping
GET https://markdownregistry.com/api/v1/blob/82f5b92d3c5593ba62c40f3ad38369beb3c9e463c1d48a834ff9ca42a62b82b8

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from product-on-purpose/thinking-framework-skills

AGENTS.md AGENTS.md file
product-on-purpose/thinking-framework-skills · AGENTS.md
git:20261018.bea29d3 · audit A · 21 stars
llms-full.txt@site/public llms.txt file
product-on-purpose/thinking-framework-skills · site/public/llms-full.txt
git:20261015.c178434 · audit A · 21 stars
llms.txt@site/public llms.txt file
product-on-purpose/thinking-framework-skills · site/public/llms.txt
git:20261015.c178434 · audit A · 21 stars
think-abstraction-laddering SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-abstraction-laddering/SKILL.md · Builds an abstraction ladder that moves a problem up ("why / to what end?") and down ("how / what specifically?") to…
v0.1.0 · audit A · 21 stars
think-after-action-review SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-after-action-review/SKILL.md · Produces a structured after-action review by comparing what was expected against what actually happened, diagnosing why…
v0.1.0 · audit A · 21 stars
think-analysis-of-competing-hypotheses SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-analysis-of-competing-hypotheses/SKILL.md · Handles a by-name request for ACH (Analysis of Competing Hypotheses), the evidence-by-hypothesis disconfirmation…
v0.1.0 · audit A · 21 stars
think-argument-mapping SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-argument-mapping/SKILL.md · Produces an argument map by laying out a claim's supporting reasons, the co-premises each silently depends on, and the…
v0.1.0 · audit A · 21 stars
think-assumption-reversal SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-assumption-reversal/SKILL.md · Generates non-obvious ideas by surfacing the foundational assumptions a problem or solution rests on, negating each…
v0.1.0 · audit A · 21 stars
think-authentic-dissent SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-authentic-dissent/SKILL.md · Checks whether a decision has genuine minority dissent or only smooth surface consensus, identifies who actually holds…
v0.1.0 · audit A · 21 stars
think-backcasting SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-backcasting/SKILL.md · Produces a backcast path by fixing a vivid desired future state and reasoning backward through the milestones and…
v0.1.0 · audit A · 21 stars
think-belief-update-routine SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-belief-update-routine/SKILL.md · Produces a belief-update ledger that re-scores a standing inventory of open beliefs against newly arrived evidence on a…
v0.1.0 · audit A · 21 stars
think-boundary-critique SKILL.md skill
product-on-purpose/thinking-framework-skills · skills/think-boundary-critique/SKILL.md · Audits the boundary judgments that silently define a problem frame. For each of four sources, who benefits, who…
v0.1.0 · audit A · 21 stars

Every file in product-on-purpose/thinking-framework-skills

Browse by kind, by grade A, or by owner.