AO

Diagnose and fix AOTInductor compilation and runtime errors in PyTorch, focusing on device and shape consistency.

Install

mkdir -p .claude/skills/aoti-debug && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/4024" && unzip -o skill.zip -d .claude/skills/aoti-debug && rm skill.zip

Installs to .claude/skills/aoti-debug

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Debug AOTInductor (AOTI) errors and crashes. Use when encountering AOTI segfaults, device mismatch errors, constant loading failures, or runtime errors from aot_compile, aot_load, aoti_compile_and_package, or aoti_load_package.
227 chars✓ has a “when” trigger
Advanced

Key capabilities

  • →Validate device and shape matching for AOTI
  • →Identify problematic kernels using intermediate value debuggers
  • →Force deterministic CUDA behavior for debugging
  • →Check input properties with runtime flags

How it works

It routes errors to specific debugging guides and provides environment variables to validate input guards, force synchronous execution, and print intermediate kernel values.

Inputs & outputs

You give it
AOTI error message or crash symptom
You get back
Diagnostic steps and configuration flags to resolve the failure

When to use aoti-debug

  • →Fix AOTI segfaults
  • →Resolve device mismatch errors
  • →Debug compile failures

About aoti-debug

Provides a structured approach to identifying AOTI failures. It enforces checks for device matching between compile/load and validates input shape requirements.

Debug AOTInductor (AOTI) errors and crashes. Use when encountering AOTI segfaults, device mismatch errors, constant loading failures, or runtime errors from aot_compile, aot_load, aoti_compile_and_package, or aoti_load_package.

When not to use it

  • →When the error is unrelated to AOTInductor compilation or loading
  • →When cross-device loading is required

Prerequisites

PyTorch

Limitations

  • →Cross-device loading is not supported
  • →CUDA illegal memory access errors can be non-deterministic

How it compares

It provides a systematic routing approach for AOTI-specific crashes rather than generic PyTorch debugging.

Compared to similar skills

aoti-debug side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
aoti-debug (this skill)19moReviewAdvanced
langsmith-observability410moReviewIntermediate
mflux-debugging35moNo flagsAdvanced
debug-distributed19moReviewAdvanced

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry