roblox-skills

<p align="center"><img src="assets/logo.svg" alt="Roblox Skills logo" width="128" height="128"></p> # Roblox Skills for AI Agents [](https://github.com/EL4CTEO/roblox-skills/actions/workflows/validate.yml) [](https://github.com/EL4CTEO/roblox-skills/releases) [](LICENSE) 23 [Agent Skills](https://agentskills.io) that keep AI agents' Roblox code current, secure, and correct. They work with Claude Code, Codex, Cursor, OpenCode, Gemini CLI, GitHub Copilot, Windsurf, Cline, Roo Code, Kiro, Goose, Amp, JetBrains Junie, and [many more](docs/agents.md), plus Roblox Studio Assistant. - **Current**: checked against Roblox's API reference (Studio 0.740, September 2026). No `wait()`, `BodyVelocity`, or legacy `Chat`. - **Verified**: CI type-checks every Luau example against the Roblox API (strict mode, new type solver) and flags deprecated APIs. A weekly run catches new deprecations. - **Efficient**: agents see only a short description per skill (~150 tokens) and load the full skill on demand. ## Install **Claude Code** ```text /plugin marketplace add EL4CTEO/roblox-skills /plugin install roblox-skills@roblox-skills ``` **Any other agent** (needs Node.js) ```bash npx skills add EL4CTEO/roblox-skills # choose agents interactively npx skills add EL4CTEO/roblox-skills -a cursor -a windsurf -y # or name them ``` **Without Node.js** ```bash git clone https://github.com/EL4CTEO/roblox-skills.git && cd roblox-skills ./scripts/install.sh --project /path/to/game # .agents/skills (Codex, Cursor, Gemini, Copilot, OpenCode, Amp, ...) ./scripts/install.sh --agent windsurf --global # or claude, roo, kiro, goose, junie, qwen, ... ``` [docs/agents.md](docs/agents.md) lists every agent id and folder. Add `--link` to symlink the skills so `git pull` updates them. On Windows, use `scripts\install.ps1 -Agent windsurf`. **Roblox Studio Assistant**: download `roblox-assistant-skills.zip` from the [latest release](https://github.com/EL4CTEO/roblox-skills/releases/latest), or run `python3 scripts/build-assistant.py`. Then paste a file into **Assistant → Settings → Skills → Add**. ## Skills | Area | Skills | | --- | --- | | Code and structure | `roblox-luau`, `roblox-architecture`, `roblox-networking`, `roblox-security`, `roblox-code-review` | | Data and business | `roblox-data-stores`, `roblox-monetization`, `roblox-analytics-liveops`, `roblox-open-cloud` | | Gameplay | `roblox-game-systems`, `roblox-characters-animation`, `roblox-npc-ai`, `roblox-physics`, `roblox-input` | | Presentation | `roblox-ui`, `roblox-audio`, `roblox-world-building`, `roblox-text-chat` | | Scale and workflow | `roblox-performance`, `roblox-teleport-matchmaking`, `roblox-tooling`, `roblox-testing`, `roblox-studio-mcp` | Each skill lives in [`skills/`](skills/). For best results, also connect your agent to Studio's built-in MCP server (see [`roblox-studio-mcp`](skills/roblox-studio-mcp/SKILL.md)) so it can playtest and verify its changes. ## Contributing ```bash ./scripts/setup-tools.sh && python3 scripts/validate.py ``` See [CONTRIBUTING.md](CONTRIBUTING.md). Corrections are welcome whenever Roblox changes an API. [MIT](LICENSE). This project is not affiliated with Roblox Corporation.