zomboid-review

Reviews Project Zomboid B42.20 mod changes for packaging, Lua, and save-data defects.

Updated Jul 5, 2026
One-click install
npx skills add https://github.com/mrStorrs/pz-ai-modding-system --skill zomboid-review-mrstorrs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: zomboid-review
Source: https://github.com/mrStorrs/pz-ai-modding-system/tree/main/.codex/skills/zomboid-review
Command: npx skills add https://github.com/mrStorrs/pz-ai-modding-system --skill zomboid-review-mrstorrs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Project Zomboid mod changes often pass local syntax checks yet fail at runtime due to B42 packaging mistakes, Kahlua/Java API mismatches, live-install drift, or save-data corruption. This Skill provides a structured review gate that catches those failures before closeout. ## Core Features & Use Cases - Baseline Review Gate: Inspects git diffs, mod.info version folders, live-install symlinks, and console logs for error families before approving changes. - Domain-Specific Probes: Audits loot distribution paths, Lua/Kahlua Java bridge calls, modData persistence, timed actions, economy flows, world entities, and script/recipe compatibility. - Severity-Ranked Findings: Reports Critical/High/Medium/Low findings with file paths, evidence, and required fixes, blocking closeout on unresolved high-severity issues. - Use Case: After fixing a loot-spawning bug in a B42.20 mod, run this review to verify the fix works across ProceduralDistributions, EasyDistro calls, and the live install symlink before declaring the task done. ## Quick Start Use the zomboid-review skill to audit my recent Project Zomboid mod changes before closeout.

Frequently Asked Questions about zomboid-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review Project Zomboid mod changes before release?

Run a structured review gate that checks the git diff, verifies the B42.20-selected version folder and mod.info, inspects console.txt for error families, and probes domain-specific risks like loot paths and Java bridge calls. Findings are ranked by severity with required fixes.

Why does my Project Zomboid mod pass Lua syntax checks but fail in game?

Lua syntax checks like lua5.1 loadfile only validate syntax, not PZ globals, Kahlua userdata, Java method signatures, or event payloads. Runtime failures require verifying Java-exposed methods against decompiled sources and checking console logs for stack traces.

Does this review work with Workshop mods and live installs?

Yes, it verifies Workshop sources under the Steam workshop content folder before local patching, and checks that project-backed live installs are correct symlinks under the Zomboid mods directory resolving to the expected versioned mod.info.

How are Project Zomboid mod review findings reported?

Findings are ordered by severity: Critical or High block closeout, Medium indicates likely user-facing bugs, and Low covers polish issues. Each finding includes the file path, concrete risk, evidence from diffs or logs, and the required fix.

What are the limitations of automated Project Zomboid mod review?

The review cannot prove in-game behavior outside the Project Zomboid runtime, such as live rendering, event timing, or actual gameplay flows. Remaining manual in-game validation is always stated explicitly in the final report.