Tooluck logoTooluck
SKILL.md

hyperpod-issue-report

Agent skill fromawslabs/agent-plugins

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.

How to install hyperpod-issue-report

install hyperpod-issue-report
# install the agent-plugins pack with the skills CLI
npx skills add awslabs/agent-plugins

# or add only this skill to Claude Code: copy the folder

plugins/sagemaker-ai/skills/hyperpod-issue-report/

# into

~/.claude/skills/hyperpod-issue-report/ (all projects)

.claude/skills/hyperpod-issue-report/ (one project)

plugins/sagemaker-ai/skills/hyperpod-issue-report/SKILL.md

Apache-2.0Full file
1# HyperPod Issue Report
2
3Collect 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/hyperpod_issue_report.py` for reliable parallel collection.
4
5## Prerequisites
6
7- AWS CLI configured with permissions: `sagemaker:DescribeCluster`, `sagemaker:ListClusterNodes`, `ssm:StartSession`, `s3:PutObject`, `s3:GetObject`, `eks:DescribeCluster`
8- Python 3.8+ and [uv](https://docs.astral.sh/uv/) (see [uv installation docs](https://docs.astral.sh/uv/getting-started/installation/) for install options)
9- SSM Agent running on target nodes; node IAM roles need `s3:GetObject`/`s3:PutObject` on the report bucket
10- For EKS clusters: kubectl installed and configured (see Workflow step 2)
11
12## Workflow
13
14### 1. Gather Information
15
16Collect from the user:
17
18- **Cluster identifier** (required): accepts cluster name or full cluster ARN (e.g., `arn:aws:sagemaker:us-west-2:123456789012:cluster/abc123`)
19- **AWS region** (required unless extractable from ARN)
20- **S3 path** for report storage (required, e.g. `s3://bucket/prefix`). If the user doesn't have a bucket, create one (e.g., `s3://hyperpod-diagnostics-<account-id>-<region>`)
21- **Issue description** (optional)
22- **Target scope**: all nodes, specific instance groups, or specific node IDs (optional)
23
24### 2. Verify Environment
25
26```bash
27aws sts get-caller-identity
28aws sagemaker describe-cluster --cluster-name <name-or-arn> --region <region>
29```
30…

Excerpt shown under the repository's Apache-2.0 license.

More skills in agent-plugins

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

cathrynlavery /

diagram-design
66k

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

CCCXCUGH1 skill

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates