awslabs avatar

Hyperpod Performance Debugger

When your HyperPod training run is slower on some nodes than others or checkpoint saves are eating your step time, this skill pulls host-side telemetry without changing anything. It runs a read-only snapshot script via SSM that grabs nvidia-smi state, EFA port health, FSx CloudWatch metrics, dmesg Xids, and NVLink topology, then tells you whether you're looking at a cross-AZ placement issue, a straggler node with thermal problems, or saturated filesystem throughput. It doesn't fix things itself. Instead it routes you to the right sibling skill for remediation: hyperpod-node-debugger for GPU hardware faults, hyperpod-nccl for AllReduce hangs, or hyperpod-version-checker if driver versions have drifted. Useful for diagnosing why identical jobs have different performance profiles across your cluster.

GitHub stars
783
last updated
Jun 11, 2026

Install

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

Installs into .claude/skills of the current project.

Files

HyperPod Performance Debugger

  1. Uneven NCCL performance across nodes — workload faster on some node sets than others, pairwise bandwidth variance, suspected straggler.
  2. Poor filesystem performance — training stalled on data loading, checkpoint save/load dominating step time, FSx throughput saturated.

Scope and delegation

Route findings outside the two in-scope scenarios to the owner skill below.

Sponsors

Details

Repository
github.com/awslabs/agent-plugins
Categories
Git & Pull Requests, AI & Agent Building, Release Management, Debugging
License
Apache-2.0
First seen
Jun 11, 2026

More from awslabs/agent-plugins

All 32
1binjuhor avatarui-ux-pro-maxbinjuhor/shadcn-larFrontend UI/UX design intelligence - activate FIRST when user requests beautiful, stunning, gorgeous, or aesthetic interfaces. The primary skill for design deci0skills.sh installs
2butterbase-ai avatarauth-setupbutterbase-ai/butterbase-skillsThis covers OAuth setup for Google, GitHub, Apple, X, and custom providers, plus JWT lifetime tuning and post-login hooks.0skills.sh installs
3butterbase-ai avatarintegrationsbutterbase-ai/butterbase-skillsUse BEFORE recommending or installing any third-party SaaS SDK for email (Resend, SendGrid, Postmark, Mailgun), SMS (Twilio), messaging (Slack), calendar (Googl0skills.sh installs
4butterbase-ai avatarjourney-schemabutterbase-ai/butterbase-skillsUse as the schema build stage of the Butterbase journey, after journey-plan and journey-preflight. Implements the Tables section of 02-plan.md by delegating to 0skills.sh installs
5callstackincubator avatardogfoodcallstackincubator/agent-skillsSystematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems. Use when asked to "dogfood", "QA", "e0skills.sh installs
6codeaholicguy avatartechnical-writercodeaholicguy/ai-devkitAI DevKit · Review and improve documentation for novice users. Use when users ask to review docs, improve documentation, audit README files, evaluate API docs, 0skills.sh installs