debugging
Systematic debugging of code to find root causes, fix bugs, and prevent regressions. Use whenever an error, bug, or unexpected behavior appears.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Debugging Skill
When debugging code, follow this strict process:
Debugging Checklist
-
Understand the bug
- What is the expected behavior?
- What actually happens?
- Is the bug reproducible?
-
Locate the source
- Identify the exact file, function, or component
- Check recent changes related to the issue
-
Analyze the cause
- Logic errors
- State issues
- Async / timing problems
- Edge cases or missing validations
-
Fix with minimal change
- Do not refactor unless necessary
- Keep the fix scoped and safe
-
Prevent regression
- Add or update tests if applicable
- Mention similar areas that could break
How to respond
- Explain the root cause clearly
- Show the exact code change needed
- Warn if the issue can appear again elsewhere
- Prefer simple and predictable fixes
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!