Agent skill

Kernel Profiling

by ZJLi2013 in ZJLi2013/awesome-kernel-skills

Profile GPU kernels using NCU (NVIDIA) or rocprof (AMD) to collect performance metrics.

No licenceAuto-check passedDevelopment

Install Kernel Profiling

skills CLI
$ npx skills add ZJLi2013/awesome-kernel-skills --skill kernel-profiling -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZJLi2013/awesome-kernel-skills kernel-profiling --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZJLi2013/awesome-kernel-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/system/profiling .claude/skills/kernel-profiling && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
kernel-profiling
GitHub stars
102
Token cost
~696 tokens
SKILL.md length
147 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
None found

At a glance

Profile GPU kernels using NCU (NVIDIA) or rocprof (AMD) to collect performance metrics.

  • Works in 5 steps: Detect GPU vendor (scripts/detect_gpu.py) → Run appropriate profiler (NCU or rocprof) → Parse output into structured metrics → …
  • Profiling kernels
  • SKILL.md covers Overview, NVIDIA: Nsight Compute (NCU), AMD: rocprof and Output Format, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Kernel Profiling is an agent skill from ZJLi2013/awesome-kernel-skills. Profile GPU kernels using NCU (NVIDIA) or rocprof (AMD) to collect performance metrics. Produces structured metrics.json with throughput, bandwidth, occupancy, and bottleneck classification. Use when profiling kernels, collecting NCU/rocprof data, or diagnosing performance issues.

Its SKILL.md is about 700 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Performance optimization and OKRs and executive reporting. It works with NVIDIA AI Platform.

When your agent uses it

  • Profiling kernels
  • Collecting NCU/rocprof data
  • Diagnosing performance issues

Example prompts

  • “/kernel-profiling”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Detect GPU vendor (scripts/detect_gpu.py)
  2. Run appropriate profiler (NCU or rocprof)
  3. Parse output into structured metrics
  4. Classify bottleneck (memory / compute / latency)
  5. Feed into bottleneck-diagnosis skill for optimization recommendations

What it can do on your machine

Read from SKILL.md and the folder at commit aba7662. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash, python and json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Kernel Profiling loads about 696 tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 147 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~696

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 147 words (~696 tokens).

“Profiling is the first step in any kernel optimization loop. This skill covers collecting hardware performance counters and deriving actionable metrics on both NVIDIA and AMD GPUs.”

— opening of SKILL.md by ZJLi2013
name
kernel-profiling

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/system/profiling of ZJLi2013/awesome-kernel-skills.

Open the folder on GitHubat commit aba7662

Compare with similar skills

Kernel Profiling next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Kernel Profiling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Kernel Profiling this skillZJLi2013/awesome-kernel-skills102—~696Automated safety check: PassNone
LLM Torch Profiler Analysissgl-project/sglang37k2 repos~6.4kAutomated safety check: PassApache-2.0
Tilelang SkillslowlyC/agent-gpu-skills169—~1.8kAutomated safety check: PassMIT
Ppu Acu Joint Profilealibaba/atrex-kernel-agent154—~5.2kAutomated safety check: PassApache-2.0
Nemo Mbridge Perf Moe Optimization WorkflowNVIDIA/skills3.5k—~3.3kAutomated safety check: PassApache-2.0
LLM Torch Profiler Trace AnalysisBBuf/AI-Infra-Auto-Driven-SKILLS900—~2.8kAutomated safety check: PassNone

Similar skills

  • LLM Torch Profiler Analysis

    sgl-project/sglang

    Unified LLM torch-profiler triage skill for sglang, vllm, TensorRT-LLM, and TokenSpeed.

    37k GitHub starsUsed in 2 repos~6.4k tokens
    DevelopmentAuto-check passed
  • Tilelang Skill

    slowlyC/agent-gpu-skills

    Write, debug, and optimize TileLang kernels from local upstream language, JIT, autotuning, profiling, compiler, test, and example source.

    169 GitHub stars~1.8k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Ppu Acu Joint Profile

    alibaba/atrex-kernel-agent

    Choose and run ACU-only, adaptive PPU in-kernel timeline, or optional bounded joint analysis for a PPU kernel.

    154 GitHub stars~5.2k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • LLM Torch Profiler Trace Analysis

    BBuf/AI-Infra-Auto-Driven-SKILLS

    Analyzes Torch Profiler traces from SGLang, vLLM and TensorRT-LLM servers into kernel attribution, overlap and fusion tables.

    900 GitHub stars~2.8k tokensUpdated 2 days ago
    AI & LLM EngineeringAuto-check passed
  • Tao Run Deft Pas

    NVIDIA/skills

    Official

    Run iterative improvement for NVIDIA TAO CLIP / SigLIP image-text retrieval on attribute-labelled data.

    3.5k GitHub stars~4.2k tokensUpdated today
    AI & LLM EngineeringAuto-check: notes

