trace

Rank competing causal hypotheses using evidence and falsification for ambiguous investigations.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill trace-leap0920
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: trace
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/cache/omc/oh-my-claudecode/4.14.0/skills/trace
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill trace-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The trace skill helps you resolve ambiguous, causal, evidence-heavy “why did this happen?” questions by organizing competing explanations and prioritizing what to verify next.

Core Features & Use Cases

  • Competing hypotheses orchestration: Generates multiple deliberately different candidate causes instead of committing early to one theory.
  • Evidence ranking & falsification: Collects evidence for and against each hypothesis, explicitly downgrading weak or contradicted explanations.
  • Discriminating next probe: Recommends the single highest-value next step that would collapse uncertainty fastest, based on what would be hard to reconcile.

Use cases include runtime regressions, performance/latency investigations, architecture/premortem/postmortem tracing, config/routing/orchestration behavior explanation, and “trace back the likely causes given this output” scenarios.

Quick Start

Use /oh-my-claudecode:trace with your observation as the input to produce a ranked causal analysis with evidence, critical unknowns, and the best discriminating next probe.

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 a runtime regression or latency spike?

Root cause analysis of runtime regressions and latency spikes works by generating multiple competing hypotheses, gathering evidence in parallel, and ranking explanations based on falsification. This approach identifies the critical unknown and recommends the best discriminating probe to collapse uncertainty.

What is the best way to debug an ambiguous causal issue without guessing?

Debugging ambiguous causal issues without guessing requires orchestrating deliberately different tracer hypotheses and ranking them using evidence strength. Explicit falsification downgrades weak or contradicted explanations, ensuring the final synthesis is evidence-based.

How does hypothesis testing work for tracing configuration and routing behavior?

Hypothesis testing for tracing configuration and routing behavior involves restating the observation, generating multiple hypothesis lanes, and collecting evidence for and against each lane. A rebuttal round downgrades contradicted explanations before outputting a ranked synthesis.

Can I use this approach for postmortem and premortem architecture analysis?

Postmortem and premortem architecture tracing applies this approach by evaluating competing explanations for observed outcomes. It restates the observation, generates candidate causes, ranks them using evidence, and outputs a discriminating next probe to verify critical unknowns.

What should I do when my root cause analysis not working or lacking evidence?

When root cause analysis is not working, it typically lacks evidence ranking and explicit falsification. Generating competing hypotheses, running a parallel evidence gathering round, and executing a rebuttal phase downgrades weak theories and highlights the critical unknown.

Do I need any dependencies to perform evidence-based causal investigations?

Evidence-based causal investigations require no external dependencies. The process relies on restating the observation, orchestrating competing tracer hypotheses, gathering evidence, and running a rebuttal round to produce a ranked synthesis.