Individual skill
art-of-debugging
Systematic methodology and concrete tool recipes for debugging Unix, Python, and PyTorch programs - crashes, hangs, segfaults, wrong output, CUDA OOM, NaN/Inf, slowness, and multi-node/multi-GPU issues. Use when a program crashes, hangs, deadlocks, segfaults, runs out of memory (OOM), produces NaN/Inf or wrong numbers, runs too slowly, or when the user mentions gdb, strace, py-spy, core files, CUDA_LAUNCH_BLOCKING, ldd/nm/LD_PRELOAD, cProfile, or distributed training hangs. Distilled from "The Art of Debugging", the latest version of which can be found at https://github.com/stas00/the-art-of-debugging The latest SKILL.md version can be found at https://github.com/stas00/the-art-of-debugging/blob/master/SKILL.md
SKILL.md
Source commit 7e479bfba164b3f19cf4ccae2a038175fc05554e
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 9, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,746
- Repository last updated
- Oct 13, 2026
- License
- CC-BY-SA-4.0
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
.gitignoreasset · 277 bytesLICENSE-CC-BY-SAasset · 20,131 bytesMakefileruns · 3,545 bytesREADME.mddoc · 4,795 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesSKILL.mdcore · 24,281 bytesbuild/README.mddoc · 2,473 bytesbuild/SESSION.mddoc · 58,254 bytesbuild/check-links.pyruns · 4,463 bytesbuild/check-new-links.shruns · 1,662 bytesbuild/check-programsruns · 2,483 bytesbuild/check-redirects.pyruns · 20,342 bytesbuild/check-style.pyruns · 3,893 bytesbuild/check-table-width.pyruns · 12,152 bytesbuild/consistency-checks.mddoc · 6,897 bytesbuild/cover/README.mddoc · 164 bytesbuild/cover/build_final_cover.pyruns · 10,826 bytesbuild/cover/sources/labyrinth.pngasset · 1,874,689 bytesbuild/fix-tables.pyruns · 11,285 bytesbuild/linkcheckerrcasset · 211 bytesbuild/mdbook/md-to-html.pyruns · 3,479 bytesbuild/mdbook/mv-links.pyruns · 934 bytesbuild/mdbook/preprocess-html-for-epub.pyruns · 5,736 bytesbuild/mdbook/utils/build_utils.pyruns · 152 bytesbuild/mdbook/utils/github_md_utils.pyruns · 7,416 bytesbuild/prince_style.cssasset · 3,339 bytesbuild/requirements.txtdoc · 53 byteschapters-md.txtdoc · 128 bytescompiled-programs/README.mddoc · 34,752 bytescompiled-programs/dl1/dl1.casset · 124 bytescompiled-programs/dl1/util.casset · 88 bytescompiled-programs/dl2/dl2.casset · 163 bytescompiled-programs/dl2/util.casset · 157 bytescompiled-programs/segfault/make-segfault.casset · 133 bytesimages/The-Art-of-Debugging-SKILL.pngasset · 1,631,220 bytesimages/The-Art-of-Debugging-book-cover-1536x1988.pngasset · 1,662,599 bytesimages/The-Art-of-Debugging-book-cover-200x259.pngasset · 48,644 bytesimages/The-Art-of-Debugging-book-cover.oraasset · 3,392,292 bytesimages/The-Art-of-Debugging-book-cover.pdfasset · 2,038,615 bytesimages/The-Art-of-Debugging-book-cover.pngasset · 284,516 bytesimages/The-Art-of-Debugging-book-cover.svgasset · 2,114,517 bytesincoming.mddoc · 213 bytesmethodology.mddoc · 38 bytesmethodology/README.mddoc · 58,013 bytespython/README.mddoc · 50,758 bytespython/grad_demo.pyruns · 224 bytespython/images/py-spy-flamegraph-speedscope.pngasset · 42,774 bytespython/images/py-spy-flamegraph.pngasset · 22,439 bytespython/images/pycharm-data-view.pngasset · 217,124 bytespython/images/pycharm-demo-py.pngasset · 134,947 bytespython/images/vscode-data-view.pngasset · 123,764 bytespython/images/vscode-demo-py.pngasset · 69,263 bytespytorch/NicerTrace.pyruns · 9,469 bytespytorch/README.mddoc · 239,325 bytespytorch/code/collective_mismatch.pyruns · 495 bytespytorch/code/collective_mismatch_analyze.pyruns · 872 bytespytorch/code/kernel_oob.cuasset · 459 bytespytorch/code/kernel_oob.pyruns · 237 bytespytorch/code/kernel_oob_gdb.pyruns · 300 bytespytorch/code/kernel_oob_prebuilt.pyruns · 273 bytespytorch/code/kernel_race.cuasset · 513 bytespytorch/code/kernel_race.pyruns · 239 bytespytorch/code/see-mem-usage.pyruns · 4,950 bytespytorch/images/math-fp-discrepancy-outcome-lizard.pngasset · 689,964 bytespytorch/images/mem-profiler-llama-8b-ckpt-offload-cpu.pngasset · 427,834 bytespytorch/images/tensor-needle-in-a-hay-stack.pngasset · 32,098 bytespytorch/images/torch-mem-profile-mem-leak.pngasset · 189,562 bytespytorch/printflock.pyruns · 1,903 bytespytorch/tiny-scripts/README.mddoc · 686 bytespytorch/tiny-scripts/c4-en-10k.pyruns · 2,622 bytespytorch/tiny-scripts/cm4-synthetic-testing.pyruns · 8,260 bytespytorch/tiny-scripts/fsmt-make-super-tiny-model.pyruns · 3,263 bytespytorch/tiny-scripts/general-pmd-ds-unpack.pyruns · 3,142 bytespytorch/tiny-scripts/general-pmd-synthetic-testing.pyruns · 6,837 bytespytorch/tiny-scripts/idefics-make-tiny-model.pyruns · 1,545 bytespytorch/tiny-scripts/m4-ds-unpack.pyruns · 3,553 bytespytorch/tiny-scripts/mt5-make-tiny-model.pyruns · 3,347 bytespytorch/tiny-scripts/openwebtext-10k.pyruns · 3,078 bytespytorch/tiny-scripts/oscar-en-10k.pyruns · 4,193 bytespytorch/torch-distributed-gpu-test.pyruns · 3,787 bytespytorch/underflow_overflow.pyruns · 13,104 bytesunix/README.mddoc · 27,880 bytesunix/bash-git-prompt/Stas.bgpthemeasset · 2,619 bytesunix/images/prompt.pngasset · 73,970 bytes
No licensed excerpt is available. You can inspect the pinned source.