More from ZJLi2013/awesome-kernel-skills

All 12 skills in this repo
  • Cross Entropy Kernel

    ZJLi2013/awesome-kernel-skills

    Optimize fused cross-entropy loss kernels in Triton for NVIDIA and AMD GPUs.

    102 GitHub stars~461 tokensUpdated 6 mo ago
    Auto-check passed
  • Flash Attention Kernel

    ZJLi2013/awesome-kernel-skills

    Optimize FlashAttention-style fused attention kernels in Triton for NVIDIA and AMD GPUs.

    102 GitHub stars~697 tokensUpdated 6 mo ago
    Auto-check passed
  • Fused Moe Kernel

    ZJLi2013/awesome-kernel-skills

    Optimize Fused Mixture-of-Experts (MoE) kernels in Triton for NVIDIA and AMD GPUs.

    102 GitHub stars~699 tokensUpdated 6 mo ago
    Auto-check passed
  • Gemm Kernel Optimization

    ZJLi2013/awesome-kernel-skills

    Optimize dense matrix multiplication (GEMM) kernels in Triton for NVIDIA and AMD GPUs.

    102 GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • Iterative Kernel Optimization Loop

    ZJLi2013/awesome-kernel-skills

    Orchestrates continuous kernel optimization by chaining profiling, bottleneck diagnosis, tier-based optimization, verification, and benchmarking into an iterative loop.

    102 GitHub stars~2.5k tokensUpdated 6 mo ago
    Auto-check passed
  • Kernel Benchmark

    ZJLi2013/awesome-kernel-skills

    Unified kernel benchmarking protocol producing JSON results with latency, TFLOPS, GBps, and comparison against PyTorch baselines.

    102 GitHub stars~567 tokensUpdated 6 mo ago
    Auto-check passed

Questions about Kernel Profiling

What does Kernel Profiling do?

Profile GPU kernels using NCU (NVIDIA) or rocprof (AMD) to collect performance metrics. Kernel Profiling is an agent skill from ZJLi2013/awesome-kernel-skills. Profile GPU kernels using NCU (NVIDIA) or rocprof (AMD) to collect performance metrics.

When should I use Kernel Profiling?

Kernel Profiling fits situations like: profiling kernels; collecting NCU/rocprof data; diagnosing performance issues.

How do I install Kernel Profiling in Claude Code?

Run `npx skills add ZJLi2013/awesome-kernel-skills --skill kernel-profiling -a claude-code`. Or copy the skill folder (skills/system/profiling in ZJLi2013/awesome-kernel-skills) into .claude/skills/kernel-profiling in your project. Claude Code loads it when a task matches its description.

How do I install Kernel Profiling in Codex?

Run `npx skills add ZJLi2013/awesome-kernel-skills --skill kernel-profiling -a codex`. Or copy the skill folder (skills/system/profiling in ZJLi2013/awesome-kernel-skills) into .agents/skills/kernel-profiling in your project. Codex loads it when a task matches its description.

Can I use Kernel Profiling in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZJLi2013/awesome-kernel-skills --skill kernel-profiling -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/kernel-profiling, .gemini/skills/kernel-profiling, .github/skills/kernel-profiling and .opencode/skills/kernel-profiling in your project.

What does Kernel Profiling need to run?

SKILL.md names no scripts, command-line tools or credentials: Kernel Profiling is instructions for the agent only. Our summary lists: Python 3.

Does Kernel Profiling access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Kernel Profiling safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Kernel Profiling use?

No licence was found for Kernel Profiling or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Kernel Profiling use?

About 696 tokens (SKILL.md is roughly 2.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Kernel Profiling?

Skills that share tags, products or a category with Kernel Profiling: LLM Torch Profiler Analysis (sgl-project/sglang, 37k stars), Tilelang Skill (slowlyC/agent-gpu-skills, 169 stars), Ppu Acu Joint Profile (alibaba/atrex-kernel-agent, 154 stars) and Nemo Mbridge Perf Moe Optimization Workflow (NVIDIA/skills, 3.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Kernel Profiling?

ZJLi2013 (a GitHub user) maintains it in ZJLi2013/awesome-kernel-skills, which has 102 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on March 31, 2026.

Source: ZJLi2013/awesome-kernel-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.