SKILL.md
Debugging Log Analyser Skill
Parses raw error logs, stack traces, and crash reports into a structured diagnosis with probable root cause, affected code path, and specific next steps — no hand-waving.
Required Inputs
Ask for these if not provided:
- The log / stack trace / error output (paste directly or describe the error)
- Language and framework (e.g. Node.js + Express, Python + Django, Java Spring, Go)
- Context (what changed before this started — e.g. recent deploy, config change, increased traffic, new input data; or "nothing changed" is also useful)
- Frequency (one-off / intermittent / consistent / regression after a specific change)
- Environment (local dev / staging / production)
- What they've already tried (if anything)
Output Format
Debugging Report: [Service/App Name]
1. Error Classification
Error type: [Runtime exception / Build error / Config error / Network error / Memory error / Unknown] Severity: [Fatal / Critical / Warning / Informational] Recurrence pattern: [One-off / Intermittent / Consistent / On-startup / Under load]
2. Stack Trace Analysis
Walk the stack frame by frame, starting from the origin:
- Origin frame: [File, line, function where it started]
- Propagation path: [How it travelled through the call stack]
- Crash point: [Where it ultimately threw/panicked/exited]
For each significant frame, note whether it is:
- User code (fixable here)
- Framework/library code (usually a misuse issue)
- System/runtime code (usually a config or environment issue)
3. Root Cause Assessment
Probable root cause: [1–2 sentence plain English statement] Confidence: [High / Medium / Low — and why] Alternative causes to rule out: [If confidence is not high]
