Hyperpod Node Debugger

When a single node in your HyperPod cluster goes down or starts acting weird, this is your triage tool. It walks you through diagnosing GPU hardware failures (XIDs, ECC errors, row-remap issues), EFA and security group misconfigurations, Slurm node states, disk pressure, SSM agent problems, and pod networking. The workflow is read-only: it runs diagnostics, points you to the relevant section in its reference docs, then shows you the exact commands to fix it. You approve each destructive action yourself. It explicitly won't touch cluster-wide problems, NCCL tuning, or model flop utilization, which have their own dedicated skills. If you're managing p5 or Trn instances at scale and one node is misbehaving, this gives you a structured checklist instead of guessing.

GitHub stars: 783
last updated: Jun 11, 2026

View on GitHub

Install

$ npx -y skills add awslabs/agent-plugins --skill hyperpod-node-debugger --agent claude-code

Installs into .claude/skills of the current project.

Files

HyperPod Node Debugger

Operating policy. Run read-only diagnostics yourself. Never run a command that changes cluster, node, or workload state — present each one as a Suggested command (run this yourself) block and wait for the customer. Destructive order: investigate → reboot → replace (replace destroys root + secondary volumes; not supported on Slurm controller nodes). Never discard training state, logs, or caches on speculation.

SKILL.md on GitHub

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly