# hyperpod-issue-report

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

Generate comprehensive issue reports from HyperPod clusters (EKS and Slurm) by collecting diagnostic logs and configurations for troubleshooting and AWS Support cases. Use when users need to collect diagnostics from HyperPod cluster nodes, generate issue reports for AWS Support, investigate node failures or performance problems, document cluster state, or create diagnostic snapshots. Triggers on requests involving issue reports, diagnostic collection, support case preparation, or cluster troubleshooting that requires gathering logs and system information from multiple nodes.

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-issue-report ~/.claude/skills/hyperpod-issue-report
```

## From README

HyperPod Issue Report Collect diagnostic logs from HyperPod cluster nodes via SSM, store results in S3. Supports both EKS and Slurm clusters with auto-detection. Uses the bundled scripts/hyperpodissuereport.py for reliable parallel collection. Prerequisites AWS CLI configured with permissions: sagemaker:DescribeCluster, sagemaker:ListClusterNodes, ssm:StartSession, s3:PutObject, s3:GetObject, eks:DescribeCluster Python 3.8+ and uv (see uv docs for options) SSM Agent running on target nodes; node IAM roles need s3:GetObject/s3:PutObject on the report bucket For EKS clusters: kubectl installed and configured (see Workflow step 2) Workflow Gather Information Collect from the user: Cluster identifier (required): accepts cluster name or full cluster ARN (e.g., arn:aws:sagemaker:us-west-2:123456789012:cluster/abc123) AWS region (required unless extractable from ARN) S3 path for report storage (required, e.g. s3://bucket/prefix).

## Links

- HTML page: https://omgskills.com/library/awslabs/agent-plugins/plugins/sagemaker-ai/skills/hyperpod-issue-report/
- 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