# Debug Kernel

> Debug compilation or runtime errors in LLK kernels. Infers architecture and kernel type from path.

- Skill: `tenstorrent/debug-kernel` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tenstorrent/debug-kernel`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tenstorrent/debug-kernel/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tenstorrent (https://skillmd.com/u/tenstorrent)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tenstorrent/debug-kernel

---


# /debug-kernel — Debug an LLK Kernel

## Usage

```
/debug-kernel tt_llk_blackhole/llk_lib/llk_pack_untilize.h
/debug-kernel tt_llk_quasar/common/inc/sfpu/ckernel_sfpu_gelu.h
/debug-kernel  (no args — will ask for the kernel path or check recent test output)
```

## What to Do

1. Parse the kernel path from the user's arguments. If not provided, check recent test output or ask.
2. Infer the kernel type from the path:
   - `common/inc/sfpu/` → sfpu
   - `llk_lib/llk_math_` → math
   - `llk_lib/llk_pack_` → pack
   - `llk_lib/llk_unpack_` → unpack
3. Infer the architecture from the path:
   - `tt_llk_wormhole_b0/` → wormhole
   - `tt_llk_blackhole/` → blackhole
   - `tt_llk_quasar/` → quasar
4. Spawn the **llk-debugger** agent:

```
Agent tool:
  subagent_type: "llk-debugger"
  description: "Debug {kernel_name}"
  prompt: |
    Kernel path: {kernel_path}
    Kernel type: {kernel_type}
    Architecture: {architecture}
    Error context: {any error output the user provided, or "check logs"}
```

5. Report the agent's results to the user
6. If the fix involves code changes, show the diff and explain the fix