Debug

What it does

The Debug skill helps AI agents identify and fix code errors by leveraging advanced static analysis and targeted test case generation, moving beyond guesswork. It automates debugging workflows using a server-side log capture system, eliminating manual copy-pasting of console logs and enabling direct access to debug information for the user. The skill focuses on issues like state/value problems, conditional logic, asynchronous timing, and user interaction flows.

When to use it

This skill is particularly useful in these scenarios:

• When you're about to manually check the DevTools Console for errors.
• When you need to reproduce a bug and examine its output.
• When you’re adding console.log statements to debug code.
• When debugging user interaction flows involving modals, forms, or clicks.

Key capabilities

• Automated Log Capture: Captures console logs server-side, eliminating manual copy-pasting.
• Session Management: Creates and manages unique debugging sessions with associated log files.
• Debugging Focus: Specifically designed for state/value issues, conditional logic, asynchronous timing, and user interaction flows.
• Server-Side Debugging: Runs a debug server to facilitate automated analysis and reporting.

Example prompts

Here are some example prompts you could use with an AI agent equipped with this skill:

• /debug /path/to/project (Starts the debugging process for a specific project)
• /debug create session fix-null-userid (Creates a new debugging session named "fix-null-userid")
• /debug log sessionId=fix-null-userid-a1b2c3 msg="User ID is null" (Adds a debug message to the specified session's log file)

Tips & gotchas

• Project Path: You must provide the path to your project when initiating the debugging process. If no path is provided, it defaults to the current working directory.
• Server Port: The skill uses port 8787 by default. Ensure this port isn't already in use; otherwise, resolve the conflict using lsof -.
• Session ID: Carefully save and reuse the unique session ID generated when creating a debugging session.