
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-codeInstalls into .claude/skills of the current project.
Files
HyperPod Performance Debugger
- Uneven NCCL performance across nodes — workload faster on some node sets than others, pairwise bandwidth variance, suspected straggler.
- 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- Hyperpod Slurm Debugger
- Model Selection
- Sdk Getting Started
- Aws Architecture Diagram358
- Aws Lambda260
- Deploy240
- Directory Management183
- Use Case Specification183
- Planning168
- Dataset Evaluation156
- Aws Serverless Deployment154
- Finetuning154
- Model Deployment154
- Dataset Transformation153
- Hyperpod Ssm150
- Hyperpod Version Checker149
- Hyperpod Issue Report147
- Model Evaluation140
- Amplify Workflow101
- Amazon Location Service
- Api Gateway
- Aws Lambda Durable Functions
- Aws Lambda Managed Instances
- Aws Transform