tilelang-debug-helper

Configures GDB and VSCode debugging for mixed Python-C++ TileLang Ascend examples.

346|151|Updated Sep 25, 2025
One-click install
npx skills add https://github.com/tile-ai/tilelang-ascend --skill tilelang-debug-helper
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tilelang-debug-helper
Source: https://github.com/tile-ai/tilelang-ascend/tree/main/.agents/skills/tilelang-custom-skill/tilelang-debug-helper
Command: npx skills add https://github.com/tile-ai/tilelang-ascend --skill tilelang-debug-helper

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill tackles the challenge of debugging mixed Python and C++ code in TileLang Ascend examples, making it easier to inspect kernels and set breakpoints without complex manual setup.

Core Features & Use Cases

  • Python Debug Integration: Adds PID printing and attachment waits to example scripts for seamless GDB connection.
  • C++ Build Configuration: Modifies CMakeLists.txt to enable debug symbols and unoptimized compilation.
  • VSCode Joint Debugging: Sets up launch configurations for Python launch and C++ attachment.
  • Use Case: When troubleshooting a sigmoid activation operator, use this Skill to create a debug version of sigmoid.py, configure the build, and step through the C++ kernel in VSCode.

Quick Start

Help me add debugging code to the sigmoid example in examples/activation/sigmoid.py so I can attach GDB in VSCode.

Frequently Asked Questions about tilelang-debug-helper

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug mixed Python-C++ execution flows in TileLang Ascend operators?

To debug mixed Python-C++ execution flows in TileLang Ascend operators, you can use this skill to inject PID printing, add attachment waits in Python scripts, and modify CMakeLists.txt to enable debug symbols for seamless GDB attachment.

What is the best way to attach GDB to a TileLang kernel in VSCode?

The best way to attach GDB to a TileLang kernel in VSCode is by setting up joint debugging configurations, which involves creating a debug version of your Python script, enabling CMake debug flags, and configuring VSCode launch profiles for C++ attachment.

Can I configure VSCode launch.json for joint Python and C++ debugging?

Yes, you can configure VSCode launch.json for joint debugging. This skill sets up launch configurations that allow a Python launch process to wait for a GDB attachment, enabling step-through inspection of C++ kernels.

Does this debugging setup require modifying CMakeLists.txt for unoptimized compilation?

Yes, enabling C++ kernel inspection requires modifying CMakeLists.txt. This skill configures CMake debug flags to ensure unoptimized compilation with debug symbols, preventing code elimination during breakpoint execution.

How to step through a sigmoid activation operator kernel using GDB?

To step through a sigmoid activation operator kernel using GDB, apply this skill to the sigmoid example to generate a debug script, build the kernel with debug symbols, and step through the C++ execution in VSCode.