$npx skillfedfor your agent

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

★ 1,847  330 MITupdated by zereight

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.

manual: git clone https://github.com/zereight/gitlab-mcp → cp -r gitlab-mcp/.github/skills/trace ~/.claude/skills/trace
.github/skills/trace/SKILL.md · version 1017a8e8

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.

Same gist for agents: .md · .json

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

  1. Restate the observed result precisely
  2. Generate 3 deliberately different hypotheses:
  3. Code-path / implementation cause
  4. Config / environment / orchestration cause
  5. Measurement / artifact / assumption mismatch
  6. Assign @tracer to each hypothesis lane
  7. Each lane: evidence for, evidence against, critical unknown, discriminating probe
  8. 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
by zereight · zereight/gitlab-mcp

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.

MITupdated Jul 2026
★ 1,847repo stars
ultraqa
by zereight · zereight/gitlab-mcp

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.

MITupdated Jul 2026
★ 1,847repo stars
status
by zereight · zereight/gitlab-mcp

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.

MITupdated Jul 2026
★ 1,847repo stars
H Abduct
by m0n0x41d · m0n0x41d/haft

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.

no license declared → metadata onlyupdated Jul 2026
★ 1,375repo stars
parallel-debugging
by wshobson · wshobson/agents

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.

MITupdated Jul 2026
★ 38,308repo stars
root-cause-tracing
by secondsky · secondsky/claude-skills

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.

MITupdated Jul 2026
★ 196repo stars

More skills tdd (MIT) · Agent Tracing (NOASSERTION)

Tags
hypothesis-testingcausal-analysisevidence-collectiondebugging-frameworkpostmortem-analysisfailure-investigationsystems-thinkingdiagnostic-workflow