Skip to main content
skill CX Codex

clinical-diagnostic-reasoning — Claude Code skill: overview

clinical-diagnostic-reasoning detects cognitive biases in medical decisions, audits differential hypotheses, and structures diagnostic error reviews. Useful during treatment planning and clinical case debriefs.

MIT 178 installs ★ 274 updated 2026-10-30

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add curiositech/some_claude_skills --skill clinical-diagnostic-reasoning -a claude-code
Open on GitHub

What clinical-diagnostic-reasoning does

This skill guides diagnostic thinking through structured bias audits. It catches common cognitive traps such as anchoring to triage notes or stopping the search after finding a single abnormality. The process prompts you to verify if a working diagnosis accounts for all findings and confirms whether you actively sought disconfirming evidence.

A dedicated branch targets commission bias, countering the urge to intervene when watchful waiting is appropriate. The error analysis flow separates cognitive missteps from gaps in medical knowledge. It also provides neutral framing methods for patient conversations using balanced absolute and relative figures.

The skill relies exclusively on the Read tool. It does not cover basic pathophysiology, surgical techniques, or administrative policies.

What it helps with

  • identify cognitive traps in missed or incorrect medical diagnoses
  • verify differential diagnoses against premature search termination
  • determine when watchful waiting is preferable to reflex interventions
  • present medical risks using equivalent positive and negative framings

Example prompts for the agent

  • "Check my assessment for anchoring bias based on the initial triage note."
  • "Evaluate this clinical error to determine whether commission bias influenced the choice."
  • "Draft the procedure risks for the patient using balanced positive and negative frames."

How to install clinical-diagnostic-reasoning

1Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill clinical-diagnostic-reasoning -a claude-code

2Manually: put the files in place

~/.claude/skills/clinical-diagnostic-reasoning/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/clinical-diagnostic-reasoning/

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

Questions about clinical-diagnostic-reasoning

How do I install clinical-diagnostic-reasoning in Claude Code?

Run npx skills add curiositech/some_claude_skills --skill clinical-diagnostic-reasoning -a claude-code. The file will be placed in ~/.claude/skills/clinical-diagnostic-reasoning/SKILL.md.

What does clinical-diagnostic-reasoning do?

It systematizes clinical decision-making by probing diagnostic hypotheses for anchoring, search satisficing, commission bias, and attribution errors.

What are the limitations of this skill?

It is strictly designed for clinical diagnostic thinking. It does not teach basic pathophysiology, procedural skills, or hospital administration.

Source text

SKILL.md · MIT
---
name: clinical-diagnostic-reasoning
description: Identify and counteract cognitive biases in medical decision-making through systematic error analysis and contextual algorithm application. For diagnostic reasoning, treatment decisions, and
  clinical judgment improvement. NOT for basic medical knowledge, technical procedures, or non-clinical healthcare domains.
allowed-tools: Read
metadata:
  tags:
  - clinical
  - diagnostic
  - reasoning
  pairs-with:
  - skill: systems-thinking
    reason: Systems thinking reveals feedback loops and hidden dependencies in diagnostic reasoning chains
  - skill: checklist-discipline
    reason: Diagnostic checklists reduce cognitive bias errors in medical decision-making
  - skill: crisis-detection-intervention-ai
    reason: Crisis detection requires the same bias-aware reasoning used in clinical diagnostics
---

# Clinical Diagnostic Reasoning
Improve diagnostic accuracy and treatment decisions by recognizing and overcoming systematic cognitive errors in clinical thinking.

## When to Use
✅ Use for:
- Diagnostic decision-making in clinical practice
- Treatment planning and therapeutic choices
- Case review and error analysis
- Medical education on clinical reasoning
- Patient communication and shared decision-making
- Quality improvement and patient safety initiatives

❌ NOT for:
- Learning basic medical facts or pathophysiology
- Technical procedures or surgical skills
- Healthcare administration or policy
- Non-physician clinical roles without diagnostic responsibility
- Population health management without individual patient focus

## Core Process

