ml-training-pipeline

Set up distributed PyTorch training pipelines with DDP, bf16, and checkpointing.

Updated Feb 23, 2026
One-click install
npx skills add https://github.com/rishikanthc/ml-superpowers --skill ml-training-pipeline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ml-training-pipeline
Source: https://github.com/rishikanthc/ml-superpowers/tree/main/skills/ml-training-pipeline
Command: npx skills add https://github.com/rishikanthc/ml-superpowers --skill ml-training-pipeline

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a concise, production-oriented blueprint to prevent silent failures and wasted compute during model training by enforcing correct data pipelines, distributed verification, mixed-precision, and rigorous checkpointing.

Core Features & Use Cases

  • DDP-first verification: Start with single-node multi-GPU DDP verification (e.g., torchrun overfit-one-batch) to catch distributed bugs locally before scaling.
  • Mixed precision and checkpointing: Enable bf16 mixed precision from day one and always save model, optimizer, scheduler, step, and RNG states with verified reloads to ensure training continuity.
  • Scaling guidance and guardrails: Clear decision rules for when to adopt multi-node DDP or FSDP, plus a DDP silent-failure checklist covering logging, checkpoint rank, effective batch size, and seed handling.

Quick Start

Launch a two-GPU DDP training run with bf16 mixed precision, checkpointing every 500 steps, and verify overfit-one-batch succeeds.

Frequently Asked Questions about ml-training-pipeline

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

FAQPage Schema
How do I set up distributed training in PyTorch with checkpointing?

Set up distributed training in PyTorch by starting with single-node multi-GPU DDP verification using torchrun, enabling bf16 mixed precision, and saving model, optimizer, scheduler, step, and RNG states to ensure training continuity.

When should I switch from DDP to FSDP for PyTorch training?

Switch from DDP to FSDP only when DDP provably triggers out-of-memory errors. This Skill provides explicit guardrails and decision rules for adopting FSDP in your distributed training pipeline.

What is the best way to verify a PyTorch distributed training pipeline?

The best way to verify a distributed training pipeline is to run an overfit-one-batch test locally using single-node DDP before scaling, catching silent failures related to logging, checkpoint rank, effective batch size, and seed handling early.

How does mixed precision checkpointing work in PyTorch?

Mixed precision checkpointing in PyTorch enables bf16 from day one and saves model, optimizer, scheduler, step, and RNG states with verified reloads, preserving training continuity and preventing silent failures during distributed model training.

Why does my PyTorch DDP training fail silently?

PyTorch DDP training fails silently due to incorrect logging, improper checkpoint rank handling, mismatched effective batch sizes, or poor seed handling. Use a dedicated silent-failure checklist to verify these components during setup.

Can I use torchrun for multi-node DDP verification?

Yes, you can use torchrun for multi-node DDP, but the recommended approach is to first verify overfit-one-batch succeeds on single-node multi-GPU DDP to catch distributed bugs locally before scaling to multi-node training.