A high-precision diagnostic skill for identifying and repairing software bugs with minimal code changes.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install code-debug
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install code-debug using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Code Debug?
The Code Debug skill is a specialized diagnostic tool designed to help developers identify and resolve complex failures within their local codebase. By prioritizing root-cause analysis over speculative guessing, this Openclaw Skills extension ensures that every repair is both safe and effective. It focuses on producing the smallest defensible fix, which helps maintain the stability and cleanliness of the project while addressing critical runtime, logic, or syntax issues.
Whether dealing with a sudden crash, inconsistent output, or failed tests, this skill provides a structured workflow to isolate the problem. It is particularly valuable for developers who need to understand the technical depth of a bug before applying changes, making it a cornerstone of efficient software maintenance within the Openclaw Skills ecosystem.
Code Debug Use Cases
- Resolving runtime crashes or unexpected exceptions in local development environments.
- Identifying the source of logic errors where code produces incorrect outputs.
- Debugging flaky tests or race conditions in asynchronous workflows.
- Investigating resource leaks, configuration errors, or dependency conflicts.
- Providing a detailed root-cause analysis for legacy code issues.
How Code Debug Works
- The skill begins by attempting to reproduce the error or narrowing it down to the smallest possible scenario.
- It classifies the failure type, such as syntax, runtime, logic, or resource-related issues.
- Common failure patterns like off-by-one errors, null pointer exceptions, and stale state are prioritized during the investigation.
- It uses code analysis and execution logs to lock down the root cause, avoiding any unverified assumptions.
- A minimal, safe patch is generated to address the specific core issue.
- The skill avoids unnecessary refactoring unless the existing structure strictly prevents a proper fix.
- The final step involves validating the repair using the most reliable and concise verification method.
Code Debug Setup
To integrate this diagnostic capability into your workflow, ensure your environment is ready for Openclaw Skills.
# Install the code-debug skill via your CLI
openclaw install code-debug
# Navigate to the root of your project
cd /your/project/path
# Trigger the skill by describing a specific error or crash
# Example: "Find the root cause of the null pointer in user_service.py"
Code Debug Data Schema & Taxonomy
The Code Debug skill organizes its findings into a clear, technical structure to help developers understand the fix.
| Attribute | Description |
|---|---|
| Root Cause | A detailed technical breakdown of the underlying defect. |
| Impact Scope | A list of modules, files, or functions affected by the bug. |
| Reproduction Scenario | The minimal steps or code snippets required to trigger the failure. |
| Repair Direction | The recommended patch or code change to resolve the issue. |
| Verification Method | Clear instructions or commands to confirm the bug is fixed. |
Code Debug Advanced Features
- Minimalist Patch Generation: Focuses on the smallest possible code delta to keep commits clean.
- Multi-Category Diagnostics: Capable of identifying issues across syntax, logic, types, and dependencies.
- Async Order Analysis: Specialized logic for detecting race conditions and execution order failures.
- Defensible Fixing: Every suggested change is backed by a verified root-cause analysis within the Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
Stock Auto Trade Skill
A comprehensive automation skill for executing stock trades, managing holdings, and querying accounts via a local HTTP API bridge.
Accessibility Checker
A professional tool for auditing and improving web accessibility to ensure WCAG compliance and inclusive user experiences.
Infoway Financial Data
A comprehensive MCP server providing real-time financial market data, sector analysis, and company fundamentals for over 20,000 instruments.
Promptfoo
Promptfoo is a powerful framework for running local, repeatable LLM evaluations and adversarial red-team security scans to ensure model reliability.
Langfuse
A comprehensive skill for integrating Langfuse observability, prompt management, and evaluation into AI coding agent workflows.
Code Orchestrator
An intelligent task router that coordinates specialized AI agents to handle complex coding lifecycles from exploration to deployment.
Featured*
