x64dbg-commands-agent
SKILL.md
x64dbg Commands Agent
Scope
Use this skill to turn x64dbg command documentation into concrete MCP workflows for x64dbgMCP. Prioritize deterministic safety wrappers (pause/confirm/rollback) and explicit VA expressions.
References
- Read
references/commands.mdfor command lists, syntax, and wrapper guidance. - Read
references/project-safety-model.mdwhen working in this repository to follow the current elevation and endpoint behavior.
Workflow
- Identify the command category and exact command name from the reference.
- Classify risk before execution:
whitelistread-only command: allow direct execution.dangerouscommand: require explicit confirmation.
- Prefer typed MCP tools over raw command strings for writes (
RegisterSet,MemoryWrite,FlagSet,CmdlineSet,AssemblerAssembleMem,DebugSetBreakpoint,DebugDeleteBreakpoint). - For
ExecCommand/CommandRun, setconfirm=truefor dangerous commands; treat missing-confirm errors as elevation policy failure, not transport failure. - Pause before writes: call
DebugPause(wait=true, timeout_ms=30000)and then execute write operations. - For reads, prefer detailed APIs (for example
MemoryReadDetailed) when partial reads or metadata matter. - For run-to-user flow, prefer
Debug/RunUntilUserCode(wait=true, timeoutMs=30000, pauseFirst=true)and then re-check RIP withDisasmGetInstructionAtRIP.
Safety defaults
- Pause before writes (register/memory/flags/breakpoints/cmdline/assembler).
- Use
confirm=truefor dangerous commands and all write endpoints by default. - Use
dry_runorrequire_confirmfor high-risk workflows and batch operations. - Capture before/after state if values may need rollback.
Notes
- Keep
src/ServerLogic.cppandsrc/x64dbg.pyrisk classification tables in sync when command policy changes. - Keep SKILL.md lean; load reference files only when needed.