Skip to content
SkillModel-led2,257 tokens in use

roblox-luau

Helps an agent write Roblox Luau that runs in the right place: Script vs LocalScript vs ModuleScript, services, owned connections, the task library and typed Luau.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/other-engines/roblox-luau
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing roblox-luau costs

96tokens idle
2,257tokens in use
3,139tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

shelldetected

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Excellent
  • Frontmatter12/15
  • Structure25/25
  • Examples12/15
  • Output10/15
  • Size13/15
  • Resources15/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent
  • Runs shell commands−5

    does this on the machine, and the frontmatter does not say so

    SKILL.md, line 40

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

This skill helps an agent write Luau code for Roblox experiences. It starts from the project setup (Rojo files, selene config, type-check mode), decides which container the code belongs in, and builds Instances and connections so they clean up after themselves.

It carries a table of where each script type runs, patterns for per-player setup, owned connections, frame loops and frozen shared config, and a list of gotchas such as deferred signals, nil on the client after join and legacy scheduling globals.

What You Get

  • A seven-step workflow from reading the Rojo and selene setup to a play-test check
  • A table of containers that shows where each script type runs and what belongs there
  • Luau patterns for per-player setup that covers early joiners, connections owned by their object and a frozen shared config module
  • A gotchas list covering deferred signal ordering, nil objects on the client, legacy wait and spawn, and type versus typeof

Common Use Cases

  • Finding why a LocalScript never runs because it sits in the wrong container
  • Fixing a client script that gets nil for an object right after joining
  • Replacing wait, spawn and delay with the task library
  • Adding type annotations and running selene and luau-lsp before a play test

What Makes It Unique

The skill treats placement as the first decision: it checks RunContext and the container table before it writes logic. It gives rules specific to current Roblox behavior, such as deferred signals changing handler order and module state being separate per context, and it points to sibling skills for remotes, saving and place edits so its own scope stays small.

Under The Hood

The agent loads the SKILL.md and, when needed, one reference on client and server replication, WaitForChild, Bindables, attributes, tags and Studio test modes. It reads project files such as Rojo project files, selene.toml and .luaurc, edits Luau source, and can run selene, rojo sourcemap and luau-lsp on the command line. With a connected Roblox Studio MCP server it starts play, runs Luau in the matching datamodel and reads the console. Without it, it asks you to press Play and paste the Output. Documentation URLs are named for re-checking APIs, and nothing is fetched during normal use.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers