# hyperpod-performance-debugger

> Claude/Codex skill by [@awslabs](https://omgskills.com/library/awslabs/index.md) · 927 stars · Updated 2026-10-15

Diagnose performance issues on Amazon SageMaker HyperPod clusters — uneven NCCL bandwidth across nodes and poor filesystem throughput. Read-only. Surfaces host-side signals (Xid, ECC, NVLink, EFA reachability, FSx saturation) and routes to the appropriate sibling skill (hyperpod-node-debugger, hyperpod-nccl, hyperpod-version-checker, hyperpod-issue-report) for any remediation. Triggers on uneven NCCL across nodes, straggler node, FSx slow, checkpoint slow, dataloader slow, filesystem bottleneck, FSx throughput, cross-AZ latency, topology mismatch.

Tags: agent-plugins, agent-skills, agents, aws, coding-agent-skills, coding-agents

## Install

```sh
git clone https://github.com/awslabs/agent-plugins /tmp/agent-plugins && ln -s /tmp/agent-plugins/plugins/sagemaker-ai/skills/hyperpod-performance-debugger ~/.claude/skills/hyperpod-performance-debugger
```

## From README

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.

## Links

- HTML page: https://omgskills.com/library/awslabs/agent-plugins/plugins/sagemaker-ai/skills/hyperpod-performance-debugger/
- GitHub: https://github.com/awslabs/agent-plugins
- Author: [@awslabs](https://omgskills.com/library/awslabs/index.md)

## More from this repo

- [amplify-workflow](https://omgskills.com/library/awslabs/agent-plugins/plugins/aws-amplify/skills/amplify-workflow/index.md) — Used to build and deploy full-stack web and mobile apps with AWS Amplify Gen2 (TypeScript code-first).
   - [@awslabs](https://omgskills.com/library/awslabs/index.md) · 933 stars
- [api-gateway](https://omgskills.com/library/awslabs/agent-plugins/plugins/aws-serverless/skills/api-gateway/index.md) — Build, manage, and operate APIs with Amazon API Gateway (REST, HTTP, and WebSocket).
   - [@awslabs](https://omgskills.com/library/awslabs/index.md) · 933 stars
- [aws-lambda](https://omgskills.com/library/awslabs/agent-plugins/plugins/aws-serverless/skills/aws-lambda/index.md) — Design, build, deploy, test, and debug serverless applications with AWS Lambda.
   - [@awslabs](https://omgskills.com/library/awslabs/index.md) · 933 stars