sebastianbiallasCommunity·6 Agent Skills Included

pearpc

PowerPC emulator debugging, memory dump analysis, and JIT diagnostics

Diagnoses boot failures, kernel crashes, and JIT compiler bugs inside the PearPC PowerPC emulator. Extracts kernel logs, decodes crash registers, compares memory dumps, and traces CPU dispatch behavior without manual hex inspection. Helps developers find emulator defects faster by automating disassembly, parity checks, and trace analysis.

438|75

↗

npx skills add sebastianbiallas/pearpc --all -g -y

Available:

Gives your AI agent the build steps, directory map, and debugging methodology needed to navigate the PearPC codebase and route debugging requests to the right analysis scripts.

All Skills in This Repository (6)

Pure Emerald Level Indicators

📦 In Repo

sebastianbiallas

analyze-oops

Analyzes PearPC memory dumps to decode pt_regs and disassemble NIP/LR for kernel Oops.

dump-printk

Extract kernel printk messages from a PearPC memory dump.

check-parity

Automate aarch64 JIT parity checks against the generic CPU reference.

compare-dumps

Compare generic and JIT memory dumps to surface divergences.

analyze-jitc-log

Diagnose PPC-to-AArch64 translation issues in jitc.log files.

check-trace

Parses jitc_trace.log to identify boot stalls and crashes from JIT dispatch patterns.

Community

Intermediate

Frequently Asked Questions

FAQPage Schema

How to install PearPC skills?▼

Run `npx skills add sebastianbiallas/pearpc --all -g -y` in your terminal to install all debugging skills globally.

How to debug a kernel crash in PearPC?▼

Use the analyze-oops skill to extract the crash from a memory dump, decode the register state, and disassemble the faulting code automatically.

How to compare JIT and interpreter behavior?▼

The compare-dumps and check-parity skills diff memory regions and audit opcode implementations to find where the JIT diverges from the reference interpreter.

Can these skills diagnose emulator boot stalls?▼

Yes. The check-trace skill analyzes the JIT dispatch trace to identify idle loops, frozen timers, and exception storms that cause boot hangs.

Do I need low-level PowerPC knowledge to use these?▼

No. Your AI agent runs the analysis scripts and interprets the hex addresses, registers, and disassembly for you in plain language.