lint-zentorch-source

name	lint-zentorch-source
description	Lint zentorch Python (flake8), C++ (git clang-format), or shell (shellcheck) code. Use when the user asks to lint, format-check, or run style checks on zentorch code.

Lint zentorch code

When the user asks to lint Python, C++, or shell code, follow this skill.

Agent action: Run the command matching the requested language:

.claude/skills/lint-zentorch-source/scripts/lint.sh python
.claude/skills/lint-zentorch-source/scripts/lint.sh cpp
.claude/skills/lint-zentorch-source/scripts/lint.sh shell

Use the manual steps below only if the script fails.

---

Environment

Python linting requires an activated, non-base Python environment — the same one used across the other zentorch skills. Confirm what is active:

echo "${VIRTUAL_ENV:-${CONDA_DEFAULT_ENV:-none}}"

C++ and shell linting do not require a Python environment.

---

Python

python -m pip install -r linter/requirements.txt
python -m flake8

To auto-format files flagged by flake8 with black:

python -m flake8 --format='%(path)s' | sort -u | xargs -r black --verbose

• Config: .flake8 in the repo root
• Excludes: .git, build, dist, third_party
• Also used by CI via linter/py_cpp_linter.sh

---

C++

Requires git-clang-format (from LLVM/clang tools) on PATH. This is the same tool the repo's CI linter (linter/py_cpp_linter.sh) uses; the clang-format pip package does not provide it.

Check the prerequisite:

command -v git
git clang-format -h

Install it explicitly if needed:

conda install -c conda-forge clang-tools
# Ubuntu/Debian:
sudo apt-get update && sudo apt-get install clang-format

git clang-format --commit "$(git rev-list HEAD | tail -n 1)" --diff

To apply the suggested formatting:

git clang-format -f

• C++20 with PyTorch 2.13; C++17 with supported older PyTorch, compiled with -Wall -Werror
• Operator bindings live in src/cpu/cpp/ and Bindings.cpp

---

Shell

Requires shellcheck on PATH. Check it before running:

command -v shellcheck
shellcheck --version

Install it explicitly if needed:

conda install -c conda-forge shellcheck
# Ubuntu/Debian:
sudo apt-get update && sudo apt-get install shellcheck

find . \
  -path ./third_party -prune -o \
  -path ./build -prune -o \
  -path ./dist -prune -o \
  -path ./.git -prune -o \
  -type f -name '*.sh' -print | xargs shellcheck

Covers shell scripts under scripts/, linter/, and .claude/.