optimize-gpu-workloads SKILL.md skillA

optimize-gpu-workloads from zystem-io/zymtrace-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zystem-io/zymtrace-skills/optimize-gpu-workloads@git:20261027.524bf2c

Pins git:20261027.524bf2c in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zystem-io/zymtrace-skills
Path
zymtrace/skills/optimize-gpu-workloads/SKILL.md
Versions recorded
2
Latest version
git:20261027.524bf2c, committed Oct 27, 2026
First version recorded
Jun 8, 2026
Size
13,015 bytes
Repository stars
6
License
Apache-2.0

Analyze GPU performance with zymtrace — a GPU workload (NVIDIA CUDA or AMD ROCm), a GPU flamegraph, the hot kernel, why the GPU isn't saturated, or an inference server (vLLM, SGLang, NVIDIA Dynamo-Triton, TensorRT-LLM) or training/fine-tuning job. The zymtrace MCP pulls the data (GPU metrics, flamegraphs); YOU analyze. ALWAYS cross-check the CPU side with the same filter — a GPU workload's bottleneck often hides host-side (tokenizer, DataLoader, Python overhead, sync points) — so pull GPU…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Optimize GPU Workloads

> The MCP fetches the data — GPU metrics, flamegraphs; **you** analyze. Load-bearing discipline: **always pull both the GPU and CPU views with the same filter** — half the time a GPU workload's bottleneck is host-side.

The common discipline — data-source policy, pre-flight, rank-first vs. drill-down, scope-to-own-code/ROI, the always-recommend-and-apply-the-fix rule, the output-template skeleton, severity sizing, and security — lives in [`shared/analysis-conventions.md`](../../shared/analysis-conventions.md). **Read it.** This skill adds the GPU-specific protocol and call-tree rendering on top.

Connection setup lives in [`configure-zymtrace-mcp`](../configure-zymtrace-mcp/SKILL.md); this skill assumes the MCP is connected. **CPU-only workload (no GPUs)?** Use [`optimize-cpu-workloads`](../optimize-cpu-workloads/SKILL.md) — it skips the GPU view, GPU metrics, and inference-server framing entirely.

## Standard starter prompt (for users who don't know what to ask)

> **"Analyze the GPU flamegraph over the last 1 hour and suggest solutions."**
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zystem-io/zymtrace-skills/optimize-gpu-workloads@sha256:99898c5e5481c687

The line at the top of this page pins the label git:20261027.524bf2c, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_vmu3urc2udvpixvv.svg)](https://markdownregistry.com/a/art_vmu3urc2udvpixvv)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jun 8, 2026 and Oct 27, 2026, about one every 142 days.

versioncommittedcommitsizeaudit
git:20261027.524bf2c latest2026-10-27 524bf2c 13,015 BA view · diff
git:20260608.3b7bfd12026-06-08 3b7bfd1 10,342 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (13015 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

zystem-io/zymtrace-skills · 6 stars · license Apache-2.0 · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_vmu3urc2udvpixvv
GET https://markdownregistry.com/api/v1/resolve?ref=zystem-io/zymtrace-skills/optimize-gpu-workloads
GET https://markdownregistry.com/api/v1/blob/99898c5e5481c687a336494333f6f0f41698a8dd2572c9b9fe83cb51afe3f25d

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from zystem-io/zymtrace-skills

CLAUDE.md CLAUDE.md file
zystem-io/zymtrace-skills · CLAUDE.md
git:20261027.157b468 · audit A · 6 stars
configure-zymtrace-mcp SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/configure-zymtrace-mcp/SKILL.md · Use when connecting a coding agent — Claude Code, OpenAI Codex, or Cursor — to the zymtrace MCP server so the user can…
git:20260715.fbd20f5 · audit A · 6 stars
expose-zymtrace-backend SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/expose-zymtrace-backend/SKILL.md · Use when configuring external/internal network exposure for an already-installed zymtrace backend — adding NodePort…
git:20260605.f5be030 · audit A · 6 stars
install-zymtrace-backend SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/install-zymtrace-backend/SKILL.md · Use when installing the zymtrace backend (the AI optimization platform that ingests CPU/GPU profiling data). Covers…
git:20260715.fbd20f5 · audit A · 6 stars
install-zymtrace-profiler SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/install-zymtrace-profiler/SKILL.md · Use when installing the zymtrace profiler agent on Kubernetes (Helm DaemonSet), Docker, or as a binary with systemd…
git:20261027.524bf2c · audit A · 6 stars
optimize-cpu-workloads SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/optimize-cpu-workloads/SKILL.md · Analyze CPU performance with zymtrace on CPU-only deployments (no GPUs) — rank the top CPU consumers (which…
git:20261027.524bf2c · audit A · 6 stars
optimize-memory-allocation SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/optimize-memory-allocation/SKILL.md · Analyze JVM memory-allocation profiles with zymtrace — find what allocates the most (bytes/objects), why GC is busy…
git:20261027.524bf2c · audit A · 6 stars
troubleshoot-zymtrace-backend SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/troubleshoot-zymtrace-backend/SKILL.md · Use when a deployed zymtrace backend isn't working as expected — no data appearing in the UI, profiles not arriving…
git:20260605.f5be030 · audit A · 6 stars
troubleshoot-zymtrace-profiler SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/troubleshoot-zymtrace-profiler/SKILL.md · Use when the zymtrace profiler agent is misbehaving — pods crash-looping, image pull errors, OOMKilled, CPU profiles…
git:20261027.524bf2c · audit A · 6 stars
upgrade-zymtrace-backend SKILL.md skill
zystem-io/zymtrace-skills · zymtrace/skills/upgrade-zymtrace-backend/SKILL.md · Use when upgrading a zymtrace backend that's already deployed via Helm. Covers image-tag-only bumps, chart-version…
git:20260715.fbd20f5 · audit A · 6 stars

Every file in zystem-io/zymtrace-skills

Browse by kind, by grade A, or by owner.