Not in the top 1,000 by GitHub stars

AlmogBaku/debug-skill

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

skills/debugging-code/SKILL.md

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 26ef325fe218

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 26ef325fe2188209d053f42a6ca0000942a94932

git clone --filter=blob:none --no-checkout https://github.com/AlmogBaku/debug-skill.git .hotskills/almogbaku-debug-skill && git -C .hotskills/almogbaku-debug-skill checkout --detach 26ef325fe2188209d053f42a6ca0000942a94932 # Copy each selected skill directory from .hotskills/almogbaku-debug-skill into .claude/skills/<skill-name>/
335GitHub stars
0stars in 7 days
1skill in this repository
0commits in 30 days

Heat

0.4
  • Star growth, last 7 daysNot available
  • Star growth, last 24 hoursNot available
  • Rank movement, last 7 daysNot available
  • Commits, last 30 daysNot available
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekNot available

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Oct 25, 2026Oct 25, 2026335

30-day change not yet available: not enough history.

Individual skills in this repository

How it works

debugging-code

When your agent uses it

Interactively debug source code — set breakpoints, step through execution line by line, inspect live variable state, evaluate expressions against the running program, and navigate the call stack to trace root causes. Use when a program crashes, raises unexpected exceptions, produces wrong output, when you need to understand how execution reached a certain state, or when print-statement debugging isn't revealing enough.

What it loads into context

Frontmatter

89 tokens

Always available to the agent

SKILL.md

2,652 tokens

When the skill is activated

Reference documents

1,065 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Setup
  2. Starting a Session
  3. The Debugging Mindset
  4. Know Your State
  5. Forming a Hypothesis
  6. Setting Breakpoints Strategically
  7. Navigating Execution
  8. Skipping Ahead
  9. Advanced Scenarios
  10. Walkthrough
  11. Verify Your Fix
  12. Cleanup

Scripts executed separately

  • scripts/install-dap.sh

Files

  • ../../.claude-plugin/marketplace.jsonasset382 bytes
  • ../../.claude-plugin/marketplace.jsonasset382 bytes
  • ../../.claude-plugin/plugin.jsonasset582 bytes
  • ../../.claude-plugin/plugin.jsonasset582 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • SKILL.mdcore11,613 bytes
  • references/advanced-techniques.mddoc2,021 bytes
  • references/installing-debuggers.mddoc2,258 bytes
  • scripts/install-dap.shruns2,215 bytes
Read SKILL.md

# Interactive Debugger

Use when a program crashes, produces wrong output, or you need to understand exactly
how execution reached a particular state — and running it again with more print statements
won't give you the answer fast enough.

You can pause a running program at any point, read live variable values and the call stack
at that exact moment, step forward line by line or jump to the next breakpoint, and
evaluate arbitrary expressions against the live process — all without restarting.

## Setup

This skill uses `dap`, a CLI tool that background daemon to interact with the debugger via the DAP Protocol, maintain
the debugger state, so you can simply interact with it with multiple calls.
View the complete source on GitHub

Skills included

  • debugging-code

Repository facts

License
MIT
Created
Mar 6, 2026
Last pushed
Apr 17, 2026
Forks
28
Open issues
1
Project activity
Slowing

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 5, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 12 notes
  • .claude-plugin/marketplace.json:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • .claude-plugin/plugin.json:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/debugging-code/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 28 signals by file

.claude-plugin/plugin.json

  • Network accessline 6
    "name": "Almog Baku"   },   "homepage": "https://github.com/AlmogBaku/debug-skill",
  • Network accessline 7
    },   "homepage": "https://github.com/AlmogBaku/debug-skill",   "repository": "https://github.com/AlmogBaku/debug-skill",
  • Network accessline 8
    "homepage": "https://github.com/AlmogBaku/debug-skill",
  • Network accessline 9
    "repository": "https://github.com/AlmogBaku/debug-skill",

skills/debugging-code/SKILL.md

  • Network accessline 43
    This tool is open-sourced and available on [GitHub](https://github.com/AlmogBaku/debug-skill), maintained and follows
  • Dangerous shell operationline 103
    **Trace causation up the stack.** If a value is wrong at frame 0, check `dap eval "<expr>" --frame 1` to see what the
  • Dangerous shell operationline 205
    Use `dap eval "<expr>"` to probe live state without stepping:
  • Dangerous shell operationline 208
    dap eval "len(items)"
  • Dangerous shell operationline 209
    dap eval "user.profile.settings"
  • Dangerous shell operationline 210
    dap eval "expected == actual"       # test hypothesis on live state
  • Dangerous shell operationline 211
    dap eval "self.config" --frame 1    # frame 1 = caller (may be a different file)
  • Dangerous shell operationline 238
    → dap eval "items" --frame 1      → []   ← confirmed

skills/debugging-code/references/advanced-techniques.md

  • Dangerous shell operationline 15
    → dap eval "lock.locked()"          ← test deadlock hypothesis
  • Dangerous shell operationline 45
    → dap eval "is_valid(result)"                    # True → bug is after 500

skills/debugging-code/references/installing-debuggers.md

  • Dangerous shell operationline 29
    macOS note: you may need `sudo DevToolsSecurity -enable` for debugging permissions.
  • Network accessline 44
    DAP_VER=$(curl -fsSL https://api.github.com/repos/microsoft/vscode-js-debug/releases/latest | grep -o '"tag_name":"[^"]*"' | cut -d'"' -f4) && \
  • Network accessline 46
    curl -fsSL "https://github.com/microsoft/vscode-js-debug/releases/download/${DAP_VER}/js-debug-dap-${DAP_VER}.tar.gz" | tar -xz -C ~/.dap-cli/js-debug

skills/debugging-code/scripts/install-dap.sh

  • Executable scriptline 1
    #!/usr/bin/env bash
  • Network accessline 7
    go_install_fallback() {   if ! command -v go >/dev/null 2>&1; then     echo "Error: go is not installed. Install Go from https://go.dev/dl/ and re-run, or download a binary from:"
  • Network accessline 8
    if ! command -v go >/dev/null 2>&1; then     echo "Error: go is not installed. Install Go from https://go.dev/dl/ and re-run, or download a binary from:"     echo "  https://github.com/$REPO/releases/latest"
  • Network accessline 9
    echo "Error: go is not installed. Install Go from https://go.dev/dl/ and re-run, or download a binary from:"
  • Network accessline 10
    echo "  https://github.com/$REPO/releases/latest"
  • Network accessline 43
    LATEST=$(curl -fsSL "https://api.github.com/repos/$REPO/releases/latest" \
  • Network accessline 52
    DOWNLOAD_URL="https://github.com/$REPO/releases/download/$LATEST/$ASSET_NAME"
  • Dangerous shell operationline 60
    echo "Error: no writable install directory found. Try running with sudo or ensure ~/.local/bin is accessible."
  • Network accessline 66
    echo "Downloading $ASSET_NAME ($LATEST)..." if ! curl -fsSL "$DOWNLOAD_URL" -o "$INSTALL_PATH"; then
  • Network accessline 67
    if ! curl -fsSL "$DOWNLOAD_URL" -o "$INSTALL_PATH"; then
  • Dangerous shell operationline 68
    rm -f "$INSTALL_PATH"

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Declared and executed: 1 fact
Signal confidence: 24 facts

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeNativeManifest .claude-plugin/marketplace.json.claude/skills/<skill-name>/
CodexCompatibleStandard SKILL.md skills/debugging-code/SKILL.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md skills/debugging-code/SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md skills/debugging-code/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md skills/debugging-code/SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md skills/debugging-code/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.