🎮 Roblox Dev Skill — AI Coding Assistant for Roblox Development

An expert-level AI skill for Roblox game development with Luau. Designed for
Antigravity IDE, Claude Code,
and any AI coding assistant that supports the Skills format.

Version: 2.4.0 | Engine Version: v733+ | Knowledge Status: August 2026 Current

What Is This?

A structured knowledge base that transforms your AI coding assistant into a
Roblox development expert. When you mention anything Roblox-related, the skill
auto-triggers and provides the AI with deep, accurate, research-verified knowledge
about the Roblox platform.

Key Features

• 🧠 5,800+ lines of curated Roblox development knowledge across 11 reference files
• 📂 Local-first API lookup — pre-split ~/RobloxDocs/ JSON files (845× more token-efficient than full dump)
• 🔄 Self-updating — built-in obsolescence detection + background auto-update
• 🎯 Smart routing — automatically selects the right reference based on your intent
• 🔌 MCP integration — works with the official Roblox Studio MCP server
• 🛡️ Security-first — server authority, input validation, anti-exploit patterns
• 📚 Migration-aware — guides you through deprecated APIs and breaking changes
• ⚡ Multi-fallback — local JSON → web docs → context7 MCP

Directory Structure

roblox-dev-skill/
├── SKILL.md                          # Main skill file (router + standards + workflows)
├── metadata.json                     # Knowledge update tracking (timestamps, versions)
├── README.md                         # This file
├── references/                       # Deep-dive reference guides
│   ├── luau-fundamentals.md          # Luau language, types, naming, style
│   ├── project-structure.md          # Architecture, Rojo, Script Sync, IAS
│   ├── datastore-persistence.md      # DataStoreService, ProfileStore, MemoryStoreService
│   ├── networking.md                 # RemoteEvents, client-server, BindableEvent caveats
│   ├── security-hardening.md         # Anti-exploit, BanAsync, Server Authority
│   ├── performance-optimization.md   # Memory, Parallel Luau, RunService frame pipeline
│   ├── mcp-integration.md            # Roblox Studio MCP tools and workflows
│   ├── ui-systems.md                 # GUI, UIShadow, StyleQuery, UIFlexItem, StyleSheet
│   ├── legacy-migration.md           # Deprecated APIs, RunService events, Scoped UserIds
│   ├── monetization.md               # Transfers API, Subscriptions, game passes
│   └── file-formats-and-assets.md    # rbxl/rbxm formats, ZSTD/LZ4, MeshContent, importing
└── evals/
    └── evals.json                    # Skill trigger accuracy test cases

Companion: ~/RobloxDocs/ (Local API Reference)

The skill integrates with a local API reference hub for token-efficient lookups:

~/RobloxDocs/
├── RobloxAPI/
│   ├── dumps/                         # Full-API-Dump.json per version
│   │   └── latest.json → (symlink)
│   ├── classes/                       # 905 individual class JSONs (~10KB each)
│   ├── enums/                         # 614 enum JSONs
│   ├── services/                      # 252 service JSONs (subset)
│   ├── deprecated/                    # 48 deprecated class JSONs
│   ├── class-index.json               # Lightweight index for quick lookup
│   ├── enum-index.json
│   ├── service-index.json
│   └── deprecated-index.json
├── scripts/
│   ├── roblox-api-monitor.sh          # Smart platform detection + auto-diff + auto-split
│   └── split-api-dump.sh             # Split dump into per-class files
└── README.md

Why? Reading one class file (~10KB) is 845× smaller than the full API dump (~8MB).
This dramatically reduces token usage for AI agents.

Setup RobloxDocs

# 1. Create structure
mkdir -p ~/RobloxDocs/{RobloxAPI/{dumps,classes,enums,services,deprecated},scripts}

# 2. Copy scripts (from this repo or create them)
# See ~/RobloxDocs/README.md for script contents

# 3. Download and split the API dump
~/RobloxDocs/scripts/roblox-api-monitor.sh

Keeping Updated

The monitor script uses smart platform detection (via uname):

• Darwin → checks MacStudio version
• Linux / Windows → checks WindowsStudio64
• Always downloads dump via WindowsStudio64 hash (only Windows builds have it on CDN)

# Manual check
~/RobloxDocs/scripts/roblox-api-monitor.sh

# Force re-download
~/RobloxDocs/scripts/roblox-api-monitor.sh --force

Installation

Antigravity IDE / Gemini (Primary)

# Clone into your plugins directory
mkdir -p ~/.gemini/config/plugins/roblox-dev-suite/skills
cd ~/.gemini/config/plugins/roblox-dev-suite/skills
git clone https://github.com/MSayib/roblox-dev-skill.git roblox-dev-skill

Claude Code

mkdir -p ~/.claude/skills
cd ~/.claude/skills
git clone https://github.com/MSayib/roblox-dev-skill.git roblox-dev

Verify Installation

The skill is active when listed in your AI assistant's available skills.
Test by asking: "Create a coin collection system for my Roblox game" — the skill
should auto-trigger and generate server-authoritative Luau code with --!strict mode.

Usage

Auto-Trigger

The skill automatically activates when you mention Roblox-related topics:

• Roblox, Luau, Roblox Studio, DataStoreService, RemoteEvent
• ProfileStore, Rojo, rbxl, rbxlx, rbxm, game pass
• fbx, obj, gltf, import/export model, Universal Importer
• Any Roblox Engine API reference

Lookup Priority

1. Reference files (Routing Table in SKILL.md)    ← curated knowledge
2. ~/RobloxDocs/RobloxAPI/classes/<Name>.json      ← local split JSON
3. Web docs (create.roblox.com/docs/en-us/*.md)    ← live Roblox official
4. robloxapi.github.io/ref                         ← visual API browser
5. context7 MCP                                    ← fallback

With Roblox Studio MCP

If you have the official Roblox Studio MCP server
connected, the skill can:

• Read/write scripts directly in Studio
• Execute Luau code for validation
• Search the game tree
• Run playtests and read console output
• Take screenshots for visual verification

Knowledge Coverage (August 2026)

Update History

Contributing

1. Research-based only — all content must be grounded in official Roblox documentation
2. No improvisation — if unsure, flag it as a question rather than guessing
3. Update metadata.json — bump version and add a changelog entry
4. Run evals — verify trigger accuracy with evals/evals.json
5. Keep format consistent — --!strict in all code examples, PascalCase for APIs

License

MIT License — see LICENSE for details.

Credits

• Creator: @MSayib — built collaboratively with AI (research-driven, fact-checked)
• Sources: Roblox Creator Docs,
  Luau Language, Roblox DevForum,
  RobloxAPI/ref
• Skills Format: Pioneered by Anthropic