gearboy-debugging
CommunityDebug Game Boy games with Gearboy MCP.
Authordrhelius
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill helps developers debug and trace Game Boy family games by leveraging the Gearboy MCP server. It provides structured workflows to control execution, inspect the SM83 CPU and hardware, manage breakpoints, read memory, disassemble code, trace instructions, and analyze rendering/timing issues, enabling efficient diagnosis and reverse engineering.
Core Features & Use Cases
- Control execution: pause, step, and breakpoints across GB/GBC/SGB using the MCP server.
- Inspect hardware state: read CPU registers, LCD, APU, SGB, and memory areas.
- Disassembly & tracing: disassemble code, view call stacks, set breakpoints, and capture trace logs.
- Time travel debugging: rewind snapshots to compare states and verify fixes.
- Use cases: debugging homebrew, reverse engineering game logic, diagnosing graphics or audio issues.
Quick Start
Launch Gearboy as an MCP server, connect your AI client, load a ROM, then pause or step to begin debugging.
Dependency Matrix
Required Modules
curlunzip
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: gearboy-debugging Download link: https://github.com/drhelius/Gearboy/archive/main.zip#gearboy-debugging Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.