🎮 Roblox Suite

Stop shipping outdated Luau. Start with source-grounded guidance.

An opinionated set of source-grounded skills for AI agents writing Roblox Luau. Each skill tells your agent which Roblox APIs are current, which are deprecated, and where the official docs say so — accountable to the Roblox Engine API Reference, not to stale memory.

installs Luau Docs License

🌐 roblox-suite.vercel.app — the full catalog, what each skill covers, what your agent stops doing, and the official sources used to review each skill. Start there.

Install

npx skills add nonlooped/roblox-suite

That drops every skill in the suite into your agent. Start with roblox/SKILL.md — it's the hub that routes you to the right specialist. For a single skill, add --skill <name>:

npx skills add nonlooped/roblox-suite --skill roblox-datastores

Why

Roblox deprecates APIs and changes policy on a rolling basis. Agents trained on old content confidently emit deprecated APIs such as Humanoid:LoadAnimation, BodyMovers, and legacy Teleport variants, as well as risky patterns such as bare SetAsync for contended data. Roblox Suite routes agents toward current documentation and lists the official sources used to review each skill.

For the catalog and visible proof, see the site, its verification evidence page, and the first paired evaluation report. Script files are maturity-labeled examples, not a versioned production library.

Manage the installation

npx skills list
npx skills update
npx skills remove roblox-datastores   # one skill
npx skills remove --all               # all installed skills, with confirmation rules from the CLI

The Skills CLI supports agent-specific installation with --agent and global installation with --global; consult the current CLI options rather than relying on a hardcoded client list.

If an agent does not discover the suite, run npx skills list, confirm the intended project/global scope and agent target, then restart the agent so it reloads skill files. Re-run npx skills update before reporting stale guidance.

Skill structure

skill-name/
├── SKILL.md        ← overview, decision trees, quick patterns
├── references/     ← deep technical docs for specific problems
└── scripts/        ← maturity-labeled examples to adapt and test

License & Contributing

MIT — see LICENSE. Found a stale or unsafe claim? Report an inaccuracy. Pull requests are welcome; read CONTRIBUTING.md and REVIEW_POLICY.md first.