bug-detective

Diagnose code errors in Python, JavaScript/TypeScript, and Bash/Zsh.

2|Updated Jul 9, 2026
One-click install
npx skills add https://github.com/koki3141/codex-global-skills --skill bug-detective-koki3141
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-detective
Source: https://github.com/koki3141/codex-global-skills/tree/main/bug-detective
Command: npx skills add https://github.com/koki3141/codex-global-skills --skill bug-detective-koki3141

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pdb, pytest, git, shellcheck, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a systematic approach to debugging, helping developers quickly identify and resolve code errors, exceptions, and failures.

Core Features & Use Cases

  • Systematic Debugging Workflow: A step-by-step guide to debug errors systematically.
  • Error Type Analysis: Strategies for dealing with various error types such as syntax, import, type, attribute, and index errors.
  • Debugging Methods: Methods to locate the issue like binary search, log tracing, breakpoint debugging, and stack trace analysis.
  • Common Error Patterns: Documentation on common errors in Python, JavaScript/TypeScript, and Bash/Zsh.
  • Debugging Tools: Information on tools like Python pdb debugger, Node.js Inspector, Git bisect, and Bash debugging options.
  • Preventive Debugging: Best practices to prevent errors in the first place.
  • Debugging Checklist: A comprehensive checklist to follow before, during, and after debugging.
  • Additional Resources: Detailed reference files and example files for further learning.

Quick Start

Run the 'bug-detective' skill to get started on debugging your code.

Frequently Asked Questions about bug-detective

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I systematically debug code errors in Python and JavaScript?

Systematic debugging involves a structured workflow to identify and resolve code errors using methods like binary search, log tracing, breakpoint debugging, and stack trace analysis. This approach helps quickly locate and fix syntax, import, type, attribute, and index errors across multiple languages.

What is the best way to locate a code regression using Git bisect?

Git bisect is a debugging method that uses binary search across commit history to systematically pinpoint the exact commit that introduced a code regression. It narrows down the problematic changes by testing intermediate states between known good and bad versions.

Can I use pdb and Node.js Inspector for breakpoint debugging in my project?

Yes, pdb and Node.js Inspector are debugging tools used for breakpoint debugging in Python and JavaScript/TypeScript respectively. They allow developers to pause execution, inspect state, and step through code to locate the source of errors during analysis.

Do I need pytest and shellcheck installed to analyze common error patterns?

Yes, pytest and shellcheck are required dependencies for analyzing code errors. pytest supports Python test execution and failure analysis, while shellcheck identifies syntax and common error patterns specifically in Bash and Zsh scripts.

How do I prevent syntax and import errors in Bash and Zsh scripts?

Preventing syntax and import errors in Bash and Zsh requires following preventive debugging best practices and using static analysis tools. Reviewing common error pattern documentation helps developers recognize and avoid frequent scripting mistakes before execution.

Why does my debugging workflow stall when resolving type and attribute errors?

Debugging workflows stall when type and attribute errors are not approached systematically. Using a comprehensive debugging checklist before, during, and after analysis ensures thorough error type analysis and prevents overlooking root causes during stack trace evaluation.