Skip to content
alyn
lingzhi227

Code Debugging skill

Debug experiment code with structured error analysis. Categorize errors, apply targeted fixes with retry logic, and use reflection to prevent recurring issues. Use when experiment code fails or produces incorrect results.

$npx skills add lingzhi227/agent-research-skills --skill code-debugging
View this skill on GitHublingzhi227/agent-research-skills/skills/code-debugging/SKILL.md
Pack stars
462
Pack installs
60k
Alyn Score
46/99
Updated
9 months ago
– views – installs via Alyn

lingzhi227

Code Debugging

Coding Research Science

Install Code Debugging

Pick your agent. Every command is ready to paste.

$npx skills add lingzhi227/agent-research-skills --skill code-debugging

The open skills CLI detects your agents (Claude Code, Cursor, Codex and 70+ more) and installs to the right folder. Add -g to install globally.

01

Install it

Run the command above, or upload the folder in Claude.

02

Ask naturally

Describe the task. Your agent loads code-debugging when the request matches its description.

03

Name it if needed

If it does not trigger, say “use the code-debugging skill”. In Codex, type $code-debugging.

The skill itself

SKILL.md

FolderGitHub

Code Debugging

Systematically debug experiment code with structured error categorization and fix strategies.

Input

  • $0 — Error message, stderr output, or code file with issues
  • $1 — Optional: the code that produced the error

References

  • Debug patterns and state machine: ~/.claude/skills/code-debugging/references/debug-patterns.md

Workflow

Step 1: Categorize the Error

Category Examples Severity
SyntaxError Invalid syntax, indentation Low
ImportError Missing module, wrong name Low
RuntimeError Division by zero, shape mismatch Medium
TimeoutError Infinite loop, too slow Medium
OutputError Missing files, wrong format Medium
LogicError Wrong results, 0% accuracy High

Step 2: Analyze Root Cause

  1. Read the error traceback (last 1500 chars if truncated)
  2. Identify the exact line and variable causing the error
  3. Check for common patterns:
    • Device mismatch (CPU vs GPU tensors)
    • Shape mismatch in matrix operations
    • Missing data normalization
    • Off-by-one errors in indexing
    • Incorrect loss function for task type

Step 3: Apply Fix Strategy

For syntax/import errors: Direct fix, single attempt For runtime errors: Fix and rerun, up to 4 retries For logic errors: Reflect on approach, consider alternative methods For timeout: Reduce dataset size, optimize bottleneck, add early stopping

Step 4: Reflect and Prevent

After fixing:

  1. Explain why the error occurred
  2. Identify which lines caused it
  3. Describe the fix line-by-line
  4. Note patterns to avoid in future code

Fix Strategy State Machine

Stage 0 (first attempt) → repost code as fresh
Stage 1 (second attempt) → repost or leave depending on severity
Stage 2 (third attempt) → regenerate from scratch if still failing

Rules

  • Prefer minimal targeted edits over full rewrites
  • Maximum 4-5 fix attempts before changing approach
  • Always truncate long error outputs to last 1500 characters
  • After fixing, verify the fix doesn't introduce new errors
  • Keep error history to avoid repeating the same mistakes
  • If 0% accuracy: check accuracy calculation first, then check data pipeline

Tips for Code Debugging

  • • Start a fresh session after installing so your agent picks up the new skill.
  • • It bundles reference files. The agent reads them only when needed, so they cost no context until then.
  • • It is part of a pack with 30 skills. Install only the ones you need with --skill to keep triggers precise.
  • • If two skills overlap, mention the one you want by name.

Questions about Code Debugging

What does the Code Debugging skill do?

Debug experiment code with structured error analysis. Categorize errors, apply targeted fixes with retry logic, and use reflection to prevent recurring issues. Use when experiment code fails or produces incorrect results.

How do I install Code Debugging?

Run "npx skills add lingzhi227/agent-research-skills --skill code-debugging" in your project. The skills CLI installs it for Claude Code, Cursor, Codex and 70+ other agents. In Claude on the web, upload the skill folder as a ZIP under Customize > Skills.

Does Code Debugging work in Cursor and Codex?

Yes. Code Debugging uses the open SKILL.md format, so it works in Claude Code, Claude, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot and other agents that support agent skills.

Is Code Debugging free?

Code Debugging is open source on GitHub. It is free to install; check the license before commercial use.

Who made Code Debugging?

Code Debugging is published by lingzhi227 in the lingzhi227/agent-research-skills repository, together with 29 other skills.

Similar skills. From other creators.