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.
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/thinking-kepner-tregoe/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/thinking-kepner-tregoe/
1Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a codex2Manually: put the files in place
.agents/skills/thinking-kepner-tregoe/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a cursor2Manually: put the files in place
.cursor/skills/thinking-kepner-tregoe/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install tjboudreaux/cc-thinking-skills thinking-kepner-tregoe2Manually: put the files in place
.github/skills/thinking-kepner-tregoe/SKILL.md1Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a gemini-cli2Platform CLI
gemini skills install https://github.com/tjboudreaux/cc-thinking-skills --path skills/thinking-kepner-tregoeManually: put the files in place
.devin/skills/thinking-kepner-tregoe/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add tjboudreaux/cc-thinking-skills --skill thinking-kepner-tregoe -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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