debug-system

# Debug System Find, explain, and fix errors by identifying the root cause. Use this skill when: - something is not working - an error message appears - a workflow fails - an API request breaks - behavior does not match expectations - the same issue keeps happening This is an instruction-only skill. It does not execute code or access external systems unless the user provides the data. --- ## What this skill does This skill helps an agent: - analyze errors and unexpected behavior - identify the real root cause (not just symptoms) - explain what went wrong in simple terms - suggest concrete fixes - guide step-by-step debugging - prevent the issue from happening again --- ## What this skill does not do This skill does not: - guess without evidence - invent missing logs or results - claim something is fixed without validation - access external systems without user input - provide fake certainty --- ## Inputs Use what the user provides: - error messages - logs - code snippets - API responses - workflow steps - expected vs actual behavior - screenshots or descriptions If information is missing, state assumptions clearly. --- ## Debugging process ### Step 1 — Understand the problem Identify: - expected behavior - actual behavior - when the issue occurs - what changed recently --- ### Step 2 — Analyze the error Look for: - exact error message - stack trace (if available) - failing step or node - invalid inputs - missing fields - wrong data types - permission/auth issues - network/API failures --- ### Step 3 — Find root cause Do not stop at symptoms. Ask: - what caused this error? - what condition triggered it? - is this reproducible? - is it a config issue, logic issue, or external failure? --- ### Step 4 — Propose fixes For each issue, provide: - root cause - why it happens - exact fix - alternative fix (if needed) - how to verify the fix --- ### Step 5 — Prevent recurrence Suggest: - validation checks - better error handling - logging improvements - retry mechanisms - safer defaults --- ## Output format # Debug Report ## Problem Summary - Expected: - Actual: - Context: ## Root Cause - ... ## Evidence - ... ## Fix ### Recommended Fix - ... ### Alternative Fix - ... ## Verification Steps 1. ... 2. ... 3. ... ## Prevention - ... - ... ## Open Questions - ... - ... --- ## Behavior rules - Focus on root cause, not just symptoms - Be clear and actionable - Do not assume missing data without stating it - Prefer simple fixes over complex ones - Explain in a way the user can follow step-by-step --- ## Quality checklist Before finishing, ensure: - root cause is identified - fix is actionable - verification steps are clear - no fake assumptions - prevention is included --- ## When not to use this skill Do not use this skill for: - general explanations without a problem - theoretical discussions without real issues - tasks unrelated to debugging Use only when there is a failure, bug, or unexpected behavior.