slurm-debug

Diagnose Slurm job failures by analyzing sacct, scontrol, and logs.

16|4|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/umich-foreseer/lab-claude-config --skill slurm-debug
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: slurm-debug
Source: https://github.com/umich-foreseer/lab-claude-config/tree/main/shared/skills/slurm-debug
Command: npx skills add https://github.com/umich-foreseer/lab-claude-config --skill slurm-debug

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose why a Slurm job failed, was killed, or is stuck pending by analyzing job metadata, logs, and common error patterns to explain the cause and suggest fixes.

Core Features & Use Cases

  • Read and interpret Slurm job details with sacct and scontrol to identify states and exit codes.
  • Inspect StdOut/StdErr logs and common failure messages to determine root causes.
  • Provide actionable remediation steps and guidance for reruns or parameter changes in future submissions.
  • Use Case: When a job exits with an error, this skill guides you to a root cause, recommended resource adjustments, and a resubmission command.

Quick Start

Provide a Slurm JobID or path to logs and I will start diagnosing the issue.

Frequently Asked Questions about slurm-debug

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

FAQPage Schema
How do I diagnose why my Slurm job failed or was killed?

Diagnosing a Slurm job failure involves analyzing job metadata with sacct and scontrol, inspecting StdOut and StdErr logs, and interpreting exit codes to identify the root cause and suggest fixes.

How do I find out why my Slurm job is stuck pending?

To find out why a Slurm job is stuck pending, analyze job metadata and states using sacct and scontrol to identify scheduling blocks, and apply remediation guidance for resubmission.

How do I interpret Slurm job exit codes and error logs?

Interpreting Slurm exit codes and error logs requires inspecting StdOut and StdErr files to match messages against common error patterns, determining root causes and providing actionable remediation steps.

What is the best way to troubleshoot a stalled Slurm job across clusters?

Troubleshooting a stalled Slurm job across clusters requires end-to-end diagnosis using safe Slurm tools like sacct and scontrol, combined with in-depth log analysis to provide actionable remediation guidance.

Do I need to provide specific logs to diagnose a Slurm job failure?

To diagnose a Slurm job failure, you need to provide a Slurm JobID or a path to your logs, enabling the tool to read job details, inspect error logs, and provide actionable remediation steps.