hyperpod-performance-debugger
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.
Install
With your agent
Install OMGSkills skill "awslabs/agent-plugins:plugins/sagemaker-ai/skills/hyperpod-performance-debugger" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
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.
More from this repo
amplify-workflow
Used to build and deploy full-stack web and mobile apps with AWS Amplify Gen2 (TypeScript code-first).
api-gateway
Build, manage, and operate APIs with Amazon API Gateway (REST, HTTP, and WebSocket).
aws-lambda
Design, build, deploy, test, and debug serverless applications with AWS Lambda.