### Diagnostic Reasoning Flow
```
New patient presentation
    ↓
┌───[Gather information through language/history]
│   ↓
│   Does presentation suggest standard algorithm?
│   ├─ NO → Continue hypothesis generation
│   │         ↓
│   │         Develop differential diagnosis
│   │         ↓
│   │         [Proceed to bias check]
│   │
│   └─ YES → Does patient context match algorithm assumptions?
│             ├─ YES → Apply algorithm
│             │         ↓
│             │         Monitor outcomes
│             │         ↓
│             │         [Proceed to bias check]
│             │
│             └─ NO → What patient-specific factors differ?
│                     ↓
│                     Does evidence justify deviation?
│                     ├─ YES → Document rationale and modify
│                     └─ NO → Apply algorithm; reconsider if new data
│
└─── [BIAS CHECK - Always perform]
     ↓
     Am I anchored to initial impression?
     ├─ POSSIBLY → Reassess case without initial anchor
     │
     Have I found one explanation and stopped searching?
     ├─ YES → Continue search: "What else could this be?"
     │         "Does this explain ALL findings?"
     │
     Am I pattern-matching from recent/memorable case?
     ├─ YES → List specific differences between cases
     │
     Am I stereotyping this patient?
     ├─ POSSIBLY → Reset: Evaluate symptoms independently
     │
     Do I feel compelled to "do something"?
     ├─ YES → Is action justified by evidence or anxiety?
     │         Is watchful waiting appropriate?
     │
     Have I sought disconfirming evidence?
     └─ NO → Actively look for data that contradicts working diagnosis
```

### Case-Based Error Analysis Flow
```
Clinical error occurred
    ↓
What was the error?
    ├─ Wrong diagnosis
    ├─ Inappropriate treatment
    └─ Missed diagnosis
    ↓
Was this a knowledge gap or thinking error?
    ├─ KNOWLEDGE GAP → Address through study
    │                   (Not the focus of this skill)
    │
    └─ THINKING ERROR → Which cognitive bias operated?
                        ↓
                        ┌─ Anchoring? (stuck on initial impression)
                        ├─ Satisfaction of search? (stopped too early)
                        ├─ Availability? (recent case pattern-match)
                        ├─ Attribution? (stereotyped patient)
                        └─ Commission? (unnecessary action)
                        ↓
                        Was error preventable with current knowledge?
                        ├─ YES → How could bias have been recognized?
                        │         ↓
                        │         Extract generalizable lesson
                        │         ↓
                        │         Apply to future similar situations
                        │
                        └─ NO → Document for learning, not applicable
```

### Patient Communication Flow
```
Need to present medical information
    ↓
What decision does patient need to make?
    ↓
Identify equivalent framings:
    - Positive frame (% success/survival)
    - Negative frame (% failure/mortality)
    - Absolute numbers
    - Relative risk
    ↓
Which framing facilitates genuine understanding?
    ↓
Is my framing choice unintentionally biasing decision?
    ├─ YES → Present multiple equivalent framings
    │         Allow patient to process from different angles
    │
    └─ UNCERTAIN → Present both positive and negative frames
                    Verify patient comprehension
                    ↓
                    "What is your understanding of the risks/benefits?"
```

## Anti-Patterns

### Satisfaction of Search
**Novice approach:** Finds one clinically interesting explanation and stops diagnostic inquiry. "The patient has pneumonia, that explains the fever and cough."

**Expert approach:** After finding initial explanation, explicitly asks: "What else could be present? Does this explain ALL findings? Could there be a coexisting condition?"

**Timeline:** Develops over years of clinical experience through cases where initial findings were incomplete or coincidental. Critical moment comes when missing a second diagnosis causes patient harm—realization that "not finding everything is suboptimal."

### Anchoring Error
**Novice approach:** Initial symptoms or emergency department triage note establishes diagnosis that persists despite contradictory information. "ED said anxiety attack, so I'm treating anxiety."

**Expert approach:** Periodically resets evaluation without reference to initial impressions. "If I saw this patient fresh right now, what would I think?" Actively seeks information contradicting initial hypothesis.

**Timeline:** Requires recognizing pattern across multiple cases where initial impression proved misleading. Breakthrough occurs when physician catches themselves defending an anchor despite mounting contrary evidence.

### Commission Bias
**Novice approach:** Feels compelled to take action because "doing something" feels better than watchful waiting, even without clear indication. Treats borderline abnormal labs, adjusts medications unnecessarily.

**Expert approach:** Explicitly evaluates whether action is justified by evidence or driven by psychological need to intervene. Comfortable with watchful waiting when appropriate. Asks: "Will treatment help more than harm?"

**Timeline:** Often develops after causing harm through unnecessary intervention. Turning point is recognizing that action carries its own risks and that inaction is sometimes the most appropriate decision.

### Availability Error
**Novice approach:** "I just saw three patients with Lyme disease, so this patient's fatigue must be Lyme too." Pattern-matches based on superficial similarities without considering differences.

**Expert approach:** When noticing similarity to recent case, explicitly lists differences: "How is this patient NOT like that case?" Questions whether similarities are clinically meaningful or coincidental.

**Timeline:** Accumulates through experience with similar-seeming cases that proved different. Key insight comes when a "just like the last patient" case turns out completely different upon deeper investigation.

