ml-train

Execute PyTorch Lightning and Hydra training runs with monitoring, checkpointing, and W&B integration.

Updated Feb 6, 2026
One-click install
npx skills add https://github.com/nishide-dev/claude-code-ml-research --skill ml-train
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ml-train
Source: https://github.com/nishide-dev/claude-code-ml-research/tree/main/skills/ml-train
Command: npx skills add https://github.com/nishide-dev/claude-code-ml-research --skill ml-train

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you run PyTorch Lightning + Hydra training jobs that start correctly, save useful checkpoints, and surface progress through experiment tracking—so you can iterate faster instead of babysitting runs.

Core Features & Use Cases

  • Execute training with Hydra configs: Runs training using configuration templates (single GPU, multi-GPU, distributed, FSDP) and supports CLI overrides and resuming from checkpoints.
  • Operational monitoring and observability: Supports real-time visibility via Lightning metrics, GPU utilization checks, and W&B dashboards, including logging of losses and learning rate signals.
  • Built-in resilience for common issues: Provides guidance for NaN/inf loss, OOM mitigation (mixed precision, gradient accumulation), overfitting prevention (early stopping), and profiling data-loading bottlenecks.

Quick Start

Run training with the default Hydra experiment template by executing: python src/train.py experiment=basic_training

Frequently Asked Questions about ml-train

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

FAQPage Schema
How do I run PyTorch Lightning training with Hydra configuration overrides?

To run PyTorch Lightning training with Hydra, execute your config-driven entrypoint and pass CLI overrides like experiment=basic_training. This Skill applies Hydra templates to manage single-GPU, multi-GPU, and distributed training settings.

Can I resume a PyTorch Lightning training run from a checkpoint?

Yes, you can resume PyTorch Lightning training from a checkpoint using Hydra configuration overrides. This Skill manages checkpoint loading and continuation so you can recover from interruptions without restarting runs.

Does this approach support distributed multi-node and FSDP training?

Yes, this approach supports distributed multi-node and large-model FSDP training. It uses Lightning trainer settings for device strategy, allowing you to scale training across multiple GPUs and nodes through Hydra configuration templates.

How do I track PyTorch Lightning metrics and GPU utilization during training?

To track PyTorch Lightning metrics and GPU utilization, this Skill integrates Weights and Biases (W&B) for experiment tracking. It logs losses and learning rate signals to W&B dashboards, providing real-time visibility into training progress.

What is the best way to handle NaN loss and OOM errors during PyTorch Lightning training?

The best way to handle NaN loss and OOM errors is using built-in resilience guidance. This Skill provides strategies for mixed precision, gradient accumulation, and early stopping to mitigate memory issues and prevent unstable training runs.

How do I profile data-loading bottlenecks in a distributed training setup?

To profile data-loading bottlenecks, this Skill provides operational monitoring and observability features. It checks GPU utilization and uses Lightning metrics to identify inefficiencies in your distributed training pipeline.