Debug Kernel
Testing & Qualitydebug-kernelDebug Kernel is an Agent Skill for testing & quality published in the tenstorrent/tt-metal repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Debug compilation or runtime errors in LLK kernels. Infers architecture and kernel type from path.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/tenstorrent/tt-metal/blob/HEAD/tt_metal/tt-llk/.claude/skills/debug-kernel/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/debug-kernel, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
/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
- Parse the kernel path from the user's arguments. If not provided, check recent test output or ask.
- Infer the kernel type from the path:
common/inc/sfpu/→ sfpullk_lib/llk_math_→ mathllk_lib/llk_pack_→ packllk_lib/llk_unpack_→ unpack
- Infer the architecture from the path:
tt_llk_wormhole_b0/→ wormholett_llk_blackhole/→ blackholett_llk_quasar/→ quasar
- 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"}
- Report the agent's results to the user
- If the fix involves code changes, show the diff and explain the fix