Skip to main content
skill CX Codex

thinking-kepner-tregoe — Claude Code skill: diagnose and decide

A skill for narrowing a defect with IS/IS-NOT analysis and for picking between options with MUST screening, weighted WANTs and downside checks.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a claude-code
Open on GitHub

What thinking-kepner-tregoe does

Two modes live in one skill. Problem Analysis fits a defect that hits some objects, places, times or cohorts but not comparable ones. Decision Analysis fits a choice with hard requirements and competing objectives.

In Problem Analysis you fill WHAT, WHERE, WHEN and EXTENT: the IS side, the closest comparable IS-NOT, and the distinction unique to IS. Candidate causes come from those distinctions and from recent changes. A cause survives only if it explains both sides of the boundary, and the cheapest discriminating check runs first. In Decision Analysis options fail any MUST and drop out, survivors get scored against WANTs weighted 1 to 10, and leading options go through an adverse-consequence table with probability and impact. A high total should not hide a ruinous failure mode.

The skill returns an open result instead of forcing a winner when no cause verifies or no option clears the MUSTs. It also tells you to skip the full matrix for an obvious cause or a trivial choice, since extra rows are ceremony. Everything sits in SKILL.md as a written procedure — no scripts, no external dependencies.

What it helps with

  • separate the real cause of a defect from lookalike cases
  • screen options against hard requirements before scoring them
  • spot a ruinous failure mode behind a high weighted total
  • check whether a weight change flips the ranking
  • return no answer when no cause verifies

Example prompts for the agent

  • work out why only some requests fail, using IS/IS-NOT
  • compare two migration plans: MUST screen first, then weighted WANTs
  • show which weight changes would reverse the chosen option

How to install thinking-kepner-tregoe

1Skills CLI (Vercel)

npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a claude-code

2Manually: put the files in place

~/.claude/skills/thinking-kepner-tregoe/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/thinking-kepner-tregoe/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about thinking-kepner-tregoe

How do I install thinking-kepner-tregoe in Claude?

Run npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a claude-code. The skill file then sits at ~/.claude/skills/thinking-kepner-tregoe/SKILL.md.

What does thinking-kepner-tregoe do?

It runs two procedures: cause hunting for a deviation through an IS/IS-NOT matrix, and option selection through MUST screening, weighted WANTs and an adverse-consequence table.

When should I skip this skill?

When a failure is uniform and has no useful IS-NOT contrast, when the cause is already confirmed, or when one option plainly dominates. The full matrix is wasted effort there.

Source text

SKILL.md · MIT
---
name: thinking-kepner-tregoe
description: Use when a selective defect needs IS/IS-NOT difference analysis or a consequential option choice needs must/want weighting and adverse-consequence comparison.
disable-model-invocation: true
---

# Kepner-Tregoe Analysis

**Core rule:** Diagnose deviations by testing causes against both IS and IS-NOT. Compare consequential choices by screening MUSTs, weighting WANTs, and exposing adverse consequences before selecting.

## When to Use

- A defect affects some objects, places, times, or cohorts but not comparable others.
- Several candidate causes remain and the contrast boundary can discriminate them.
- A consequential option choice has explicit non-negotiables, competing objectives, and risks that should be compared consistently.

## When NOT to Use

- A uniform failure has no meaningful IS-NOT contrast, or the cause is already confirmed.
- One cheap observation settles the cause or one option plainly dominates every requirement.
- The criteria cannot be made operational; clarify them before assigning weights.
- The task is forward failure discovery for a planned change rather than diagnosis or option selection.

## Procedure

1. **Choose the mode.** Use Problem Analysis for a deviation from expected behavior; use Decision Analysis for a choice among options. State the target and do not mix scores with causal evidence.
2. **Frame the target.** For a deviation, record object, defect, location, time, extent, and impact. For a choice, state the decision, alternatives, constraints, and deadline.
3. **Problem Analysis — build IS/IS-NOT.** For WHAT, WHERE, WHEN, and EXTENT, record IS, closest comparable IS-NOT, and the distinction unique to the IS side. List changes near the first occurrence.
4. **Problem Analysis — difference-test causes.** Generate candidates from distinctions and changes. A candidate survives only if it explains both IS and IS-NOT. Run the cheapest discriminating check; stop when one verified cause explains the full boundary.
5. **Decision Analysis — screen and score.** Define pass/fail MUSTs and weighted WANTs (1–10 importance) before scoring. Eliminate options that fail any MUST; score survivors against each WANT and calculate weighted totals using the same scale.
6. **Decision Analysis — test downside and sensitivity.** For leading options, list adverse consequences with probability × impact and identify assumptions or weight changes that would reverse the ranking. Do not let a high total conceal a ruinous failure mode.
7. **Decide or expose the gap.** Return the verified cause or highest-ranked acceptable option, the evidence/score behind it, residual risk, and next verification. If no cause verifies or no option passes MUSTs, return open/none rather than force a winner.

## Output

Return one mode-specific decision artifact:

- **Problem Analysis:** problem statement; IS/IS-NOT matrix with distinctions; nearby changes; candidate-vs-boundary tests; confirmed cause or next discriminating check.
- **Decision Analysis:** decision statement; alternatives; MUST screen; weighted WANT matrix; adverse-consequence table; sensitivity/reversal conditions; selected option or none.

## Verification

- **Falsify/stop:** reject a cause that cannot explain both sides of the boundary. Reject a choice if it fails a MUST, depends on inconsistent scoring, or loses under a plausible weight/risk change that was hidden.
- **Over-application guard:** skip the full matrix for an obvious cause, trivial choice, or one-shot check. Stop when the cause verifies or the option is robust enough for the stated stakes; extra rows are ceremony.

© tjboudreaux · MIT · tjboudreaux/cc-thinking-skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set28

thinking-cynefin Sorts a problem into a Cynefin domain by cause and effect, then names the response mode: runbook, analysis, probe or stabilize. Useful when a method keeps failing. CX Codex +1 567installs thinking-bounded-rationality A skill that halts a search at the first option clearing a threshold you set beforehand, instead of comparing forever. CX Codex +1 563installs thinking-model-combination A skill that sequences 2–3 mental models with named roles when one model leaves a blind spot. Built for multi-domain decisions. CX Codex +1 563installs thinking-thought-experiment A skill for when a real test is too rare, large or irreversible: the agent runs one counterfactual with an isolated variable and bounds what the result implies. CX Codex +1 560installs thinking-map-territory The skill makes the agent check live code or data whenever a doc, test, metric or assumption disagrees with observed behavior. CX Codex +1 559installs thinking-margin-of-safety Makes the agent add a buffer to capacity, timeouts and schedule estimates, scaled by leftover uncertainty and the cost of a breach instead of the optimistic edge. CX Codex +1 554installs thinking-effectuation A skill for decisions under genuine uncertainty: inventory your means, then take one step inside an affordable-loss cap. Useful when forecasts can't be trusted. CX Codex +1 556installs thinking-lindy-effect A skill that turns a technology's age into an argument for the proven option. Useful when choosing a language, framework or database for the long run. CX Codex +1 553installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor