trace

Generate competing hypotheses and rank evidence to trace ambiguous causal outcomes.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/dropsyoon/oh-my-claudecode --skill trace-dropsyoon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/dropsyoon/oh-my-claudecode/tree/main/skills/trace
Command: npx skills add https://github.com/dropsyoon/oh-my-claudecode --skill trace-dropsyoon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you trace ambiguous, causal outcomes back to their most likely reasons using evidence and falsification instead of guess-and-fix.

Core Features & Use Cases

  • Competing-hypothesis tracing: Generates multiple deliberately different explanations, then tests them with evidence.
  • Evidence-ranked reasoning: Organizes evidence for/against each hypothesis and explicitly tracks what’s missing.
  • Discriminating next probe: Recommends the single highest-value next step that would collapse uncertainty fastest.
  • Team-mode orchestration: Runs three tracer lanes by default and performs a rebuttal round before synthesizing.

Quick Start

Use /oh-my-claudecode:trace when you need to answer “given this output, why did it happen?” and the situation is ambiguous, evidence-heavy, and best handled by comparing competing explanations.

Frequently Asked Questions about trace

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of an ambiguous runtime bug without guessing?

To find the root cause of an ambiguous runtime bug, use competing-hypothesis tracing to generate multiple explanations and test them with discriminating evidence. This method ranks evidence for and against each hypothesis to identify the most likely explanation.

What is the best way to trace why a software regression or performance issue happened?

The best way to trace why a software regression or performance issue happened is evidence-ranked reasoning. It organizes runtime behavior evidence, tracks missing data, and recommends a discriminating next probe to collapse uncertainty quickly.

How does team-mode orchestration work for root cause analysis?

Team-mode orchestration for root cause analysis runs three tracer lanes simultaneously, performs a rebuttal round to challenge findings, and synthesizes the results. This process outputs the most likely explanation with an explicit critical unknown.

When do I need competing-hypothesis tracing for debugging?

You need competing-hypothesis tracing for debugging when facing ambiguous causal outcomes, evidence-heavy regressions, or configuration mysteries. It is required when guessing fixes is insufficient and falsifiable evidence is necessary to explain runtime behavior.

Can I use this method to explain configuration orchestration mysteries?

Yes, you can use competing-hypothesis tracing to explain configuration orchestration mysteries. It applies falsification to test deliberately different explanations, rank the collected evidence, and output the most likely reason for the orchestration behavior.

What should I do after identifying a likely explanation for a runtime bug?

After identifying a likely explanation for a runtime bug, you should execute the recommended discriminating next probe. This highest-value next step targets the explicit critical unknown to collapse remaining uncertainty and confirm the root cause.