The Art of Debugging
stas00/the-art-of-debugging
Condensed debugging method and tool recipes for Unix, Python and PyTorch programs: crashes, hangs, segfaults, wrong output, CUDA OOM, NaN values and slowness.
Check PyTorch ciflow/xpu (xpu.yml) on the main branch, collect the failing XPU test cases from the most recent completed run(s), analyze the ROOT CAUSE of each failure with AI, and produce a list…
$ npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install intel/torch-xpu-ops xpu-ci-health-check --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/intel/torch-xpu-ops.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/xpu-ci-health-check .claude/skills/xpu-ci-health-check && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "xpu-ci-health-check" agent skill from https://github.com/intel/torch-xpu-ops/tree/main/.claude/skills/xpu-ci-health-check into .claude/skills/xpu-ci-health-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xpu-ci-health-check", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/intel/torch-xpu-ops/tree/main/.claude/skills/xpu-ci-health-checkType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install intel/torch-xpu-ops xpu-ci-health-check --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/intel/torch-xpu-ops.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.claude/skills/xpu-ci-health-check .agents/skills/xpu-ci-health-check && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "xpu-ci-health-check" agent skill from https://github.com/intel/torch-xpu-ops/tree/main/.claude/skills/xpu-ci-health-check into .agents/skills/xpu-ci-health-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xpu-ci-health-check", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install intel/torch-xpu-ops xpu-ci-health-check --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/intel/torch-xpu-ops.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.claude/skills/xpu-ci-health-check .cursor/skills/xpu-ci-health-check && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "xpu-ci-health-check" agent skill from https://github.com/intel/torch-xpu-ops/tree/main/.claude/skills/xpu-ci-health-check into .cursor/skills/xpu-ci-health-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xpu-ci-health-check", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/intel/torch-xpu-ops.git --path .claude/skills/xpu-ci-health-check--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install intel/torch-xpu-ops xpu-ci-health-check --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/intel/torch-xpu-ops.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.claude/skills/xpu-ci-health-check .gemini/skills/xpu-ci-health-check && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "xpu-ci-health-check" agent skill from https://github.com/intel/torch-xpu-ops/tree/main/.claude/skills/xpu-ci-health-check into .gemini/skills/xpu-ci-health-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xpu-ci-health-check", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install intel/torch-xpu-ops xpu-ci-health-checkInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/intel/torch-xpu-ops.git skills-src && mkdir -p .github/skills && cp -r skills-src/.claude/skills/xpu-ci-health-check .github/skills/xpu-ci-health-check && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "xpu-ci-health-check" agent skill from https://github.com/intel/torch-xpu-ops/tree/main/.claude/skills/xpu-ci-health-check into .github/skills/xpu-ci-health-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xpu-ci-health-check", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install intel/torch-xpu-ops xpu-ci-health-check --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/intel/torch-xpu-ops.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.claude/skills/xpu-ci-health-check .opencode/skills/xpu-ci-health-check && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "xpu-ci-health-check" agent skill from https://github.com/intel/torch-xpu-ops/tree/main/.claude/skills/xpu-ci-health-check into .opencode/skills/xpu-ci-health-check/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "xpu-ci-health-check", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
xpu-ci-health-checkCheck PyTorch ciflow/xpu (xpu.yml) on the main branch, collect the failing XPU test cases from the most recent completed run(s), analyze the ROOT CAUSE of each failure with AI, and produce a list…
Xpu CI Health Check is an agent skill from intel/torch-xpu-ops, published by the product's own GitHub organization. Check PyTorch ciflow/xpu (xpu.yml) on the main branch, collect the failing XPU test cases from the most recent completed run(s), analyze the ROOT CAUSE of each failure with AI, and produce a list with a prefilled "disable issue" link per case. USE WHEN the user asks to check XPU CI health, find failing XPU tests, or generate XPU disable-issue drafts.
Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/collect_failures.py`).
It sits in AI & LLM Engineering, covering Root cause analysis, Deep learning and Test generation. It works with PyTorch. The licence is Apache-2.0.
3 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit d8bc81a. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
pythonghFrom the folder's file list and the shell code blocks in SKILL.md.
Hosts in commands or code, which the agent is likely to contact:
github.comhud.pytorch.orgFrom URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Xpu CI Health Check loads about 1.5k tokens when it runs. Until then it costs about 93 tokens; SKILL.md has 622 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from intel/torch-xpu-ops at commit d8bc81a, republished under its Apache-2.0 licence (© intel). 622 words, ~1,519 tokens.
.claude/skills/xpu-ci-health-check/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.This skill automates XPU CI health checks with the following workflow:
Root cause analysis is YOUR job, not the script's. The script only gathers evidence (case id, traceback excerpt, commit sha, disable link). You must reason about why it failed and which change likely caused it.
gh CLI if --token is not provided; ensure gh auth login is configured.Run the bundled collection script from the PyTorch repository root. The script
is located at <path/to/skills>/xpu-ci-health-check/scripts/collect_failures.py
(included in this skill).
# Run from PyTorch repository root
cd /path/to/pytorch # or your PyTorch clone location
python </path/to/skills>/xpu-ci-health-check/scripts/collect_failures.py --run-limit 1--run-limit N — Inspect the last N completed main runs (default: 1).--token — GitHub API token. If omitted, the script falls back to gh CLI auth.The script prints a JSON evidence bundle to stdout:
{
"runs": [{ "run_number": 9275, "head_sha": "5ef6fae…", "html_url": "…" }],
"cases": [
{
"case_id": "test/inductor/test_cutlass_backend.py::TestCutlassBackend::test_xxx",
"commit_sha": "5ef6fae…",
"commit_short": "5ef6fae",
"hud_url": "https://hud.pytorch.org/pytorch/pytorch/commit/5ef6fae…",
"commit_url": "https://github.com/pytorch/pytorch/commit/5ef6fae…",
"job_name": "linux-jammy-xpu-… / test (default, …)",
"failure_line": "… FAILED …",
"error_excerpt": "…traceback / exception text…",
"issue_title": "DISABLED test_xxx (__main__.TestCutlassBackend)",
"issue_body": "Platforms: xpu\n\nThis test was disabled because…\n\ncc …",
"issue_labels": ["module: xpu", "triaged"],
"issue_url": "https://github.com/pytorch/pytorch/issues/new?title=DISABLED%20…&body=…&labels=module%3A%20xpu,triaged"
}
]
}Disable issue template is frozen in the script. The
issue_title,issue_body,issue_labels, andissue_urlfields are produced bybuild_disable_issue()insidescripts/collect_failures.py, aligned with the reference issue template https://github.com/pytorch/pytorch/issues/185907 (Platforms line + "recent examples" section + cc mention + labelsmodule: xpu,triaged). When creating an issue, use these exact fields verbatim — never rewrite the title, body, or labels.
If the number of failed cases > 10, skip this step and let the root cause field be empty.
For each case in cases, use subagent to do:
Fetch latest origin main and git checkout to the commit_sha locally.
Identify the real failure: Read error_excerpt and identify the failing frame
and exception type (e.g., InductorError: NotImplementedError: ), not just the surface FAILED line.
Root cause:
NoYesUnknown (explain why)Produce a list these details, one row per case:
`<commit_short>` linked to HUD (e.g., [5ef6fae](https://hud.pytorch.org/...)).case_id from the evidence bundle.Yes / No / Unknown (see Step 2.4; No = newly appeared).[Create disable issue](<issue_url>).issue_url exactly as produced by the script — do not truncate.module: xpu, triaged).?title=... is invalid and will not match the template.After the list, add a one-line health summary:
main is green or red for ciflow/xpu.main is green for
the inspected run(s). Do not fabricate failures.© intel, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file (scripts) in .claude/skills/xpu-ci-health-check of intel/torch-xpu-ops.
Open the folder on GitHubat commit d8bc81a
Xpu CI Health Check next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Xpu CI Health Check this skillintel/torch-xpu-ops | 115 | — | ~1.5k | Automated safety check: Pass | Apache-2.0 | |
| The Art of Debuggingstas00/the-art-of-debugging | 1.7k | — | ~6.1k | Automated safety check: Notes | CC-BY-SA-4.0 | |
| Ascendcascend-ai-coding/awesome-ascend-skills | 174 | — | ~3.5k | Automated safety check: Pass | None | |
| Vllm Pytorch CI Triagepytorch/test-infra | 113 | — | ~2.4k | Automated safety check: Pass | Custom licence | |
| Docstringpytorch/pytorch | 104k | 2 repos | ~2.6k | Automated safety check: Pass | Custom licence | |
| ExecuTorch Cortex-M Backendpytorch/executorch | 5.1k | — | ~872 | Automated safety check: Pass | Custom licence |
stas00/the-art-of-debugging
Condensed debugging method and tool recipes for Unix, Python and PyTorch programs: crashes, hangs, segfaults, wrong output, CUDA OOM, NaN values and slowness.
ascend-ai-coding/awesome-ascend-skills
End-to-end AscendC custom operator development for Ascend NPU in an ascend-kernel (csrc/ops + build.sh + torchnpu PyTorch custom op) project.
pytorch/test-infra
Root-cause a vLLM torch-nightly CI regression report. An agent skill from pytorch/test-infra.
pytorch/pytorch
Write docstrings for PyTorch functions and methods following PyTorch conventions.
pytorch/executorch
Developer guide for the Cortex-M (CMSIS-NN) backend in ExecuTorch: quantization pipeline, pass manager, tests and adding new ops.
pytorch/executorch
Helps build, test and extend the Qualcomm AI Engine Direct (QNN) backend in ExecuTorch, with routes for new ops, model export, Buck-vs-CMake parity fixes and per-layer accuracy debugging.
intel/torch-xpu-ops
Select the Intel GPU device to use when a system has multiple Intel GPU devices.
intel/torch-xpu-ops
Convert PyTorch ATDISPATCH macros to ATDISPATCHV2 format in ATen C++ code.
intel/torch-xpu-ops
Review pull requests for XPU operator or backend code. An agent skill from intel/torch-xpu-ops.
intel/torch-xpu-ops
Guide users through creating Agent Skills for Claude Code. An agent skill from intel/torch-xpu-ops.
intel/torch-xpu-ops
Read the evidence a nightly UT run produced, decide which failures share a root cause and which are machine breakage rather than product bugs, and write one issue draft per root cause to drafts.json.
intel/torch-xpu-ops
Review PyTorch upstream unit-test (UT) PRs that enable Intel GPU (XPU) on existing tests.
Works with
Categories
Check PyTorch ciflow/xpu (xpu.yml) on the main branch, collect the failing XPU test cases from the most recent completed run(s), analyze the ROOT CAUSE of each failure with AI, and produce a list…. Xpu CI Health Check is an agent skill from intel/torch-xpu-ops, published by the product's own GitHub organization.yml) on the main branch, collect the failing XPU test cases from the most recent completed run(s), analyze the ROOT CAUSE of each failure with AI, and produce a list with a prefilled "disable issue" link per case.
Xpu CI Health Check fits situations like: the user asks to check XPU CI health; find failing XPU tests; generate XPU disable-issue drafts.
Run `npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a claude-code`. Or copy the skill folder (.claude/skills/xpu-ci-health-check in intel/torch-xpu-ops) into .claude/skills/xpu-ci-health-check in your project. Claude Code loads it when a task matches its description.
Run `npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a codex`. Or copy the skill folder (.claude/skills/xpu-ci-health-check in intel/torch-xpu-ops) into .agents/skills/xpu-ci-health-check in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add intel/torch-xpu-ops --skill xpu-ci-health-check -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xpu-ci-health-check, .gemini/skills/xpu-ci-health-check, .github/skills/xpu-ci-health-check and .opencode/skills/xpu-ci-health-check in your project.
Going by SKILL.md and its folder, Xpu CI Health Check needs Python for the scripts in its folder and the command-line tools its instructions call (python and gh). Our summary lists: Python 3.
SKILL.md names 2 domains. In commands or code: github.com and hud.pytorch.org; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Xpu CI Health Check is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.5k tokens (SKILL.md is roughly 6.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Xpu CI Health Check: The Art of Debugging (stas00/the-art-of-debugging, 1.7k stars), Ascendc (ascend-ai-coding/awesome-ascend-skills, 174 stars), Vllm Pytorch CI Triage (pytorch/test-infra, 113 stars) and Docstring (pytorch/pytorch, 104k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
intel (a GitHub organization, an official publisher) maintains it in intel/torch-xpu-ops, which has 115 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 10, 2026.
Source: intel/torch-xpu-ops on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.