y3-lua-review

Validate Y3 Lua business code for API usage and event parameter correctness.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/WindXRan/y3td --skill y3-lua-review-windxran
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: y3-lua-review
Source: https://github.com/WindXRan/y3td/tree/main/maps/EntryMap/.y3maker/skills/y3-lua-review
Command: npx skills add https://github.com/WindXRan/y3td --skill y3-lua-review-windxran

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you prevent runtime crashes and “API hallucination” in Y3 by systematically reviewing existing game-business Lua files for syntax correctness, event correctness, and API/API-parameter compliance.

Core Features & Use Cases

  • Four-phase Lua review: determines review scope, checks basic syntax and module/include path consistency, validates API calls, and verifies event names and event parameter names.
  • Known-issue pattern matching: detects high-frequency incorrect APIs/usage by matching entries from the project’s curated api-issues knowledge base.
  • Deterministic auto-fixes (with confirmation): applies 1:1 replacements for clearly defined wrong patterns (e.g., specific API substitutions and event parameter name corrections), while outputting suggestions for non-deterministic cases.
  • Review scope control: supports full-project review or user-specified directory/file subsets, and produces a structured CRITICAL/WARNING/INFO report.

Quick Start

Ask the AI to run the y3-lua-review skill to review all Lua business scripts under the Y3 EntryMap and produce a CRITICAL/WARNING/INFO report with deterministic auto-fix candidates.

Frequently Asked Questions about y3-lua-review

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

FAQPage Schema
How do I check Y3 Lua scripts for API hallucination and event parameter mismatches?

To check Y3 Lua scripts for API hallucination and event mismatches, run a four-phase review that validates syntax, module paths, API calls, and event parameters against the project's reference source. This process eliminates runtime crashes by catching errors before integration.

What is API hallucination in Lua game development and how does it cause runtime crashes?

API hallucination in Lua game development occurs when scripts call non-existent or incorrectly parameterized APIs. It causes runtime crashes because invalid function calls and event parameter mismatches fail during execution, which can be prevented by validating code against a curated API issues database.

Can I automatically fix incorrect Lua API calls and event names in Y3 maps?

Yes, you can automatically fix incorrect Lua API calls and event names in Y3 maps. The review process applies deterministic 1:1 replacements for clearly defined wrong patterns, such as specific API substitutions and event parameter corrections, but requires your explicit confirmation before applying changes.

How do I review a specific directory of Lua business scripts instead of the full Y3 project?

To review a specific directory of Lua business scripts instead of the full Y3 project, use review scope control to specify target directory or file subsets. This produces a structured CRITICAL, WARNING, and INFO report focused only on your selected files.

Does the Y3 Lua code review support include and require path consistency checks?

Yes, the Y3 Lua code review supports include and require path consistency checks. During the basic syntax and module verification phase, it validates include and require conventions to ensure module path consistency across the reviewed business scripts.

What are the limitations of auto-fixing Lua event parameter mismatches?

The limitation of auto-fixing Lua event parameter mismatches is that only deterministic 1:1 replacements for clearly defined wrong patterns can be applied automatically. Non-deterministic cases cannot be auto-fixed and are instead output as suggestions for manual review.