analyze-zymtrace-workload

Analyze GPU and CPU flamegraphs to identify zymtrace workload bottlenecks.

5|1|Updated May 17, 2026
One-click install
npx skills add https://github.com/zystem-io/zymtrace-skills --skill analyze-zymtrace-workload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: analyze-zymtrace-workload
Source: https://github.com/zystem-io/zymtrace-skills/tree/main/zymtrace/skills/analyze-zymtrace-workload
Command: npx skills add https://github.com/zystem-io/zymtrace-skills --skill analyze-zymtrace-workload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

zymtrace workload investigations often miss the real bottleneck because users only look at one side (GPU or CPU), while the constraint may be on the opposite side.

Core Features & Use Cases

  • Cross-view flamegraph matching: Enforces pulling the GPU and CPU flamegraphs for the same workload slice using the same resolved filter so comparisons are valid.
  • MCP-assisted investigation workflow: Uses the connected zymtrace MCP to identify the workload, fetch flamegraphs, name hot stacks, and surface bottleneck patterns.
  • Actionable recommendations: Produces a recap that always includes concrete fixes for the top issues, grounded in the returned flamegraph data.
  • Supported scenarios: Troubleshooting vLLM/GPU training jobs, identifying hot kernels, diagnosing CPU overhead during GPU underutilization, and verifying whether issues are sync/transfer bound.

Quick Start

Ask Claude to analyze your workload by saying: Analyze the GPU flamegraph over the last 1 hour and suggest solutions.

Frequently Asked Questions about analyze-zymtrace-workload

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find GPU and CPU performance bottlenecks using flamegraphs?

To find GPU or CPU performance bottlenecks using flamegraphs, you must cross-check the opposite side. Pulling synced CPU and GPU flamegraphs for the same workload slice ensures your bottleneck comparison is valid and identifies whether the issue is sync or transfer bound.

Why does my vLLM inference workload show GPU underutilization?

vLLM inference workloads showing GPU underutilization often have hidden CPU overhead. By cross-checking the CPU flamegraph against the GPU view using the same resolved filter, you can identify if CPU overhead or hot kernels are stalling the GPU pipeline.

How do I analyze a zymtrace workload over a specific time range?

Analyzing a zymtrace workload over a specific time range requires using the zymtrace MCP to identify the workload and fetch flamegraphs. You apply the resolved filter to pull matching CPU and GPU views, then name hot stacks to surface bottleneck patterns.

Can I diagnose hot kernels during GPU training jobs with cross-view analysis?

Yes, diagnosing hot kernels during GPU training jobs requires cross-view analysis. By pulling the opposite-side CPU or GPU flamegraph with the same resolved filter, you can verify if the training bottleneck is computation, memory transfer, or synchronization bound.

What is the best way to get actionable fixes for workload bottlenecks?

The best way to get actionable fixes for workload bottlenecks is generating a recap from cross-view flamegraph data. Naming hot stacks and matching CPU and GPU views grounds the analysis in actual profiling data, surfacing concrete fixes for the top issues.

Does workload analysis work without pulling both CPU and GPU flamegraphs?

Workload analysis is unreliable without pulling both CPU and GPU flamegraphs. Looking at only one side misses the real bottleneck, because the performance constraint may be on the opposite side, making enforced cross-view matching essential for valid comparisons.