rocm-doctor

rocm-doctor is a skill for Claude Code, Codex from amd/skills. It costs 258 tokens per session (2,264 once invoked), scanned C, original, MIT.

A diagnostic guide for broken ROCm, HIP, PyTorch, or llama.cpp setups on AMD GPUs running native Linux or Windows. ROCm and HIP are AMD software layers used to run GPU applications.

In plain words
What is it for?
Use it when AMD GPU software or supported AI tools are not working. It can investigate and, when appropriate, fix issues involving ROCm, HIP, PyTorch, or llama.cpp.
Why use it?
It narrows a reported problem to a known configuration issue and can apply a low-risk fix with consent. If the symptom is outside its known list or platform scope, it gives the appropriate next step instead of guessing.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it when AMD GPU software or supported AI tools are not working. It can investigate and, when appropriate, fix issues involving ROCm, HIP, PyTorch, or llama.cpp.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/amd/skills/rocm-doctor
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add amd/skills --skill rocm-doctor
Clone the repo
git clone --depth 1 https://github.com/amd/skills

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for rocm-doctor

README.md
[![agentmods](https://agentmods.dev/badge/skills/amd/skills/rocm-doctor.svg)](https://agentmods.dev/skills/amd/skills/rocm-doctor)
Your own site
<a href="https://agentmods.dev/skills/amd/skills/rocm-doctor"><img src="https://agentmods.dev/badge/skills/amd/skills/rocm-doctor.svg" alt="Measured on agentmods" height="20"></a>
Per session 258 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,264 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00258 $0.02264
Opus 5 $0.00129 $0.01132
Sonnet 5 $0.00052 $0.00453
Haiku 4.5 $0.00026 $0.00226

Measured 7d ago against content hash 0c763034dbe3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade C, and why

rocm-doctor scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 7d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Downloads and executes remote codehighSupply chain

curl | sh runs whatever the server returns today, which is not necessarily what it returned when this was reviewed.

curl -fsSL https://raw.githubusercontent.com/ROCm/rocm-cli/main/install.sh | sh -s -- nightly

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

curl -fsSL https://raw.githubusercontent.com/ROCm/rocm-cli/main/install.sh | sh -s -- nightly
staging/rocm-doctor/SKILL.md · 181 lines

How it starts

The opening of the file, as written. The whole thing — 181 lines — stays where its author put it; the contents beside it link to each section on GitHub.

ROCm Doctor

Given a "ROCm / PyTorch / llama.cpp isn't working on my AMD GPU" complaint, identify which known misconfiguration is the cause and either fix it (with consent) or hand back the exact next step.

This skill does not probe or reason on its own. The rocm CLI owns the probe, the closed failure-mode catalog, and the fixes; the skill just drives it and relays the results. The catalog is a closed list — if the symptom doesn't match a known mode, route the user upstream instead of guessing.

Scope gate — check before anything else

Read the user's symptom and answer one question first: is this an AMD GPU on native Linux or Windows?

If it is not — an NVIDIA / Intel / Apple GPU, or anything running under WSL2 — then stop and decline:

  • Say plainly that it is out of scope for this skill and why (not an AMD GPU / WSL2 is a separate platform).
  • Give no troubleshooting for it: no commands to run, no driver or CUDA advice, no diagnostic checklist, no "try this first" — not even generic GPU suggestions. Point at the vendor's own docs (or AMD's ROCm-on-WSL guide) and stop there.
  • Do not run rocm examine / rocm diagnose / rocm fix.

Being helpful here means being honest about the boundary — confidently-wrong advice for a stack this skill does not cover is worse than no advice. Only continue past this gate when the GPU is AMD and the platform is native Linux or Windows. See Out of scope.

Prerequisites

  • The rocm CLI. This skill is only a driver over it; Phase 0 below installs it with the user's consent if rocm --version fails. Nothing else here is assumed — the CLI does the probing.
  • Platform: native Linux (in-tree amdgpu module + /dev/kfd) or Windows (HIP SDK). WSL2, NVIDIA/Intel/Apple GPUs, and clean-machine installs are out of scope (see Out of scope).
  • No fixed ROCm version, GPU arch (gfx…), or container image is assumedrocm examine/diagnose detect the installed ROCm, the GPU's gfx target, and container context, and match fixes to what they find. Never hand-set HSA_OVERRIDE_GFX_VERSION (or similar footgun env vars) yourself; let the CLI decide.

Read the full file on GitHub · 181 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 7d ago First seen · 181 lines · 258 tokens per session scan C 0c763034dbe3

Subscribe to this mod's changes

rocm-doctor is a skill published in the GitHub repository amd/skills (332 stars, last pushed yesterday), licensed MIT. It adds 258 tokens to every session and 2,264 once invoked, about $0.0013 per session on Opus 5. A static security scan graded it C with 2 findings (downloads and executes remote code, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

gke-ai-troubleshooting-tpu-dynamic-slices-monitoring

Monitors, troubleshoots, and manages GKE TPU Dynamic Slices custom resources. Use when checking TPU slice lifecycle states, troubleshooting slice provisioning failures, validating single-slice or multi-slice (JobSet) workload manifests, or safely patching stuck finalizers and disabling the slice controller. Don't use…

google/skills · 107 tokens

gke-ai-troubleshooting-tpu-vbar-oom

Diagnoses and prevents vbarcontrolagent segfaults, out-of-memory (OOM) errors, and TPU device initialization failures on TPU v6e nodes in GKE caused by race conditions during TPU device resets or high-frequency metrics polling. Use when troubleshooting vbarcontrolagent crashes, memory cgroup OOMs in serial console…

google/skills · 125 tokens

competition-firmware-layout

Internal downstream skill for ctf-sandbox-orchestrator. CTF-sandbox workflow for firmware images, partition tables, boot chains, update packages, extracted filesystems, embedded configs, and device-facing trust boundaries. Use when the user asks to unpack firmware, map partition layout, inspect bootloader or init…

zhaoxuya520/reverse-skill · 110 tokens

doca-flow

Build and debug DOCA Flow applications on supported NVIDIA NICs/DPUs: define match/action pipes, initialize ports and representors, choose forwarding targets, validate pipes before hardware programming, read counters, match the Flow version to the installed DOCA release, and diagnose Flow API errors. Trigger on DOCA…

NVIDIA/skills · 140 tokens

diagnose-driver-install

Diagnose NVIDIA driver installation failures on DeepOps-managed nodes — nvidia-smi errors, "No devices were found", DKMS build failures, or GPU pods crash-looping. Use before reinstalling anything.

NVIDIA/deepops · 47 tokens

catc-troubleshoot

Catalyst Center troubleshooting workflows - device unreachable investigation, client connectivity issues, interface down analysis, site-wide outage triage, wireless roaming problems, integration with pyATS for CLI-level diagnostics. Use when a device is unreachable, a user reports connectivity problems, an interface…

automateyournetwork/netclaw · 74 tokens