debugging

name	debugging
description	Debugging skill for troubleshooting code issues. Use when encountering errors or unexpected behavior.
allowed-tools	["read_file","execute_python","analyze_code","git_diff","git_log"]

Debugging Skill

Purpose

Systematic approaches to finding and fixing bugs.

Workflows

1. Investigate Error

1. read_file(file_with_error) - Read the problematic code
2. analyze_code(content) - Check structure
3. execute_python(minimal_test) - Reproduce the error
4. Identify root cause from error message

2. Compare with Previous Version

1. git_log(5) - Check recent commits
2. git_diff(file) - See what changed
3. Identify when bug was introduced

3. Fix and Verify

1. read_file(target) - Understand current code
2. write_file(target, fixed) - Apply fix
3. execute_python(test) - Verify fix works
4. execute_python(other_tests) - Check no regressions

Common Patterns

Syntax Errors

• Check for missing colons, parentheses, quotes
• Use analyze_code for structure issues

Import Errors

• Verify file exists at expected path
• Check for circular imports

Logic Errors

• Add print statements to trace execution
• Test with edge case inputs