Awesome-omni-skill troubleshoot

Isolate root causes and propose targeted fixes with clear validation steps.

install
source · Clone the upstream repo
git clone https://github.com/diegosouzapw/awesome-omni-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/diegosouzapw/awesome-omni-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data-ai/troubleshoot-leanbusqts" ~/.claude/skills/diegosouzapw-awesome-omni-skill-troubleshoot && rm -rf "$T"
manifest: skills/data-ai/troubleshoot-leanbusqts/SKILL.md
source content

Troubleshoot

Objective

  • Reproduce and isolate the issue.
  • Identify the most probable root cause and next actions.

When to use

  • A bug or failure is reported or observed.
  • Symptoms are unclear and need narrowing down.

Inputs

  • User-reported symptoms, logs, or reproduction steps.
  • AGENTS.md, rules, relevant code/tests.
  • Environment details if available.

Process

  1. Confirm and restate the symptom; note missing repro info.
  2. Form quick hypotheses; prioritize simplest checks.
  3. Collect minimal evidence (logs/tests/inputs) to confirm/deny hypotheses.
  4. Identify the likely root cause or narrow to top candidates.
  5. Propose next actions (fix path or deeper check) and validation steps.

Outputs

  • Likely root cause (or narrowed hypotheses).
  • Evidence collected and what’s still unknown.
  • Proposed fix direction and validation plan.

Edge cases

  • If repro is missing, request exact steps or data.
  • Avoid broad changes; focus on evidence-driven narrowing.