when-debugging-ml-training-use-ml-training-debugger

Diagnose ML training issues across loss divergence, NaN losses, overfitting, and slow convergence.

4|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/DNYoussef/ai-chrome-extension --skill when-debugging-ml-training-use-ml-training-debugger
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: when-debugging-ml-training-use-ml-training-debugger
Source: https://github.com/DNYoussef/ai-chrome-extension/tree/main/.claude/skills/machine-learning/when-debugging-ml-training-use-ml-training-debugger
Command: npx skills add https://github.com/DNYoussef/ai-chrome-extension --skill when-debugging-ml-training-use-ml-training-debugger

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Systematic workflow for debugging ML training, covering loss divergence, NaN losses, overfitting, and slow convergence, with phase-based execution and actionable feedback.

Core Features & Use Cases

  • 5-Phase Process: Diagnose, analyze root cause, apply fixes, validate, and optimize performance.
  • Diagnostic Outputs: Generates diagnostic reports and before/after comparisons.
  • Actionable Fixes: Recommendations for learning rate, regularization, and data handling.

Quick Start

Run the ML Training Debugger on your training script to get a diagnostic report, apply fixes, and compare performance.

Frequently Asked Questions about when-debugging-ml-training-use-ml-training-debugger

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

FAQPage Schema
How do I debug ML training when losses diverge or become NaN?

Loss divergence and NaN losses indicate gradient or data issues. This Skill applies systematic phase-based diagnostics to identify root causes—unstable learning rates, data anomalies, or numerical overflow—and generates actionable fixes for your training pipeline.

What's the best way to diagnose slow convergence in machine learning models?

Slow convergence stems from learning rate mismatch, poor regularization, or data scaling problems. This Skill performs phase-based analysis of gradient health and training dynamics, then recommends optimization adjustments with before-and-after performance comparisons.

How do I fix overfitting during ML model training?

Overfitting occurs when models memorize training data instead of generalizing. This Skill diagnoses the root cause through systematic checks and proposes regularization, data handling, and hyperparameter adjustments tailored to your training code.

Can I get a diagnostic report for my training script without manual debugging?

Yes. This Skill generates diagnostic reports by running a 5-phase workflow—diagnose, analyze root cause, apply fixes, validate, and optimize—on your training script, surfacing issues like gradient problems and convergence bottlenecks automatically.

What training issues does phase-based debugging detect?

Phase-based debugging detects loss divergence, NaN losses, overfitting, slow convergence, and gradient health problems. This Skill orchestrates systematic checks across these phases and returns diagnostic findings plus optimization recommendations for your ML pipeline.