Skill456 repo starsupdated 2d ago

debug-live-issue

The debug-live-issue skill provides a structured workflow for diagnosing production-like failures across hooks, API routes, databases, websockets, and UI components. Use it when troubleshooting failing workflows, regressions, flaky tests, or data inconsistencies by systematically capturing symptoms, isolating affected subsystems, reproducing issues with minimal scope, and gathering evidence before applying fixes.

View source Repository: Claude-Code-Agent-Monitor

Install in Claude Code

Copy

git clone --depth 1 https://github.com/hoangsonww/Claude-Code-Agent-Monitor /tmp/debug-live-issue && cp -r /tmp/debug-live-issue/.claude/skills/debug-live-issue ~/.claude/skills/debug-live-issue

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Debug Live Issue

Use this workflow for incident-style debugging.

## Steps
- Capture symptom, expected behavior, and reproducible path.
- Isolate subsystem first: hook ingestion, API route, DB state, websocket, or UI rendering.
- Reproduce with minimal surface area.
- Prove root cause before changing code.
- Apply minimal fix and re-verify.

## Evidence standards
- Prefer direct logs, API responses, DB state checks, and deterministic repro steps.
- Avoid speculative fixes without root-cause evidence.
- If not fully reproducible, state uncertainty and strongest hypothesis.

## References
- Investigation template: `references/investigation-template.md`