luau-lint

Identify and fix Luau code quality issues in Roblox Lua projects.

8|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/CodePhobiia/claude-roblox-game-studio --skill luau-lint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: luau-lint
Source: https://github.com/CodePhobiia/claude-roblox-game-studio/tree/main/.claude/skills/luau-lint
Command: npx skills add https://github.com/CodePhobiia/claude-roblox-game-studio --skill luau-lint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides static analysis of Luau code to identify type annotation gaps, deprecated API usage, naming convention violations, and common anti-patterns, helping maintain robust Roblox Lua projects.

Core Features & Use Cases

  • Type Annotation Coverage: flags missing or incomplete type annotations to improve type safety.
  • Deprecated API Detection: surfaces usage of outdated Roblox APIs.
  • Naming & Style Compliance: enforces consistent naming and style across modules.
  • Dual Analysis Engine: uses selene when available for precise results and falls back to a grep-based approach when not.
  • Use Case: apply during code reviews to catch issues before merge and as part of CI to enforce quality gates.

Quick Start

Run the luau-lint skill against your Luau project to generate a report of type annotation gaps and deprecated API usage.

Frequently Asked Questions about luau-lint

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

FAQPage Schema
How do I run static analysis to find deprecated Roblox APIs in Luau scripts?

Static analysis flags deprecated Roblox APIs by scanning your Luau scripts and reporting outdated usage. You can run this check during development or code reviews to catch and replace legacy APIs before release.

Can I check Luau type annotation gaps without installing Selene?

You can detect type annotation gaps without Selene. The analysis uses a grep-based fallback approach to identify missing type annotations in Luau code when the Selene static analysis tool is not available in your environment.

What is the best way to enforce naming conventions in Roblox Lua modules?

Enforcing naming conventions involves scanning modules to identify style violations and improper naming. The static analysis checks your Luau codebase and outputs structured results flagging inconsistent naming across your scripts.

Does luau-lint work for continuous integration workflows?

Luau-lint works for continuous integration workflows by outputting structured results suitable for developer pipelines. You can apply these checks as part of CI to enforce code quality gates before merging Roblox Lua projects.

What common anti-patterns can static analysis detect in Luau code?

Static analysis detects common anti-patterns in Luau code by scanning for improper naming, incomplete type annotations, and deprecated API usage. It reports these issues as structured results to help maintain robust Roblox Lua projects.