debugging-methodology

debugging-methodology is a skill for Claude Code, Codex from laurigates/claude-plugins. It costs 41 tokens per session (1,427 once invoked), scanned B, original, MIT.

Systematic debugging for memory, performance, and system-level issues. Use when diagnosing memory leaks, tracing syscalls with strace/eBPF, profiling, or reasoning about races.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/laurigates/claude-plugins/debugging-methodology
Any agent
npx skills add laurigates/claude-plugins --skill debugging-methodology
Clone the repo
git clone --depth 1 https://github.com/laurigates/claude-plugins

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for debugging-methodology

README.md
[![agentmods](https://agentmods.dev/badge/skills/laurigates/claude-plugins/debugging-methodology.svg)](https://agentmods.dev/skills/laurigates/claude-plugins/debugging-methodology)
Your own site
<a href="https://agentmods.dev/skills/laurigates/claude-plugins/debugging-methodology"><img src="https://agentmods.dev/badge/skills/laurigates/claude-plugins/debugging-methodology.svg" alt="Measured on agentmods" height="20"></a>
Per session 41 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,427 The whole file, excluding the scripts and references it only reads on demand.
Security scan B 1 finding. Scan, not verified.
Origin unknown No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00041 $0.01427
Opus 5 $0.00020 $0.00714
Sonnet 5 $0.00008 $0.00285
Haiku 4.5 $0.00004 $0.00143

Measured today against content hash e8ce270ca50c, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade B, and why

debugging-methodology scanned grade B with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Asks for rootmediumPrivilege escalation

A mod that escalates privileges can change anything on the machine, not only the project.

sudo syscount -p PID # Count syscalls
code-quality-plugin/skills/debugging-methodology/SKILL.md · 189 lines

How it starts

The opening of the file, as written. The whole thing — 189 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Debugging Methodology

Systematic approach to finding and fixing bugs.

When to Use This Skill

Use this skill when... Use something else instead when...
Diagnosing a live bug, memory leak, race, or perf regression Bug is hidden by a swallowed error → code-hidden-failures --track errors
Reasoning about reproduction, isolation, and root cause Bug is hidden by silent success-on-empty → code-hidden-failures --track degradation
Choosing strace/eBPF/perf for system-level investigation Reviewing surrounding code quality once root cause is known → code-review
Documenting hypotheses and binary-searching the failure Refactoring the buggy module after the fix → code-refactor

Core Principles

  1. Occam's Razor - Start with the simplest explanation
  2. Binary Search - Isolate the problem area systematically
  3. Preserve Evidence - Understand state before making changes
  4. Document Hypotheses - Track what was tried and didn't work

Debugging Workflow

1. Understand → What is expected vs actual behavior?
2. Reproduce → Can you trigger the bug reliably?
3. Locate → Where in the code does it happen?
4. Diagnose → Why does it happen? (root cause)
5. Fix → Minimal change to resolve
6. Verify → Confirm fix works, no regressions

Common Bug Patterns

Symptom Likely Cause Check First
TypeError/null Missing null check Input validation
Off-by-one Loop bounds, array index Boundary conditions
Race condition Async timing Await/promise handling
Import error Path/module resolution File paths, exports
Type mismatch Wrong type passed Function signatures
Flaky test Timing, shared state Test isolation

System-Level Tools

Memory Analysis

# Valgrind (C/C++/Rust)
valgrind --leak-check=full --show-leak-kinds=all ./program
valgrind --tool=massif ./program  # Heap profiling

# Python
python -m memory_profiler script.py

Read the full file on GitHub · 189 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 189 lines · 41 tokens per session scan B e8ce270ca50c

Subscribe to this mod's changes

debugging-methodology is a skill published in the GitHub repository laurigates/claude-plugins (57 stars, last pushed today), licensed MIT. It adds 41 tokens to every session and 1,427 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it B with 1 finding (asks for root). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.

Related

Other skills, from other repositories

obsidian-memory-architecture

Use when designing, setting up, or maintaining an Obsidian vault as Hermes Agent's durable knowledge layer. Routes facts, conversation history, documents, procedures, and daily logs to the correct Hermes or vault system without duplicating everything into the prompt.

AtlasOmnia/hermes-custom-pack · 56 tokens

stateless

Inspect and turn off Claude Code's auto memory, the notes Claude writes itself per repo under /.claude/projects/ /memory/. Use when: 'make Claude stateless', 'stop Claude remembering', 'disable auto memory', 'turn off auto-memory', 'purge/clear/delete auto memory', 'wipe what Claude saved about this repo', 'does…

melodic-software/claude-code-plugins · 140 tokens

session-saver

Skill "session-saver" from animalzinc/claude-plugins, covering session saver, task, format requirements, output structure and session log: [yyyy-mm-dd].

animalzinc/claude-plugins · 0 tokens

scan

Proactively hunt unobserved bugs in resting code: a read-only two-stage scan, recall-biased per-lens hunter subagents, then a separate fresh-context default-refute gate, over a target path/feature/diff or a rotated lane, emitting only verified 5-field findings. Use when: 'find a bug', 'bug hunt', 'scan for bugs'…

melodic-software/claude-code-plugins · 244 tokens

iterate-with-itertools

For combinatorial iteration: permutations, combinations, cartesian products, without storing all results in memory.

jimmc414/claude-code-plugin-marketplace · 25 tokens

capture-state-closure

For persistent state: closures capture outer variables, alternative to classes for simple state, factory functions that remember context.

jimmc414/claude-code-plugin-marketplace · 27 tokens