perf-analysis

Coordinate GPU workload performance analysis and generate bottleneck-classified reports.

Updated May 23, 2026
One-click install
npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill perf-analysis-yo-steven
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: perf-analysis
Source: https://github.com/yo-steven/skills-exploration-20260522/tree/main/skills/TensorRT-LLM/perf-analysis
Command: npx skills add https://github.com/yo-steven/skills-exploration-20260522 --skill perf-analysis-yo-steven

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you coordinate performance analysis to identify why a workload is slow, classify the primary bottleneck, and produce a structured report with metrics grounded in profiling results.

Core Features & Use Cases

  • Bottleneck classification: Distinguishes compute-bound, memory-bound, launch-overhead, communication-bound, and sync-bound issues to prevent misguided optimization attempts.
  • Delegated profiling workflow: Coordinates profiling by a specialist while ensuring you collect real measurements rather than inventing metrics.
  • Structured reporting: Produces consistent reports containing Summary, Metrics, Findings, and Recommendations for fast decision-making.

Quick Start

Ask perf-analysis to analyze your workload’s MFU, SOL%, throughput, and latency and return a bottleneck-classified report based strictly on profiling tool output.

Frequently Asked Questions about perf-analysis

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

FAQPage Schema
How do I classify GPU performance bottlenecks using profiling metrics?

To classify GPU performance bottlenecks, analyze throughput, latency, MFU, and % of SOL targets extracted from profiling tool output. This distinguishes compute-bound, memory-bound, launch-overhead, communication-bound, and sync-bound issues before making optimization decisions.

What is the best way to generate a structured performance analysis report for GPU workloads?

The best way to generate a performance analysis report is to structure findings into Summary, Metrics, Findings, and Recommendations sections. This structured reporting ensures metrics are grounded in real profiling results for fast bottleneck diagnosis and decision-making.

Why does my GPU workload have low MFU and how can I diagnose it?

Low MFU indicates your GPU workload may be compute-bound or suffering from memory, launch overhead, communication, or synchronization bottlenecks. Diagnose it by extracting throughput and latency metrics from profiling tools to classify the primary performance limiter.

Can I use roofline model metrics to identify memory-bound vs compute-bound issues?

Yes, roofline model metrics like % of SOL targets and MFU help identify whether a workload is compute-bound or memory-bound. Correct bottleneck classification using these profiling metrics prevents misguided optimization attempts for GPU workloads.

Do I need raw profiling tool output to perform bottleneck diagnosis?

Yes, raw profiling tool output is required for bottleneck diagnosis. The performance analysis workflow ensures you collect real measurements rather than inventing metrics, delegating measurement to profiling specialists to accurately classify throughput and latency issues.

What are the limitations of using performance analysis for GPU optimization?

The performance analysis approach relies strictly on extracted profiling metrics, meaning it cannot diagnose bottlenecks without prior tool output. It requires correct bottleneck classification before optimization recommendations can be generated for compute, memory, or sync issues.