sass — Claude Code skill: SASS analysis
This Claude Code skill inspects GPU kernel SASS from profiling output. It checks instruction patterns, scheduling, kernel structure, and launch metrics.
Apache-2.0 ★ 339 updated 2026-11-11
~/.claude/skills/sass/SKILL.mdWhat sass does
The skill reads static SASS and returns machine-readable verdicts about a kernel. sass_tools.py parses output from ncu --set source or cuobjdump -sass, selects the profiled kernel, and builds an opcode histogram. The first kernel launched is often not the one under investigation.
Additional scripts inspect MMA operand sources and WGMMA serialization, then trace MMA chains and wait depths. They also report peak live registers, phase structure, and grid, block, and cluster dimensions from launch metrics. Each tool prints a verdict line; the driver accepts only the OK form, not explanatory prose.
What it helps with
- parse SASS output collected by NCU
- select the profiled kernel from observed launches
- inspect MMA operand sources and WGMMA serialization
- check scheduling, register use, and launch dimensions
Example prompts for the agent
- Inspect the SASS from
ncu --set sourceand return a verdict for the profiled kernel. - Check the MMA operand sources and WGMMA serialization in this kernel.
- Report the MMA chains, wait depths, and launch dimensions for this kernel.
How to install sass
Manually: put the files in place
~/.claude/skills/sass/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/sass/
Manually: put the files in place
.agents/skills/sass/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/sass/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OpenBMB/ForgeKernel skills/sass2Manually: put the files in place
.github/skills/sass/SKILL.mdPlatform CLI
gemini skills install https://github.com/OpenBMB/ForgeKernel --path skills/sassManually: put the files in place
.devin/skills/sass/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about sass
How do I install sass in Claude Code?
Create ~/.claude/skills/sass/SKILL.md and place the skill content there.
What does sass do?
It parses SASS dumps and checks kernel instructions, operands, scheduling, phase structure, and launch metrics. Its tools finish with machine-readable verdict lines.
Which SASS inputs can sass parse?
It reads output from ncu --set source and dumps produced by cuobjdump -sass. It selects the profiled kernel because the first launched kernel is often a different one.
Source text
SKILL.md · Apache-2.0
# sass Static reads of a kernel's SASS, all from the page one `ncu --set source` collection (or a `cuobjdump -sass` dump) already gives. Every tool checks itself and ends in one machine verdict line; the driver opens a gate only on the OK form, never on prose. | script | reads | verdict | |---|---|---| | `sass_tools.py` | parsing (both dump formats), opcode histogram and ISA families of the right kernel | `SASS-OK` / `SASS-FAIL` | | `sass_census.py` | MMA A-operand source (register vs shared-memory descriptor) and WGMMA serialization | `SASS-OPERANDS ...` | | `sched_live_tools.py` | the loop body as an ordered event stream (MMA chains, wait depths) and peak live registers | `SCHED-OK` / `SCHED-FAIL`, `LIVE-OK` / `LIVE-FAIL` | | `struct_tools.py` | how each phase is built: warps, tile granule, internal precision, hand-off | `STRUCT-OK` / `STRUCT-FAIL` | | `launch_tools.py` | grid, block, cluster shape from the launch metrics, never from the grid | `LAUNCH-OK` / `LAUNCH-PARTIAL` | In a probe (the driver has seeded the files into `notes/`): ```python import sass_tools # the SASS page, the kernel NCU profiled, and every (kernel, duration) launch it saw sass_tools.analyze(page_text, profiled_kernel, launch_pairs) # prints SASS-OK / SASS-FAIL ``` Never hand-roll a SASS parser: the format differs between NCU and cuobjdump, and the first launched kernel is often not the one you mean (`sass_tools.pick_kernel`).
© OpenBMB · Apache-2.0 · OpenBMB/ForgeKernel