job-log-triage

Triage MaxText training job logs to identify status and failure modes.

29|3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/AMD-AGI/maxtext-slurm --skill job-log-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: job-log-triage
Source: https://github.com/AMD-AGI/maxtext-slurm/tree/main/skills/job-log-triage
Command: npx skills add https://github.com/AMD-AGI/maxtext-slurm --skill job-log-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage and diagnose MaxText training job logs to quickly identify status, failures, and recommended next steps.

Core Features & Use Cases

  • Log-based triage: Determine whether a job is running, hanging, failed, or completed by analyzing outputs in outputs/, ray_logs/, and Slurm summaries.
  • Signatures & recommendations: Detect common failure modes (timeouts, NCCL/NCCL, OOM, checkpoints) and propose concrete actions.
  • Cross-view analysis: Correlate Slurm logs with per-worker logs to validate training progress and diagnose stalls.

Quick Start

Triage a specific job's logs to determine whether it is running, hanging, or failed.

Frequently Asked Questions about job-log-triage

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

FAQPage Schema
How do I diagnose MaxText training job logs to identify failures?

Diagnose MaxText training job logs by parsing JOB SUMMARY blocks, completed step lines, and failure signatures from outputs/, ray_logs/, and Slurm summaries to identify stalls, timeouts, NCCL errors, or OOM. It correlates Slurm logs with per-worker logs to validate progress and recommend next steps.

What is the best way to check if a Slurm training job is hanging or completed?

Checking if a Slurm training job is hanging or completed involves locating log files, outputs/, and per-job artifacts to determine progress. By parsing JOB SUMMARY blocks and completed step lines, you can verify whether the job is running, hanging, failed, or successfully completed.

Can I use log triage for Ray runs with RAY=0 or RAY=1?

Log triage applies to both RAY=0 and RAY=1 configurations for local and Slurm runs. It locates ray_logs/ and per-job artifacts to analyze training progress, parse step lines, and detect failure modes regardless of the Ray execution mode.

How do I detect NCCL and OOM timeout errors in training logs?

Detect NCCL and OOM timeout errors in training logs by scanning for common failure signatures within the log files. The triage process identifies these specific error patterns and proposes concrete actions to resolve the hardware communication or memory issues.

Why does my MaxText job stall without explicit error messages?

MaxText job stalls without explicit error messages often indicate silent failures detected by cross-view analysis. Correlating Slurm logs with per-worker logs validates actual training progress and diagnoses stalls by checking completed step lines and JOB SUMMARY blocks.