mma-debug

Automate cross-file debugging of failing tests and broken builds.

5|4|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/zhixuan312/multi-model-agent --skill mma-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mma-debug
Source: https://github.com/zhixuan312/multi-model-agent/tree/main/packages/server/src/skills/mma-debug
Command: npx skills add https://github.com/zhixuan312/multi-model-agent --skill mma-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic cross-file debugging across modules to isolate root causes when tests fail, builds break, or runtime behavior is unexpected, keeping the main hypothesis intact.

Core Features & Use Cases

  • Cross-file investigation: Reads, reproduces, and traces failures across multiple files and components.
  • Hypothesis-driven debugging: Delegates investigative work to a worker while the main agent focuses on the hypothesis and decisions.
  • Isolated worker context: Each task runs in an isolated context to avoid polluted results and ensure reproducibility.

Quick Start

Provide a failing test, reproduction steps, and affected files to the worker to initiate cross-file debugging.

Frequently Asked Questions about mma-debug

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

FAQPage Schema
How do I debug failing tests that span multiple files and modules?

Cross-file debugging automates reading, reproducing, and tracing failures across multiple files using a worker-based hypothesis workflow to isolate root causes. It delegates investigative work to an isolated worker while the main agent focuses on decisions.

What is the best way to trace broken builds across different components?

Tracing broken builds across components is handled by a hypothesis-driven workflow that delegates investigative tasks to an isolated worker. This systematic approach keeps the main hypothesis intact while reproducing symptoms and reading affected files.

When do I need hypothesis-driven debugging for my test suite?

Hypothesis-driven debugging is needed when failures span more than one file or component, requiring cross-file reasoning and reproduction. It coordinates reading files and tracing across modules to isolate the root cause of unexpected runtime behavior.

How do I set up cross-file debugging for a failing test?

To start cross-file debugging, provide a failing test, reproduction steps, and affected files to the worker. The worker runs in an isolated context to investigate symptoms and trace the root cause without polluting results.

Does isolated worker context prevent context pollution during debugging?

Isolated worker context ensures reproducibility and avoids polluted results during debugging. Each investigative task runs independently, allowing the main agent to maintain a clean hypothesis while tracing failures across multiple modules.

What are the limitations of automated cross-file debugging?

Automated cross-file debugging requires clear reproduction steps and affected files to function effectively. Without accurate initial inputs for the failing test, the isolated worker may struggle to trace the root cause across modules.