debugging-moonbeam

Debug Moonbeam issues across runtime, EVM, XCM, and RPC layers.

2|Updated Jan 19, 2026
One-click install
npx skills add https://github.com/manuelmauro/moonbeam-skills --skill debugging-moonbeam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugging-moonbeam
Source: https://github.com/manuelmauro/moonbeam-skills/tree/main/skills/debugging-moonbeam
Command: npx skills add https://github.com/manuelmauro/moonbeam-skills --skill debugging-moonbeam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Moonbeam debugging addresses runtime panics, EVM execution failures, XCM message delivery problems, and client-side errors that can derail transactions, block production, or runtime behavior.

Core Features & Use Cases

  • Investigation workflows for common Moonbeam issues spanning runtime, EVM, XCM, and RPC layers.
  • Reproducible debugging steps with best practices to isolate root causes, verify fixes, and prevent regressions.
  • Real-world scenarios including transaction failures, state inconsistencies, and RPC connectivity problems.

Quick Start

Reproduce a Moonbeam issue locally by starting a dev node with verbose logs and following the debugging workflow.

Frequently Asked Questions about debugging-moonbeam

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug Moonbeam runtime panics and EVM transaction failures?

Debug Moonbeam XCM message delivery problems by enabling verbose logging on a local dev node, reproducing the cross-chain message failure, and tracing XCM execution to identify state inconsistencies or delivery errors.

What is the best way to trace XCM message delivery issues on Moonbeam?

Tracing XCM message delivery issues on Moonbeam requires enabling verbose logs, reproducing the cross-chain scenario on a dev node, and following a structured debugging workflow to isolate the failure point.

Why does my Moonbeam RPC connection fail or return unexpected state inconsistencies?

Moonbeam RPC errors and state inconsistencies often stem from client-side connectivity issues or runtime behavior, which can be diagnosed by reproducing the issue locally and tracing the RPC execution path.

Can I reproduce Moonbeam EVM execution failures on a local dev node?

Yes, you can reproduce Moonbeam EVM execution failures locally by starting a dev node with verbose logs enabled and following structured debugging steps to trace the transaction failure and verify fixes.

When do I need to enable verbose logs for Moonbeam debugging?

Enable verbose logs for Moonbeam debugging when investigating runtime panics, EVM execution failures, XCM delivery problems, or RPC errors to capture detailed execution traces needed to isolate root causes.