nemo-mbridge-perf-moe-optimization-workflow

Diagnose MoE training throughput bottlenecks using the Three Walls framework.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill nemo-mbridge-perf-moe-optimization-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nemo-mbridge-perf-moe-optimization-workflow
Source: https://github.com/sayalinvidia/sayali-skills-test/tree/main/skills/Megatron-Bridge/nemo-mbridge-perf-moe-optimization-workflow
Command: npx skills add https://github.com/sayalinvidia/sayali-skills-test --skill nemo-mbridge-perf-moe-optimization-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This workflow provides a structured approach to diagnose and improve throughput for MoE training on Megatron Bridge, addressing memory, communication, and compute bottlenecks.

Core Features & Use Cases

  • Phase-driven optimization using the Three Walls framework to guide memory, communication, and compute improvements.
  • Parallel Folding decouples attention and MoE parallelism, enabling scalable multi-GPU configurations.
  • Dispatcher selection, FP8 mapping guidance, and CUDA graph considerations to accelerate MoE workloads across hardware (e.g., Hopper and Blackwell).
  • Use cases include diagnosing throughput regressions after commits and performing end-to-end MoE throughput tuning sweeps.

Quick Start

Initiate a three-phase MoE optimization by guiding the agent through fit, scale, profile, and retune steps using the Parallel Folding meshes and recommended dispatcher and FP8 mappings.

Frequently Asked Questions about nemo-mbridge-perf-moe-optimization-workflow

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

FAQPage Schema
How do I optimize MoE training throughput in Megatron Bridge?

MoE training throughput in Megatron Bridge is optimized using a three-phase workflow: fit, scale, profile, and retune. This process targets memory, communication, and compute bottlenecks using the Three Walls framework and Parallel Folding meshes.

What is the Three Walls framework for MoE throughput tuning?

The Three Walls framework is a diagnostic model that categorizes MoE training performance bottlenecks into memory, communication, and compute limits. It guides phase-specific optimization recommendations to systematically resolve throughput constraints.

Does Megatron Bridge support FP8 and CUDA graphs for MoE workloads?

Yes, the workflow provides explicit FP8 mapping guidance and CUDA graph considerations for MoE workloads. These features are designed to accelerate training across supported hardware platforms, including Hopper and Blackwell architectures.

How does Parallel Folding improve multi-GPU MoE training scalability?

Parallel Folding decouples attention and MoE parallelism, enabling scalable multi-GPU configurations. By separating these parallelism dimensions, it allows more flexible and efficient resource utilization during training.

Why did my MoE training throughput drop after recent commits?

Throughput regressions in MoE training can be diagnosed by running the workflow's profile and retune phases. These steps identify whether the bottleneck stems from memory, communication, or compute changes introduced by the new code.

Can I use this MoE optimization workflow on both Hopper and Blackwell platforms?

Yes, this workflow provides specific optimization guidance for both Hopper and Blackwell platforms. It includes hardware-aware recommendations for dispatcher selection, FP8 mappings, and CUDA graphs to maximize throughput on either architecture.