profile-model

Installation
SKILL.md

Profile a model on MAX

This skill answers three questions about any model you can run on MAX, whether it's a built-in architecture or a custom one loaded with --custom-architectures:

  1. Is my GPU actually being used? (utilization, memory, clocks)
  2. Where does my model spend the most time? (which kernels / phases)
  3. Why is this kernel slow? (occupancy, stalls, roofline)

It works from a pip or pixi install of MAX, driving the public max CLI or a Python script.

How to decide what to run

Each question needs a deeper, more expensive capture than the last. Work from the cheapest check toward the most invasive, and let each result decide whether going deeper is even worth it — don't capture more than the question needs.

Installs
131
Repository
modular/skills
GitHub Stars
115
First Seen
Jun 27, 2026
profile-model — modular/skills