trace
Trace systematically investigates why something happened by generating competing hypotheses and evaluating evidence for and against each one. It's built for ambiguous causal questions—runtime bugs, performance regressions, and architecture issues—where you need to explain the most likely explanation. The skill structures your investigation through observation, hypothesis generation, evidence gathering, and discriminating probes.
Trace helps you identify root causes of runtime bugs by testing competing hypotheses against evidence.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-27
Trace helps you identify root causes of runtime bugs by testing competing hypotheses against evidence. Trace systematically investigates why something happened by generating competing hypotheses and evaluating evidence for and against each one. It's built for ambiguous causal questions—runtime bugs, performance regressions, and architecture issues—where you need to explain the most likely explanation. The skill structures your investigation through observation, hypothesis generation, evidence gathering, and discriminating probes.
Use it when
- Trace works by first capturing your observations about the bug—what failed, when, and under what conditions.
- Yes.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Similar skills
Install
zereight/gitlab-mcp/trace · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What is Trace and what does it help me debug?
Trace is a systematic investigation skill that helps you root cause runtime bugs, performance regressions, and architecture anomalies. It generates competing hypotheses about why something happened, then evaluates evidence for and against each one to identify the most likely explanation. Trace structures your investigation through observation, hypothesis generation, evidence gathering, and discriminating probes—making it ideal for ambiguous causal questions where multiple explanations seem plausible.
How do I trace this bug for me using competing hypotheses?
Trace works by first capturing your observations about the bug—what failed, when, and under what conditions. It then generates multiple competing hypotheses that could explain the failure. For each hypothesis, Trace helps you identify what evidence would support or refute it, then guides you through targeted probes to gather that evidence. By systematically eliminating unlikely explanations, you converge on the root cause with confidence.
Can Trace help me investigate performance and latency issues?
Yes. Trace is built for investigating performance and latency issues with evidence-driven reasoning. When you report that latency is high or performance has degraded, Trace generates hypotheses about the cause—resource contention, inefficient queries, network delays, config misalignment—then helps you design targeted measurements and observations to test each one. This structured approach turns vague performance complaints into actionable root causes.
How does Trace support postmortem and premortem analysis?
Trace conducts structured causal tracing for both postmortem (after-incident) and premortem (before-deployment) analysis. In postmortem mode, it helps you trace back from observed failure to root cause by generating competing explanations and evaluating evidence. In premortem mode, it helps you imagine what could go wrong, generate plausible failure modes, and identify early warning signs—turning speculation into a prioritized investigation plan.
What kinds of system issues can Trace diagnose?
Trace diagnoses runtime bugs, regressions, performance degradation, latency spikes, and unexpected system output. It also handles config, routing, and orchestration behavior anomalies—cases where the system is behaving unexpectedly but the cause isn't obvious. Trace works best when multiple plausible explanations exist and you need to rank them by likelihood using evidence.
Why is root cause analysis with Trace better than guessing?
Trace replaces guessing with structured evidence-driven reasoning. Instead of jumping to the first plausible explanation, Trace forces you to generate multiple competing hypotheses, identify what evidence would discriminate between them, and gather that evidence systematically. This approach reduces confirmation bias, catches overlooked causes, and gives you confidence that your root cause explanation is sound—not just convenient.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
Trace
Evidence-driven causal tracing using competing hypotheses. Use for ambiguous, causal, evidence-heavy questions where the goal is to explain WHY something happened.
Good Entry Cases
- Runtime bugs and regressions
- Performance / latency behavior
- Architecture / premortem / postmortem analysis
- Config / routing / orchestration behavior
- "Given this output, trace back the likely causes"
Core Contract
Always preserve: Observation → Hypotheses → Evidence For → Evidence Against → Best Explanation → Critical Unknown → Discriminating Probe
Workflow
- Restate the observed result precisely
- Generate 3 deliberately different hypotheses:
- Code-path / implementation cause
- Config / environment / orchestration cause
- Measurement / artifact / assumption mismatch
- Assign @tracer to each hypothesis lane
- Each lane: evidence for, evidence against, critical unknown, discriminating probe
- Apply lenses: Systems,
(truncated - see the full file via the links below)
File tree — 1 file
.github/skills/trace/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Trace root cause of runtime bugs and regressions using competing hypotheses”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Verify turns uncertain claims into concrete proof by running existing tests, type checks, and targeted validation commands. It reports exactly what passed, what failed, and what remains unverified—ensuring changes are genuinely complete before you move on.
UltraQA automates the test-fix loop by running quality checks, analyzing what broke, and applying corrections across up to 5 cycles. Choose your goal—tests, build, lint, or type checking—and let it work toward success. It tracks progress, detects repeated failures, and exits when the goal is met or max cycles reached.
Status displays which OMG mode is running and reports its current progress, including active phases, task completion, and agent states. Use it to verify what's executing, monitor advancement through workflows, or confirm state after resuming operations.
H Abduct runs a structured four-step abductive cycle to generate ≥3 competing typed hypotheses for an observed signal, applying plausibility filters and surfacing the prime candidate alongside rivals. It's designed as an internal subroutine for h-diagnose's parallel testing, though manual invocation is supported when disciplined abduction without parallel overhead is needed.
Parallel Debugging applies the Analysis of Competing Hypotheses methodology to organize multi-agent investigation of complex issues. It structures hypothesis generation across six failure mode categories, establishes evidence collection standards with citation requirements, and provides arbitration protocols to identify root causes while avoiding confirmation bias.
This skill teaches you to trace bugs backward through the call chain rather than fixing where errors appear. By working systematically up the stack—identifying what called each function and what values were passed—you locate the original trigger and fix the root cause. Includes instrumentation techniques, stack trace analysis, and real examples of finding pollution across test suites.
More skills tdd (MIT) · Agent Tracing (NOASSERTION)