Dbg
theodo-group/debug-that
Debug applications using the dbg CLI debugger. An agent skill from theodo-group/debug-that.
Instrument programs (Python, C/C++, Java) to capture snapshots of key program states at runtime, including variables, memory, and call stacks.
$ npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ArabelaTso/Skills-4-SE state-snapshot-instrumenter --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/state-snapshot-instrumenter .claude/skills/state-snapshot-instrumenter && rm -rf skills-srcUse ~/.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/
Install the "state-snapshot-instrumenter" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/state-snapshot-instrumenter into .claude/skills/state-snapshot-instrumenter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-snapshot-instrumenter", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/state-snapshot-instrumenterType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ArabelaTso/Skills-4-SE state-snapshot-instrumenter --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/state-snapshot-instrumenter .agents/skills/state-snapshot-instrumenter && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "state-snapshot-instrumenter" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/state-snapshot-instrumenter into .agents/skills/state-snapshot-instrumenter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-snapshot-instrumenter", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ArabelaTso/Skills-4-SE state-snapshot-instrumenter --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/state-snapshot-instrumenter .cursor/skills/state-snapshot-instrumenter && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "state-snapshot-instrumenter" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/state-snapshot-instrumenter into .cursor/skills/state-snapshot-instrumenter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-snapshot-instrumenter", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ArabelaTso/Skills-4-SE.git --path skills/state-snapshot-instrumenter--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ArabelaTso/Skills-4-SE state-snapshot-instrumenter --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/state-snapshot-instrumenter .gemini/skills/state-snapshot-instrumenter && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "state-snapshot-instrumenter" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/state-snapshot-instrumenter into .gemini/skills/state-snapshot-instrumenter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-snapshot-instrumenter", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ArabelaTso/Skills-4-SE state-snapshot-instrumenterInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/state-snapshot-instrumenter .github/skills/state-snapshot-instrumenter && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "state-snapshot-instrumenter" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/state-snapshot-instrumenter into .github/skills/state-snapshot-instrumenter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-snapshot-instrumenter", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ArabelaTso/Skills-4-SE state-snapshot-instrumenter --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArabelaTso/Skills-4-SE.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/state-snapshot-instrumenter .opencode/skills/state-snapshot-instrumenter && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "state-snapshot-instrumenter" agent skill from https://github.com/ArabelaTso/Skills-4-SE/tree/main/skills/state-snapshot-instrumenter into .opencode/skills/state-snapshot-instrumenter/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "state-snapshot-instrumenter", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
state-snapshot-instrumenterInstrument programs (Python, C/C++, Java) to capture snapshots of key program states at runtime, including variables, memory, and call stacks.
State Snapshot Instrumenter is an agent skill from ArabelaTso/Skills-4-SE. Instrument programs (Python, C/C++, Java) to capture snapshots of key program states at runtime, including variables, memory, and call stacks. Use when you need to debug complex issues, reproduce test cases, prepare traces for formal verification, or analyze program execution. Supports manual instrumentation points, automatic function/method instrumentation, and conditional triggers. Outputs structured JSON snapshots for debugging, replay, and verification workflows.
Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including scripts, reference files and assets (for example `assets/example_python.py`, `assets/snapshot_schema.json` and `references/instrumentation_guide.md`).
It sits in Development, covering Test generation and Debugging. It works with C++, Java and Python. The repository describes itself as: A curated list of 180+ useful Claude Skills for Software Engineering and resources for customizing AI for SE workflows. The licence is Apache-2.0.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 4f38503. It shows what the files ask for, not the result of running them.
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.
Ships 8 files in scripts/ (Python and Java), which the agent can run.
Shell commands in SKILL.md call:
pythonjavacjavaFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
State Snapshot Instrumenter loads about 2.2k tokens when it runs, and up to ~7.3k if it reads all its reference files. Until then it costs about 125 tokens; SKILL.md has 423 words of instructions outside code blocks.
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.
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); the scripts in this folder are not scanned.
The full file from ArabelaTso/Skills-4-SE at commit 4f38503, republished under its Apache-2.0 licence (© ArabelaTso). 423 words, ~2,219 tokens.
.claude/skills/state-snapshot-instrumenter/SKILL.md (or your agent's skills folder). This skill also uses 15 other files; get the full folder from GitHub.This skill instruments programs to capture snapshots of key program states at runtime. Snapshots include variable values, memory state, call stacks, and execution context, saved in structured JSON format for analysis, debugging, reproduction, and verification.
# 1. Add markers to your code
# def my_function(x):
# __SNAPSHOT__("my_function:start")
# result = x * 2
# __SNAPSHOT__("my_function:end")
# return result
# 2. Instrument the code
python scripts/instrument_python.py my_program.py --mode manual
# 3. Run instrumented program
python my_program_instrumented.py
# Snapshots saved to snapshots.json
# 4. Analyze snapshots
python scripts/analyze_snapshots.py snapshots.json --list# 1. Add markers to your code
# int main() {
# __SNAPSHOT__("main:start");
# int x = 10;
# __SNAPSHOT__("main:end");
# return 0;
# }
# 2. Instrument the code
python scripts/instrument_c.py program.c --mode manual
# 3. Compile with runtime
gcc program_instrumented.c scripts/snapshot_runtime.c -o program -rdynamic
# 4. Run and analyze
./program
python scripts/analyze_snapshots.py snapshots.json --list# 1. Add markers to your code
# public static void main(String[] args) {
# __SNAPSHOT__("main:start");
# int x = 10;
# __SNAPSHOT__("main:end");
# }
# 2. Instrument the code
python scripts/instrument_java.py Program.java --mode manual
# 3. Compile and run
cp scripts/SnapshotRuntime.java snapshot/
javac snapshot/SnapshotRuntime.java
javac Program_instrumented.java
java Program_instrumented
# 4. Analyze
python scripts/analyze_snapshots.py snapshots.json --listAdd explicit __SNAPSHOT__("location") markers at specific points in your code.
Python:
def process_data(items):
__SNAPSHOT__("process_data:entry")
result = []
for item in items:
__SNAPSHOT__("loop_iteration")
result.append(item * 2)
__SNAPSHOT__("process_data:exit")
return resultC/C++:
int calculate(int x, int y) {
__SNAPSHOT__("calculate:entry");
int result = x + y;
__SNAPSHOT__("calculate:exit");
return result;
}Java:
public int calculate(int x, int y) {
__SNAPSHOT__("calculate:entry");
int result = x + y;
__SNAPSHOT__("calculate:exit");
return result;
}Instrument:
python scripts/instrument_python.py file.py --mode manual
python scripts/instrument_c.py file.c --mode manual
python scripts/instrument_java.py file.java --mode manualAutomatically instrument all function/method entry and exit points.
python scripts/instrument_python.py file.py --mode auto
python scripts/instrument_c.py file.c --mode auto
python scripts/instrument_java.py file.java --mode autoThis captures state at every function boundary without manual markers.
Python:
# Manual mode
python scripts/instrument_python.py input.py --mode manual -o output.py
# Automatic mode
python scripts/instrument_python.py input.py --mode auto -o output.py
# In-place modification
python scripts/instrument_python.py input.py --mode manual --inplaceC/C++:
# Instrument
python scripts/instrument_c.py input.c --mode manual -o output.c
# Compile with runtime
gcc output.c scripts/snapshot_runtime.c -o program -rdynamic
# Run with custom output file
SNAPSHOT_OUTPUT=my_snapshots.json ./programJava:
# Instrument
python scripts/instrument_java.py Input.java --mode manual -o Output.java
# Setup runtime
cp scripts/SnapshotRuntime.java snapshot/
javac snapshot/SnapshotRuntime.java
# Compile and run
javac Output.java
SNAPSHOT_OUTPUT=my_snapshots.json java OutputList all snapshots:
python scripts/analyze_snapshots.py snapshots.json --listShow detailed snapshot:
python scripts/analyze_snapshots.py snapshots.json --show 5View execution timeline:
python scripts/analyze_snapshots.py snapshots.json --timelineTrack variable changes:
python scripts/analyze_snapshots.py snapshots.json --track-var "user_id"Compare two snapshots:
python scripts/analyze_snapshots.py snapshots.json --compare 10 20Filter snapshots:
# By location
python scripts/analyze_snapshots.py snapshots.json --filter-location "main"
# By type
python scripts/analyze_snapshots.py snapshots.json --filter-type "function_entry"Python:
import snapshot_runtime
# Disable snapshots temporarily
snapshot_runtime.disable()
# ... performance-critical code ...
snapshot_runtime.enable()
# Set custom output file
snapshot_runtime.set_output_file("custom.json")
# Manually save snapshots
snapshot_runtime.save_snapshots()C/C++:
#include "snapshot_runtime.h"
snapshot_disable();
// ... performance-critical code ...
snapshot_enable();
snapshot_finalize(); // Manually saveJava:
import snapshot.SnapshotRuntime;
SnapshotRuntime.disable();
// ... performance-critical code ...
SnapshotRuntime.enable();
SnapshotRuntime.setOutputFile("custom.json");
SnapshotRuntime.saveSnapshots();Capture comprehensive state to understand complex bugs:
See references/use_cases.md for detailed debugging workflows.
Extract exact inputs and state to reproduce failures:
See references/use_cases.md for reproduction workflows.
Generate execution traces for verification tools:
See references/use_cases.md for verification workflows.
references/instrumentation_guide.md - Comprehensive guide on instrumenting programs, including language-specific instructions, best practices, and troubleshootingreferences/snapshot_format.md - Complete specification of the JSON snapshot format, including language-specific variations and serialization rulesreferences/use_cases.md - Detailed workflows for debugging, reproduction, verification, performance analysis, and concurrency debuggingExample instrumented programs are provided in assets/:
example_python.py - Python example with manual snapshotsexample_c.c - C example with manual snapshotsexample_java.java - Java example with manual snapshotsAll snapshots are saved in unified JSON format:
{
"format_version": "1.0",
"language": "python",
"total_snapshots": 5,
"snapshots": [
{
"snapshot_id": 1,
"timestamp": "2026-02-17T19:30:45",
"location": "main:start",
"type": "manual",
"call_stack": [...],
"local_variables": {...}
}
]
}See assets/snapshot_schema.json for the complete JSON schema.
SNAPSHOT_OUTPUT environment variable© ArabelaTso, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 15 other files (scripts, references, assets) in skills/state-snapshot-instrumenter of ArabelaTso/Skills-4-SE.
Open the folder on GitHubat commit 4f38503
State Snapshot Instrumenter 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| State Snapshot Instrumenter this skillArabelaTso/Skills-4-SE | 253 | — | ~2.2k | Automated safety check: Pass | Apache-2.0 | |
| Dbgtheodo-group/debug-that | 158 | — | ~2.5k | Automated safety check: Pass | MIT | |
| OpenROAD Bug FixerThe-OpenROAD-Project/OpenROAD | 3.2k | — | ~784 | Automated safety check: Pass | BSD-3-Clause | |
| Git History Bug Auditben-manes/caffeine | 18k | — | ~3.3k | Automated safety check: Pass | Apache-2.0 | |
| MCP Debuggerdebugmcp/mcp-debugger | 174 | — | ~4.2k | Automated safety check: Pass | MIT | |
| Ue Live DebuggingJasonMa0012/MooaToon | 750 | — | ~2.9k | Automated safety check: Notes | Custom licence |
theodo-group/debug-that
Debug applications using the dbg CLI debugger. An agent skill from theodo-group/debug-that.
The-OpenROAD-Project/OpenROAD
Fixes an OpenROAD bug from a GitHub issue or error code: finds the root cause, implements the fix, adds a regression test and prepares a signed-off commit.
ben-manes/caffeine
Audits a module by walking its git history commit by commit, tracking unresolved issues forward, and reporting the ones that survive to HEAD as findings.
debugmcp/mcp-debugger
A skill your agent uses when investigating a bug, failing test, or unexpected runtime behavior and the mcp-debugger MCP server is available — drives real step-through debuggers (breakpoints, stack…
JasonMa0012/MooaToon
A skill your agent uses when debugging UE C++ crashes, runtime bugs, or unexpected behavior with Rider MCP available.
HoangTheQuyen/think-better
Structured coding workflow for non-trivial code work: debug, build features, refactor, optimize, migrate and review code through 7 steps with evidence-based quality gates.
ArabelaTso/Skills-4-SE
Generate prioritized CVE watchlists and actionable security recommendations for repositories.
ArabelaTso/Skills-4-SE
Automatically migrate Python web applications between frameworks (Flask → FastAPI, Django → FastAPI).
ArabelaTso/Skills-4-SE
Generate test cases using metamorphic testing by applying transformations based on metamorphic properties.
ArabelaTso/Skills-4-SE
Instruments programs to capture execution traces specifically for reproducing reported bugs, enabling consistent replay and diagnosis of failures.
ArabelaTso/Skills-4-SE
Automatically migrate Spring MVC applications to Spring Boot.
ArabelaTso/Skills-4-SE
Instruments code to track the flow of untrusted or sensitive data at runtime, enabling detection of injection vulnerabilities, data leaks, and privilege violations.
Categories
Instrument programs (Python, C/C++, Java) to capture snapshots of key program states at runtime, including variables, memory, and call stacks. State Snapshot Instrumenter is an agent skill from ArabelaTso/Skills-4-SE. Instrument programs (Python, C/C++, Java) to capture snapshots of key program states at runtime, including variables, memory, and call stacks.
State Snapshot Instrumenter fits situations like: you need to debug complex issues; reproduce test cases; prepare traces for formal verification; analyze program execution.
Run `npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a claude-code`. Or copy the skill folder (skills/state-snapshot-instrumenter in ArabelaTso/Skills-4-SE) into .claude/skills/state-snapshot-instrumenter in your project. Claude Code loads it when a task matches its description.
Run `npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a codex`. Or copy the skill folder (skills/state-snapshot-instrumenter in ArabelaTso/Skills-4-SE) into .agents/skills/state-snapshot-instrumenter in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ArabelaTso/Skills-4-SE --skill state-snapshot-instrumenter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/state-snapshot-instrumenter, .gemini/skills/state-snapshot-instrumenter, .github/skills/state-snapshot-instrumenter and .opencode/skills/state-snapshot-instrumenter in your project.
Going by SKILL.md and its folder, State Snapshot Instrumenter needs Python and Java for the scripts in its folder and the command-line tools its instructions call (python, javac and java). Our summary lists: Python 3.
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.
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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
State Snapshot Instrumenter is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.2k tokens (SKILL.md is roughly 8.9k 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 5.1k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with State Snapshot Instrumenter: Dbg (theodo-group/debug-that, 158 stars), OpenROAD Bug Fixer (The-OpenROAD-Project/OpenROAD, 3.2k stars), Git History Bug Audit (ben-manes/caffeine, 18k stars) and MCP Debugger (debugmcp/mcp-debugger, 174 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
ArabelaTso (a GitHub user) maintains it in ArabelaTso/Skills-4-SE, which has 253 GitHub stars. The repository holds 170 skills in this directory. The repository was last updated on August 21, 2026.
Source: ArabelaTso/Skills-4-SE on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.