zig-check

/zig-check [file]

Audit Zig source files for outdated APIs. The plugin supports both Zig 0.15.x and 0.16.x; this skill detects the target version and applies the matching rule set. If a file path is given, check that file. Otherwise check all *.zig files, in any directory, that were modified in the current git diff (staged and unstaged).

Procedure

1. Detect Zig version

Run:

${CLAUDE_PLUGIN_ROOT}/scripts/detect-zig-version.sh

Capture the output as $VERSION (0.15 or 0.16).

2. Determine target files

If argument provided:

• Check only that file

If no argument:

• Run git diff --name-only and git diff --cached --name-only
• Filter to *.zig files, recursively, regardless of directory
• If no modified Zig files, report "No modified Zig files to check" and exit

3. Read each target file

Use the Read tool to read the full contents of each file.

4. Apply the version-specific rule set

Search each file for the patterns below. Report each violation with file path, line number, and the specific issue.

Rules that apply to BOTH 0.15.x and 0.16.x

These are wrong on every supported Zig version:

1. Deleted-in-0.15 APIs:

   • std.io.getStdOut / std.io.getStdErr -- use buffered writer pattern
   • usingnamespace -- removed from language
   • async / await -- removed from language
   • std.BoundedArray -- use ArrayListUnmanaged.initBuffer
   • std.json.Parser -- use std.json.parseFromSlice

2. Renamed APIs (still valid in both versions):

   • std.mem.tokenize( without Any/Scalar/Sequence -- use tokenizeAny, tokenizeScalar, or tokenizeSequence

3. ArrayList without allocator:

   • .append(, .appendSlice(, .deinit() etc. without allocator as first argument (for ArrayListUnmanaged)

4. Ambiguous format strings:

   • "{}" in print/format calls -- must use {s}, {d}, {any}, etc.

5. Signed division without builtins:

   • / or % on runtime signed integer variables -- use @divTrunc, @divFloor, @divExact, @rem, @mod