SkillsAdd

smithery/scawful

crash-investigator

Autonomous crash analysis for Mesen2. Captures execution traces upon crash/pause, resolves symbols using z3ed, and generates annotated reports for debugging.

Installation

$ npx skills add smithery/scawful --skill crash-investigator
View on skills.sh ↗ Website ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
azure-diagnostics Same topic
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs
azure-validate Same topic
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs
azure-aigateway Same topic
microsoft/azure-skills

Configure Azure API Management as an AI Gateway for AI models, MCP tools, and agents. WHEN: sem…

566.3K installs
azure-compute Same topic
microsoft/azure-skills

Azure VM/VMSS router. WHEN: create / provision / deploy / spin-up VM, recommend VM size, compar…

510K installs
supabase-postgres-best-practices Same topic
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs

Also in this package

Other skills from smithery/scawful.

npx skills add smithery/scawful
visual-verifier 0 hyrule-navigator 0 code-navigator 0

Browse all from smithery/scawful

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,997 B
  • docs SUMMARY.md 183 B

History

  1. First recorded snapshot · 0 installs

SKILL.md

Crash Investigator

Scope

  • Detection: Monitors Mesen2 for pauses (breakpoints) or manual triggers.
  • Data Capture: Retrieves CPU state (registers) and execution trace (PC history).
  • Analysis: Resolves raw addresses to symbols and source lines using z3ed.
  • Reporting: Generates Markdown reports ready for LLM consumption.

Core Capabilities

1. Manual Dump

Trigger an immediate analysis of the current state.

  • dump: "I just saw a crash, analyze it."

2. Monitoring (The Sentinel)

Run in background to catch intermittent crashes.

  • monitor: Polls emulator state. If it pauses (hit breakpoint/crash), auto-dumps.

3. Trace Blame

Maps the execution history to source code.

  • Uses z3ed rom-resolve-address to turn $07B107 into Link_ResetProperties (Link.asm:45).

Workflow

  1. Start Monitor: crash-investigator monitor.
  2. Repro Bug: Play game until it crashes (CPU JAM / Breakpoint).
  3. Auto-Dump: Tool detects pause, captures trace, resolves symbols.
  4. Review: Read crashreports/crash20260125_120000.md.
  5. Reason: Paste report into LLM: "Why did it crash at Link_Update?"

Dependencies

  • Tool: ~/src/hobby/yaze/scripts/ai/crash_dump.py
  • Mesen2: Must be running with socket server.
  • z3ed: Must be built with symbol support.
  • Symbols: ROM directory must contain .mlb or .sym files.

Example Prompts

  • "Monitor for crashes while I play the dungeon."
  • "Dump the current state; the game is softlocked."
  • "Analyze the last crash report."

Troubleshooting

  • No Trace Data: Ensure Mesen2 trace logging is enabled (internal buffer).
  • No Symbols: Check if .mlb file exists next to ROM. Run z3ed rom-resolve-address to verify.
  • Connection Error: Restart Mesen2.