### Attribution Error
**Novice approach:** Accepts colleague's characterization that patient is "drug-seeking" or "anxious" and dismisses symptoms without independent evaluation. Stereotypes based on demographics.

**Expert approach:** Approaches each patient as individual regardless of others' characterizations. "What does THIS patient's presentation tell me?" Separates objective findings from attributed motivations.

**Timeline:** Often requires personal experience of misjudging a patient or discovering that a dismissed patient had serious pathology. Recognition that stereotypes prevented seeing actual clinical presentation.

### Algorithm Rigidity
**Novice approach:** Either follows algorithms without contextual consideration ("The guideline says X, so I must do X") OR abandons them based on gut feeling without justification.

**Expert approach:** Recognizes algorithms as population-based tools requiring interpretation. Can articulate why specific patient context justifies deviation when it does. Documents reasoning.

**Timeline:** Develops through repeated experience applying guidelines to diverse patients. Critical learning occurs when rigid application causes harm OR when appropriate deviation leads to better outcome—recognizing that expertise lies in knowing which mode applies when.

## Mental Models & Shibboleths

### Core Shibboleths
- **"Not finding everything is suboptimal"** — Expert recognition that diagnostic search shouldn't stop at first finding
- **"Understanding why we get things wrong is essential to understanding how to get things right"** — Expert frame that errors reveal cognitive patterns, not just knowledge gaps
- **Semantic equivalence awareness** — Expert automatically recognizes that "30% chance of improvement" and "70% chance of failure" are clinically identical but psychologically different

### Expert vs Novice Markers
**Novice says:** "The patient has [single diagnosis]"
**Expert says:** "The primary issue is [diagnosis], but I'm also considering [alternatives] and haven't ruled out [other possibilities]"

**Novice says:** "We need to do something"
**Expert says:** "The question is whether intervention offers more benefit than harm compared to watchful waiting"

**Novice says:** "The protocol says..."
**Expert says:** "The protocol applies when [conditions], but this patient differs in [specific ways]"

### Navigation Metaphor
Clinical reasoning requires navigating between two extremes:
- **Rigid shore:** Algorithmic medicine without contextual adaptation
- **Chaos shore:** Intuition-based medicine without evidence grounding
- **Expert navigation:** Knowing when to sail closer to structure (standard presentations) versus when context requires deviation (atypical patients)

### Trap Metaphor
Cognitive biases are predictable traps on the diagnostic path:
- Recognizable once you know what to look for
- Avoidable with deliberate countermeasures
- Universal (even experts fall in, but recognize and escape faster)
- The map of traps can be taught and learned

## References
- Source: "How Doctors Think" by Jerome Groopman
- Domain: Clinical decision-making, diagnostic reasoning, medical cognitive science
- Key insight: Medical errors stem primarily from systematic thinking patterns (cognitive biases) rather than knowledge deficits, and these patterns can be identified, taught, and corrected

© curiositech · MIT · curiositech/some_claude_skills

Similar skills

All skills for Science and research →

From the same set180

The whole set →
swift-executor swift-executor pushes coding tasks past blockers and toward a working result. Use it for urgent fixes, prototypes, and work stuck in planning. CX Codex +1 179installs win31-pixel-art-designer win31-pixel-art-designer — a skill for authentic Windows 3.1 graphics: icons, banners, splash screens and cursors. It holds the exact VGA palettes, dithering patterns and Program Manager layout rules. CX Codex +1 179installs pet-memorial-creator pet-memorial-creator is a Claude Code skill that supports people through pet loss, helping write memorial tributes and plan keepsake projects. CX Codex +1 179installs munger-worldly-wisdom munger-worldly-wisdom — a skill that applies mental models from psychology, economics and math to decisions. It screens out cognitive traps and flags high-conviction opportunities. CX Codex +1 178installs event-detection-temporal-intelligence-expert event-detection-temporal-intelligence-expert groups photo archives into coherent events using spatio-temporal ST-DBSCAN. Evaluates event importance and selects diverse pictures for collages. CX Codex +1 178installs nextjs-app-router-expert The nextjs-app-router-expert skill guides Next.js 14/15 App Router work, from route design to data loading. Use it when building or debugging server-rendered React features. CX Codex +1 176installs windows-95-web-designer windows-95-web-designer generates modern web apps styled with authentic Windows 95 design patterns, beveled chrome, and taskbars. Extrapolates retro OS layouts to AI dialogs and mobile viewports. CX Codex +1 176installs panic-room-finder The panic-room-finder skill helps map a house, spot possible concealed spaces, and plan a safe room. Use it to guide a non-destructive first look at a property. CX Codex +1 176installs

Project sponsors

Companies that keep this analytics open