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.