running-the-linter

Run Meta-Lint and Mutation Edge Check on Lua files under src/meta.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/WayneWalterBerry/MMO --skill running-the-linter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: running-the-linter
Source: https://github.com/WayneWalterBerry/MMO/tree/main/.squad/skills/running-the-linter
Command: npx skills add https://github.com/WayneWalterBerry/MMO --skill running-the-linter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a structured approach to validate the correctness and consistency of Lua mutation targets and meta files by orchestrating two specialized tools: Meta-Lint and Mutation Edge Check.

Core Features & Use Cases

  • Meta-Lint (Python): enforces 306 rules across 20 categories to validate object structure, naming, GUIDs, references, and cross-file integrity in src/meta/.
  • Mutation Edge Check (Lua): scans all Lua files under src/meta/ to extract mutation edges and verify that target files exist, preventing broken mutations.
  • Full Pipeline: supports running both tools in sequence for pre-commit gates and CI validations.
  • Use Case: Before PRs touching meta definitions, run the pipeline to catch structural and edge-case issues early.

Quick Start

Run the full mutation-lint pipeline to validate all meta targets before committing.

Frequently Asked Questions about running-the-linter

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

FAQPage Schema
How do I validate Lua meta files and mutation targets in CI?

Validate Lua meta files and mutation targets in CI by running a two-tool pipeline that applies Python-based structural linting and Lua-based edge verification to catch broken references before commits.

What does meta file linting check for in Lua mutation definitions?

Meta file linting checks Lua mutation definitions by enforcing 306 rules across 20 categories to validate object structure, naming, GUIDs, references, and cross-file integrity under src/meta/.

How do I check for broken mutation edges in Lua files?

Check for broken mutation edges in Lua files by running a Lua-based edge scanner that extracts mutation edges from src/meta/ and verifies that all target files actually exist.

Can I lint a single Lua file instead of the full src/meta directory?

Yes, you can lint a single Lua file instead of the full src/meta directory, as the validation pipeline supports single-file checks alongside full-directory sweeps for pre-commit gates.

What's the best way to automate meta file validation before a pull request?

Automate meta file validation before a pull request by integrating the two-tool lint pipeline as a pre-commit gate or CI step to catch structural and edge-case issues early.

Do I need Python to run Lua meta file linting?

Yes, you need Python to run the structural linting phase, while the mutation edge check phase runs in Lua, meaning both environments are required for the full validation pipeline.