Agent skill

Code Debugging

by lingzhi227 in lingzhi227/agent-research-skills

Debug experiment code with structured error analysis. An agent skill from lingzhi227/agent-research-skills.

No licenceAuto-check passedDevelopment

Install Code Debugging

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lingzhi227/agent-research-skills code-debugging --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lingzhi227/agent-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/code-debugging .claude/skills/code-debugging && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
code-debugging
GitHub stars
384
Token cost
~672 tokens
SKILL.md length
276 words
Files
2 (incl. references)
Skills in repo
31
Repo updated
First seen
Licence
None found

At a glance

Debug experiment code with structured error analysis. An agent skill from lingzhi227/agent-research-skills.

  • Works in 4 steps: Categorize the Error → Analyze Root Cause → Apply Fix Strategy → …
  • Experiment code fails
  • SKILL.md covers Input, References, Workflow and Fix Strategy State Machine, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Code Debugging is an agent skill from lingzhi227/agent-research-skills. 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.

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/debug-patterns.md`).

It sits in Development, covering Debugging and Error handling. The repository describes itself as: Skills for Claude Code — deep-research: systematic academic literature review.

When your agent uses it

  • Experiment code fails
  • Produces incorrect results

Example prompts

  • “/code-debugging”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Categorize the Error
  2. Analyze Root Cause
  3. Apply Fix Strategy
  4. Reflect and Prevent

What it can do on your machine

Read from SKILL.md and the folder at commit 9e6c085. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Code Debugging loads about 672 tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 59 tokens; SKILL.md has 276 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~672
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 276 words (~672 tokens).

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

— opening of SKILL.md by lingzhi227
name
code-debugging
argument-hint
error-or-code

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (references) in skills/code-debugging of lingzhi227/agent-research-skills.

  • SKILL.md
  • references/debug-patterns.md

Open the folder on GitHubat commit 9e6c085

Compare with similar skills

Code Debugging next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Code Debugging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Code Debugging this skilllingzhi227/agent-research-skills384—~672Automated safety check: PassNone
Native Data FetchingCherryHQ/cherry-studio-app4k6 repos~2.9kAutomated safety check: NotesMIT
Python Script Runnercongchuanling-dot/Cohort199—~577Automated safety check: NotesMIT
Error Handling FundamentalsDanielPodolsky/ownyourcode2901 repos~1.5kAutomated safety check: PassMIT
Smart File Writerforyourhealth111-pixel/Vibe-Skills3.6k—~2.6kAutomated safety check: PassApache-2.0
Golang Samber Oopscontext-labs/whip1.1k1 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Native Data Fetching

    CherryHQ/cherry-studio-app

    A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.

    4k GitHub starsUsed in 6 repos~2.9k tokens
    DevelopmentAuto-check: notes
  • Python Script Runner

    congchuanling-dot/Cohort

    Runs a Python script with checks first: confirms the interpreter version, compiles it for syntax errors, verifies imports, then explains any traceback in plain language.

    199 GitHub stars~577 tokensUpdated 1 mo ago
    DevelopmentAuto-check: notes
  • Error Handling Fundamentals

    DanielPodolsky/ownyourcode

    Guides error handling for async operations and API calls. An agent skill from DanielPodolsky/ownyourcode.

    290 GitHub starsUsed in 1 repo~1.5k tokens
    DevelopmentAuto-check passed
  • Smart File Writer

    foryourhealth111-pixel/Vibe-Skills

    Diagnoses why a file write failed (permissions, disk space, path length, locks, read-only mounts) before retrying, instead of repeating the same call blindly.

    3.6k GitHub stars~2.6k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Golang Samber Oops

    context-labs/whip

    Structured error handling in Golang with samber/oops — error builders, stack traces, codes, context, wrapping, attributes, user-facing vs developer messages, panic recovery, logger integration.

    1.1k GitHub starsUsed in 1 repo~2.6k tokens
    DevelopmentAuto-check passed
  • Official

    Design gh-aw error handling, retry, recovery, and debugging flows.

    5.4k GitHub stars~824 tokensUpdated today
    DevelopmentAuto-check passed

More from lingzhi227/agent-research-skills

All 31 skills in this repo
  • Backward Traceability

    lingzhi227/agent-research-skills

    Makes each number in a LaTeX paper link back to the code line that produced it, using hypertarget and hyperlink tags and compile-time `\num` formulas.

    384 GitHub stars~802 tokensUpdated 7 mo ago
    Auto-check passed
  • Statistical Data Analysis

    lingzhi227/agent-research-skills

    Writes statistical analysis code for experimental data, runs it through a four-round review, and reports effect sizes, p-values and confidence intervals.

    384 GitHub stars~886 tokensUpdated 7 mo ago
    Auto-check passed
  • Excalidraw Canvas Toolkit

    lingzhi227/agent-research-skills

    Draws and refines Excalidraw diagrams on a live canvas through MCP tools or a REST API, with screenshots, file import and export, snapshots and Mermaid conversion.

    384 GitHub stars~3.8k tokensUpdated 7 mo ago
    Auto-check passed
  • Research Experiment Designer

    lingzhi227/agent-research-skills

    Plans research experiments in four progressive stages, from a first working implementation through baseline tuning and creative research to ablation studies.

    384 GitHub stars~752 tokensUpdated 7 mo ago
    Auto-check passed
  • Scientific Figure Generation

    lingzhi227/agent-research-skills

    Generates publication-quality scientific figures with matplotlib or seaborn through query expansion, a run-and-retry coding loop and a visual check of the rendered PNG.

    384 GitHub stars~809 tokensUpdated 7 mo ago
    Auto-check passed
  • Research Idea Generation

    lingzhi227/agent-research-skills

    Generates and iteratively refines research ideas for a given area, checking each one's novelty against Semantic Scholar and arXiv, and scoring it on interestingness, feasibility and novelty.

    384 GitHub stars~747 tokensUpdated 7 mo ago
    Auto-check passed

Categories

Questions about Code Debugging

What does Code Debugging do?

Debug experiment code with structured error analysis. An agent skill from lingzhi227/agent-research-skills. Code Debugging is an agent skill from lingzhi227/agent-research-skills. Debug experiment code with structured error analysis.

When should I use Code Debugging?

Code Debugging fits situations like: experiment code fails; produces incorrect results.

How do I install Code Debugging in Claude Code?

Run `npx skills add lingzhi227/agent-research-skills --skill code-debugging -a claude-code`. Or copy the skill folder (skills/code-debugging in lingzhi227/agent-research-skills) into .claude/skills/code-debugging in your project. Claude Code loads it when a task matches its description.

How do I install Code Debugging in Codex?

Run `npx skills add lingzhi227/agent-research-skills --skill code-debugging -a codex`. Or copy the skill folder (skills/code-debugging in lingzhi227/agent-research-skills) into .agents/skills/code-debugging in your project. Codex loads it when a task matches its description.

Can I use Code Debugging in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lingzhi227/agent-research-skills --skill code-debugging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/code-debugging, .gemini/skills/code-debugging, .github/skills/code-debugging and .opencode/skills/code-debugging in your project.

What does Code Debugging need to run?

SKILL.md names no scripts, command-line tools or credentials: Code Debugging is instructions for the agent only.

Does Code Debugging access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Code Debugging safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Code Debugging use?

No licence was found for Code Debugging or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Code Debugging use?

About 672 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.1k tokens, read only when the agent opens those files.

What are the alternatives to Code Debugging?

Skills that share tags, products or a category with Code Debugging: Native Data Fetching (CherryHQ/cherry-studio-app, 4k stars), Python Script Runner (congchuanling-dot/Cohort, 199 stars), Error Handling Fundamentals (DanielPodolsky/ownyourcode, 290 stars) and Smart File Writer (foryourhealth111-pixel/Vibe-Skills, 3.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Code Debugging?

lingzhi227 (a GitHub user) maintains it in lingzhi227/agent-research-skills, which has 384 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on February 27, 2026.

Source: lingzhi227/agent-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.