freedomintelligence/openclaw-medical-skills/clinical-diagnostic-reasoning
Claude Code and agent skill by freedomintelligence/openclaw-medical-skills
- community
Checking that the SKILL.md file is still in the repository.
Identify and counteract cognitive biases in medical decision-making through systematic error analysis and contextual algorithm application. For diagnostic reasoning, treatment decisions, and
Install
npx vskill@latest install freedomintelligence/openclaw-medical-skills/clinical-diagnostic-reasoningSKILL.md
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
Case-Based Error Analysis Flow
Patient Communication Flow
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
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/clinical-diagnostic-reasoning/SKILL.md
Popularity
- Repository stars
- 3,031
- Repository forks
- 413
- 7-day trend score
- 40
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 23 Sep 2026, a month ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/freedomintelligence/openclaw-medical-skills/clinical-diagnostic-reasoning)