roblox-mcp-pro 0.2.3 → 0.2.4

package/.agents/skills/roblox-mcp-pro/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: roblox-mcp-pro
+description: >-
+  How to drive the roblox-mcp-pro MCP server to control a live Roblox Studio session — running
+  Luau, querying/mutating the DataModel, building UI, terrain, lighting/effects, audio/animation,
+  spatial queries, and bidirectional Studio↔disk sync. Use this whenever the task involves the
+  roblox-mcp-pro tools (names like execute_luau, query_instances, mutate_instances, manage_sync,
+  manage_ui, manage_terrain, manage_lighting, spatial_query, batch_execute, workspace_state),
+  or whenever the user wants an agent to change things inside Roblox Studio through this server —
+  even if they don't name a specific tool. Read this before the first tool call to pick the right
+  tool and confirm the connection.
+---
+
+# Using roblox-mcp-pro
+
+roblox-mcp-pro exposes 23 tools that act on a **live Roblox Studio session**. The MCP server
+talks to a Studio plugin over a localhost bridge; the plugin runs each command with full plugin
+privileges and returns structured results. Your job is to choose the right tool and verify the
+session is actually connected before relying on results.
+
+## Always start with the connection check
+
+Tools fail with `Error: Roblox Studio plugin is not connected…` if no Studio session is attached.
+Before a sequence of changes, call **`system_info`** once. If `bridge.pluginConnected` is false,
+tell the user to open Studio and click the **MCP** button on the toolbar (it must be highlighted),
+and that the roblox-mcp-pro server must be running. Don't keep retrying blindly — surface the fix.
+
+`workspace_state` is a good second call to orient yourself (place name, child counts per service,
+camera, selection) before editing.
+
+## Choosing the right tool
+
+Prefer the **specific** tool over `execute_luau`. The structured tools return clean, validated
+data and guard against damaging the session (they refuse to touch CoreGui/CorePackages). Reach for
+`execute_luau` only for one-off logic no dedicated tool covers — and remember its output is
+captured print/warn plus `return` values.
+
+| You want to… | Use |
+| --- | --- |
+| Read instances / the tree | `query_instances` |
+| Create / edit / move / clone / delete instances | `mutate_instances` |
+| Read or write specific properties | `manage_properties` |
+| Do many edits atomically (one undo) | `batch_execute` |
+| Run arbitrary Luau | `execute_luau` |
+| Find parts by space (box, radius, raycast, nearest) | `spatial_query` |
+| Generate/edit terrain | `manage_terrain` |
+| Time of day, fog, ambient, shadows | `manage_lighting` |
+| Bloom/Blur/ColorCorrection/DoF/Atmosphere/Sky | `manage_effects` |
+| Move/aim the camera | `manage_camera` |
+| Animate properties over time | `manage_tween` |
+| Physical props / welds | `manage_physics` |
+| Build GUI (ScreenGui/Frame/labels/buttons) | `manage_ui` |
+| Create/preview Sound | `manage_audio` |
+| Animation instances / preview | `manage_animation` |
+| Insert marketplace assets by id | `manage_assets` |
+| Read/write script source, create scripts | `manage_scripts` |
+| Mirror Studio↔disk both ways | `manage_sync` |
+| Explorer selection | `manage_selection` |
+| Studio version/theme/run state | `manage_studio` |
+| Recent Output logs | `manage_logs` |
+| High-level session snapshot | `workspace_state` |
+
+## Patterns that work well
+
+- **Batch related edits.** Building several parts or a whole structure? Wrap the operations in
+  `batch_execute` so it's one undo step and one round-trip, not N. Each step reports its own
+  ok/error, so a single bad op doesn't lose the rest.
+- **Verify after you change.** After a `mutate_instances`/`manage_ui` create, a quick
+  `query_instances` (with `include_properties: true`) confirms it landed as intended.
+- **Property value shapes.** Vectors are `[x,y,z]`; Color3 is `[r,g,b]` (0–1); UDim2 is
+  `[[xScale,xOffset],[yScale,yOffset]]`; CFrame is a 12-number array; enums and BrickColor are
+  their string names. Values are coerced to the property's current type, so match the existing type.
+- **Check logs after running code.** If `execute_luau` or a playtest misbehaves, `manage_logs`
+  returns the recent Output history (newest first) so you can see prints and errors.
+
+## Bidirectional sync (`manage_sync`)
+
+`manage_sync` mirrors a Studio subtree to `roblox-mcp-sync/place_{placeId}/explorer/` and keeps
+both sides in step, plus a `sourcemap.json` for luau-lsp. This is how you give the agent (and the
+human) a stable on-disk copy of the project to edit with normal file tools.
+
+- `action: "start"` — snapshot + begin two-way watching. Defaults to the script-bearing services
+  (ServerScriptService, ReplicatedStorage, StarterGui, StarterPlayer, ServerStorage). Pass
+  `roots: ["Workspace.Systems", …]` to scope differently.
+- `action: "pull"` — force Studio → disk (after big structural changes).
+- `action: "push"` — force disk → Studio (apply all local script edits).
+- `action: "stop"` / `"status"`.
+
+Script sync is fully two-way: creating, editing, or deleting a `.luau` file on disk creates,
+updates, or deletes the script in Studio, and the same edits in Studio flow back to disk. The one
+remaining gap is that non-script property changes in Studio mirror on resync (when instances are
+added/removed), not live — use `pull` to resynchronize when in doubt.
+
+## When something fails
+
+Errors are returned as actionable text. Common ones: not connected (fix the plugin/server),
+"protected service" (CoreGui/CorePackages are intentionally off-limits), and per-operation errors
+inside `batch_execute`/`mutate_instances` results (other operations still ran). Read the `error`
+string and adjust rather than retrying the same call.

package/.agents/skills/roblox-studio-plugin/SKILL.md

@@ -0,0 +1,142 @@
+---
+name: roblox-studio-plugin
+description: >-
+  How to build, package, and install a high-quality Roblox Studio plugin in Luau — toolbar
+  buttons, dock widgets, the plugin lifecycle, persisting state across reloads, undo via
+  ChangeHistoryService, reading/writing script source via ScriptEditorService, HttpService from
+  plugins, and packaging to .rbxmx with Rojo. Use this whenever building or editing a Roblox
+  Studio plugin (anything under a plugin/ folder, a `*.server.luau` plugin entry, PluginToolbar,
+  PluginToolbarButton, CreateDockWidgetPluginGui, plugin:GetSetting/SetSetting, plugin:Activate),
+  or when the user wants to make, package, install, or debug a Studio plugin — even if they only
+  say "Studio plugin", "toolbar button", or "rbxmx". Read this before writing plugin code; it
+  encodes non-obvious Studio behaviors that are easy to get wrong.
+---
+
+# Building Roblox Studio plugins
+
+A Studio plugin is Luau that runs inside Studio's editor with elevated privileges (the global
+`plugin` object). It can read/edit the DataModel, add toolbar UI, talk to localhost over HTTP,
+and register undo waypoints. The hard part isn't the API surface — it's a handful of Studio
+behaviors that silently misbehave if you don't know them. This skill front-loads those.
+
+A complete, tested reference implementation lives in this repo under `plugin/` (entry
+`plugin/src/init.server.luau`, modules in `plugin/src/`). Read it for a working example.
+
+## Project layout (Rojo)
+
+Structure the plugin as a directory that Rojo compiles into one `.rbxmx`:
+
+```
+plugin/
+  default.project.json     # { "name": "MyPlugin", "tree": { "$path": "src" } }
+  src/
+    init.server.luau       # a folder with init.server.luau becomes the root *Script* (the plugin)
+    Foo.luau               # sibling ModuleScripts → require(script.Foo)
+    Handlers/Bar.luau      # subfolder → require(script.Handlers.Bar)
+```
+
+Build + install (Windows):
+
+```powershell
+rojo build default.project.json --output MyPlugin.rbxmx
+Copy-Item MyPlugin.rbxmx (Join-Path $env:LOCALAPPDATA "Roblox\Plugins\MyPlugin.rbxmx") -Force
+```
+
+`%LOCALAPPDATA%\Roblox\Plugins` is the local plugins folder. Pin the Rojo version in `aftman.toml`
+so builds are reproducible.
+
+## Gotchas that will bite you
+
+These are the non-obvious behaviors. Internalize them — each one is a bug we hit and fixed.
+
+- **`PluginToolbarButton` has no settable `Text` or `Tooltip`.** The label/tooltip are fixed at
+  `CreateButton(id, tooltip, icon, text)` time. Assigning `button.Text = …` errors at runtime.
+  Show on/off state with `button:SetActive(bool)` (it highlights), not by changing text.
+- **Studio does NOT reliably hot-reload local `.rbxmx` plugins.** After rebuilding, the running
+  plugin is often the *old* one until Studio restarts (or sometimes regains focus). Always log a
+  startup line like `("loaded %d tools"):format(n)` (and a version) so you can confirm in the
+  Output which build is actually live. When new code "isn't taking effect", suspect this first.
+- **Plugin state resets every reload.** Persist anything that should survive a reload with
+  `plugin:SetSetting(key, value)` / `plugin:GetSetting(key)`. A common pattern: save whether the
+  plugin was "active", and on load auto-restore it so iterating doesn't require re-clicking.
+- **One bad module breaks the whole plugin.** If `require(child)` errors at load, the requiring
+  module errors too, cascading to the entry script and the plugin silently does nothing. Load
+  optional/numerous modules defensively so a single failure disables only that feature:
+  ```lua
+  local map = {}
+  for name, moduleName in pairs(HANDLER_NAMES) do
+      local ok, mod = pcall(require, Handlers[moduleName])
+      if ok then map[name] = mod else warn("failed to load " .. moduleName .. ": " .. tostring(mod)) end
+  end
+  ```
+- **`loadstring` works in plugin context** (unlike in a running game without LoadStringEnabled),
+  but guard it: `if type(loadstring) ~= "function" then …`. Capture printed output by connecting
+  `LogService.MessageOut` for the duration of the call rather than trying to override `print`
+  (`setfenv` is unavailable in modern Luau).
+
+## Toolbar + lifecycle skeleton
+
+```lua
+local toolbar = plugin:CreateToolbar("My Plugin")
+-- label & tooltip are fixed here; state is shown via SetActive
+local button = toolbar:CreateButton("MyToggle", "Toggle the thing", "", "My Plugin")
+button.ClickableWhenViewportHidden = true
+
+local active = false
+local function setActive(v)
+    active = v
+    button:SetActive(v)
+    plugin:SetSetting("active", v)           -- survive reloads
+    -- start/stop your work here
+end
+
+button.Click:Connect(function() setActive(not active) end)
+plugin.Unloading:Connect(function() active = false end)
+
+if plugin:GetSetting("active") == true then setActive(true) end  -- auto-restore
+```
+
+For richer UI, use a dock widget:
+`plugin:CreateDockWidgetPluginGui(id, DockWidgetPluginGuiInfo.new(...))`, then parent a ScreenGui's
+contents into it. Keep it lazy — only build the widget when first shown.
+
+## Editing the DataModel safely
+
+- **Wrap mutations in undo recordings** so the user can Ctrl+Z your changes:
+  ```lua
+  local rec = ChangeHistoryService:TryBeginRecording("My action")
+  -- …make changes…
+  if rec then ChangeHistoryService:FinishRecording(rec, Enum.FinishRecordingOperation.Commit) end
+  ```
+  Use `Cancel` instead of `Commit` when the operation failed, so a no-op doesn't pollute history.
+- **Read/write script source via `ScriptEditorService`**, not just `.Source`. `GetEditorSource(s)`
+  reflects unsaved edits in an open document; `UpdateSourceAsync(s, fn)` writes safely even when
+  the script is open in the editor. Fall back to `s.Source` if the service call fails.
+- **Never edit `CoreGui` / `CorePackages`** (and the plugin's own GUI service). Guard against it —
+  walking an instance's ancestry and refusing protected names prevents corrupting the session.
+
+## HttpService from a plugin
+
+Plugins can call localhost. `HttpService:RequestAsync` **yields**, so run loops in `task.spawn`.
+A long-poll request blocks up to the server's hold time (well under the ~60s client timeout), so
+it's fine for command/event channels. Best-effort enable with `pcall(function()
+HttpService.HttpEnabled = true end)` and surface a clear message if requests fail (HTTP disabled or
+server down) instead of spamming — warn once per outage and back off.
+
+## Edit-mode caveats for common services
+
+Most things work in edit mode, but a few are subtle:
+- `TweenService:Create(…):Play()` advances in edit mode (Heartbeat runs) — usable for previews.
+- Playing animations on a rig needs an `Animator`; visible motion of a programmatic
+  `LoadAnimation():Play()` may require Play mode.
+- `Sound:Play()` previews in edit mode.
+- `Selection` (`game:GetService("Selection")`) reads/sets the Explorer selection; great for
+  pointing the user at what you changed.
+
+## Verifying a plugin
+
+You usually can't fully drive Studio headlessly. Verify by: build + install, restart/reopen Studio,
+confirm your startup log line appears (proves the new build loaded), click the toolbar button, and
+watch the Output. If the plugin pairs with an external process (e.g. an MCP/localhost server), a
+harness that starts the server and exercises it end-to-end while the real plugin answers is the
+most reliable check — see this repo's test pattern.

package/.agents/skills/roblox-ui-animation/SKILL.md

@@ -0,0 +1,233 @@
+---
+name: roblox-ui-animation
+description: >-
+  How to animate a Roblox GUI through the roblox-mcp-pro tools — open/close transitions, slide-ins,
+  fades, scale "pops", button hover/press feedback, and reproducing a motion you see in a reference
+  video. Covers TweenService/TweenInfo, which GUI properties to tween (Size, Position, transparency,
+  UIScale, Rotation), easing choices, and a growing library of reusable motion patterns. Use this
+  whenever the task involves animating UI in Roblox Studio — phrases like "animate this popup",
+  "make the menu slide in", "add an open/close animation", "tween the panel", "button hover effect",
+  "match the animation in this clip/video", or whenever a UI should move/fade/scale rather than just
+  appear. Pairs with manage_ui (build the GUI) and manage_tween/execute_luau (drive the motion).
+  Read this before writing any UI tween.
+---
+
+# Animating Roblox UI
+
+UI motion in Roblox is almost always `TweenService` interpolating GUI properties over time. The
+craft is picking **what** to tween, over **how long**, with **which easing**, so the result reads
+the way the reference does. Build the static UI first (see the `roblox-ui-from-image` skill), then
+layer motion on top.
+
+Drive tweens with `execute_luau` (full control, can `:Wait()` on completion) or the `manage_tween`
+tool for simple single-property tweens. Tweens **run in Studio edit mode** (Heartbeat advances), so
+you can build and watch them without entering Play mode.
+
+## Decode an animation from a reference video
+
+When the user gives you a clip/video of the motion they want, don't guess from memory — **extract
+frames and read the motion**. You can view images directly, so turn the video into images:
+
+1. **Probe** it: `ffprobe -v error -select_streams v:0 -show_entries stream=width,height,r_frame_rate,duration -of default=noprint_wrappers=1 <file>`.
+2. **Survey montage** — one image, whole clip at a glance, to find the animation windows and how
+   many cycles there are:
+   ```bash
+   ffmpeg -v error -i <file> -vf "fps=3,scale=300:-1,tile=6x7" -frames:v 1 survey.png
+   ```
+3. **Zoom in** on one transition at high fps to read direction + easing frame-by-frame:
+   ```bash
+   ffmpeg -v error -ss <start> -t <dur> -i <file> -vf "fps=15,scale=480:-1,tile=5x3" -frames:v 1 open.png
+   ```
+4. **Write the frames to a Windows-readable path** (e.g. `C:/Users/<you>/Downloads/_anim/`) so the
+   Read tool can open them — `/tmp` (bash) isn't visible to Read on Windows.
+5. **Read the montages** and write a **spec**: what element moves, which property changes (size /
+   position / transparency / scale / rotation), start→end values, duration, easing
+   (accelerate-in / decelerate-out / overshoot), and any delay/stagger between elements.
+
+Gotchas reading video: `drawtext` needs fontconfig (often missing) — skip frame-number overlays and
+track frames by tile position instead. A montage tile is low-res; zoom tighter (higher `-ss`/`-t`,
+fewer tiles, bigger `scale`) when you need to nail easing or see small elements.
+
+State the spec back to the user and note easing values are estimates from the footage (tunable).
+
+## Fundamentals
+
+**TweenInfo** is the recipe: `TweenInfo.new(time, easingStyle, easingDirection, repeatCount,
+reverses, delayTime)`.
+
+- **Time**: UI snaps best at **0.15–0.35s**. Longer feels sluggish; shorter is imperceptible.
+- **EasingStyle** — match the feel:
+  | Feel | Style / Direction |
+  | --- | --- |
+  | Smooth, neutral settle (default choice) | `Quad`/`Quint` + `Out` |
+  | Snappy, energetic settle | `Quint`/`Expo` + `Out` |
+  | Playful overshoot (pops past then back) | `Back` + `Out` |
+  | Bouncy landing | `Bounce` + `Out` |
+  | Elastic wobble | `Elastic` + `Out` |
+  | Symmetric in-and-out (e.g. a pulse) | `Sine` + `InOut` |
+  - `Out` decelerates into the end (best for things appearing). `In` accelerates (best for things
+    leaving). `InOut` for moves between two on-screen states.
+
+**What to tween** (and how):
+- **Size** — grow/shrink. For a "scale pop" prefer a child **`UIScale`** (`Scale` 0→1) over tweening
+  `Size` directly: it scales children too and won't fight layout. **A scale pivots around the
+  object's `AnchorPoint`** — set it to `[0.5,0.5]` for a symmetric pop from the center; an edge anchor
+  (e.g. `[1,0.5]`) makes it grow toward that edge, which looks lopsided. This applies to *every*
+  scale animation (panel open, hover pop): the anchor is the pivot. For an element that must stay
+  edge-pinned for layout, re-center it first (preserve its rect by reading `AbsolutePosition`/
+  `AbsoluteSize`) or scale an inner wrapper instead.
+- **Position** — slide in/out. Tween a `UDim2`; pair with `AnchorPoint` so it slides from the right edge.
+- **Transparency** — fade. `BackgroundTransparency` + `TextTransparency`/`ImageTransparency`. To fade
+  a whole panel as one unit, wrap it in a **`CanvasGroup`** and tween `GroupTransparency` (one value
+  fades everything, including strokes/gradients).
+- **Rotation** — spin/settle (e.g. an icon, or a slight tilt-in).
+- **UICorner / UIStroke.Thickness** — secondary polish.
+
+**Sequencing / stagger**: animate list items with a small increasing `delayTime` (e.g. 0.04s × index)
+so rows cascade instead of popping together — reads as "alive".
+
+## Pattern library
+
+### 1. Scale-pop panel + staggered children
+
+The popup **scales up from its center** (a small box that grows to full size with a slight overshoot
+"pop"); on close it scales back down. Its contents (cards/rows) then **fade in one by one** in a
+cascade. This is the classic "juicy" game HUD popup — what most reference clips of menus opening show.
+
+Two independent layers:
+- **Panel scale** via a `UIScale` (`Scale` 0→1). The panel **must be center-anchored**
+  (`AnchorPoint = [0.5,0.5]`) so it grows from the middle — the anchor is the pivot of the scale.
+  `Back`/`Out` gives the overshoot pop.
+- **Child stagger** via per-item **transparency** with an increasing `delayTime`. Fade — *not* Size
+  or UIScale — because items in a `UIListLayout` reflow when their `AbsoluteSize` changes, making the
+  list jump. Transparency doesn't touch layout.
+
+```lua
+local TweenService = game:GetService("TweenService")
+local panel = script.Parent:WaitForChild("Panel")
+panel.AnchorPoint = Vector2.new(0.5, 0.5)            -- pivot of the scale = center
+panel.Position = UDim2.new(0.5, 0, 0.5, 0)
+local scale = Instance.new("UIScale"); scale.Parent = panel
+
+local OPEN  = TweenInfo.new(0.30, Enum.EasingStyle.Back, Enum.EasingDirection.Out)
+local CLOSE = TweenInfo.new(0.20, Enum.EasingStyle.Quad, Enum.EasingDirection.In)
+
+-- every transparency-bearing prop of a subtree, so we can hide → fade it back in
+local FADE = { BackgroundTransparency = true, TextTransparency = true, ImageTransparency = true }
+local function faders(root)
+    local out, scan = {}, root:GetDescendants(); table.insert(scan, root)
+    for _, d in ipairs(scan) do
+        for p in pairs(FADE) do
+            local ok, v = pcall(function() return d[p] end)
+            if ok and typeof(v) == "number" and v < 1 then table.insert(out, { d, p, v }) end
+        end
+        if d:IsA("UIStroke") then table.insert(out, { d, "Transparency", d.Transparency }) end
+    end
+    return out
+end
+
+local rows = {}                                       -- the cards, in layout order
+for _, r in ipairs(panel.List:GetChildren()) do
+    if r:IsA("GuiObject") then table.insert(rows, r) end
+end
+table.sort(rows, function(a, b) return a.LayoutOrder < b.LayoutOrder end)
+
+local function open()
+    scale.Scale = 0
+    for _, r in ipairs(rows) do
+        for _, f in ipairs(faders(r)) do f[1][f[2]] = 1 end          -- hide cards
+    end
+    panel.Visible = true
+    TweenService:Create(scale, OPEN, { Scale = 1 }):Play()           -- pop the panel
+    for i, r in ipairs(rows) do                                      -- cascade the cards
+        local delay = (i - 1) * 0.05
+        for _, f in ipairs(faders(r)) do
+            TweenService:Create(f[1],
+                TweenInfo.new(0.22, Enum.EasingStyle.Quad, Enum.EasingDirection.Out, 0, false, delay),
+                { [f[2]] = f[3] }):Play()
+        end
+    end
+end
+
+local function close()
+    return TweenService:Create(scale, CLOSE, { Scale = 0 })          -- :Play() then hide on .Completed
+end
+```
+
+The cards also *rise* a little as they fade in the reference. A true positional rise inside a
+`UIListLayout` fights the layout — wrap each card in a `CanvasGroup` and tween `GroupTransparency`
+plus an inner offset, rather than moving the card frame itself.
+
+For **hover pop** on the buttons, the same pivot rule bites: a button anchored `[1,0.5]` pops toward
+its right edge. Re-center it before adding the hover `UIScale`:
+```lua
+local function recenter(o)                 -- preserve the rect, move the anchor to the middle
+    local rel = o.AbsolutePosition - o.Parent.AbsolutePosition
+    o.AnchorPoint = Vector2.new(0.5, 0.5)
+    o.Position = UDim2.fromOffset(math.round(rel.X + o.AbsoluteSize.X/2),
+                                  math.round(rel.Y + o.AbsoluteSize.Y/2))
+end                                        -- run after layout settles (RunService.Heartbeat:Wait())
+```
+
+### 2. Clip-reveal panel (vertical "unroll")
+
+The panel keeps full width and **grows in height from its top edge**; a `ClipsDescendants` container
+reveals its contents top-to-bottom like unrolling a scroll. Close is the reverse. Snappy and clean —
+common in game HUD popups.
+
+**Critical rule — anchor every child to the TOP** (position by offset from the top edge). A child
+anchored to the panel's *bottom* edge (`AnchorPoint.Y = 1`, `Position [[..],[1,..]]`) will **slide up
+with the shrinking edge instead of being revealed in place**, breaking the illusion. Convert any
+bottom-pinned child to a top offset at the same visual Y before animating.
+
+```lua
+local TweenService = game:GetService("TweenService")
+
+-- one-time rig: clip + re-anchor to the top so a height tween unrolls downward.
+local function setupReveal(panel)
+    local fullH = panel.Size.Y.Offset            -- assumes a fixed-offset height
+    panel.ClipsDescendants = true
+    panel.AnchorPoint = Vector2.new(0.5, 0)
+    panel.Position = UDim2.new(0.5, 0, 0.5, -fullH / 2)   -- same visual center as a centered panel
+    panel:SetAttribute("FullH", fullH)
+end
+
+local OPEN  = TweenInfo.new(0.32, Enum.EasingStyle.Quint, Enum.EasingDirection.Out)
+local CLOSE = TweenInfo.new(0.26, Enum.EasingStyle.Quint, Enum.EasingDirection.In)
+
+local function open(panel)
+    local h = panel:GetAttribute("FullH")
+    panel.Size = UDim2.new(panel.Size.X.Scale, panel.Size.X.Offset, 0, 0)
+    panel.Visible = true
+    TweenService:Create(panel, OPEN,
+        { Size = UDim2.new(panel.Size.X.Scale, panel.Size.X.Offset, 0, h) }):Play()
+end
+
+local function close(panel)
+    local t = TweenService:Create(panel, CLOSE,
+        { Size = UDim2.new(panel.Size.X.Scale, panel.Size.X.Offset, 0, 0) })
+    t.Completed:Connect(function() panel.Visible = false end)
+    t:Play()
+end
+```
+
+Optional flourish seen in reference clips: a **burst/sparkle** sprite that scales up and fades at the
+center on open/close — an `ImageLabel` with a starburst asset, `UIScale` 0.5→1.4 + `ImageTransparency`
+0→1 over ~0.25s. Needs a real `rbxassetid://` image.
+
+<!-- Append new patterns here as they're decoded: scale-pop, slide-in, fade+blur backdrop, stagger list, etc. -->
+
+## Gotchas
+
+- **Verifying motion with a single screenshot is impossible.** `capture_studio` is one frame. To
+  sanity-check a transition, set the element to a **mid-state** (e.g. 45% of the way) and capture
+  that, or `:Wait()` on the tween and capture the settled end state. Tell the user to watch the live
+  tween in Studio for the motion itself.
+- **`ui_preview` shows a clone.** Tweening the StarterGui original won't animate the preview overlay.
+  Hide the preview and run the tween on the real GUI (Studio renders StarterGui in the edit viewport).
+- **ColorSequence (UIGradient.Color) can't be tweened by TweenService.** Tween `UIGradient.Offset` or
+  `Rotation` for motion, or step the color in a `RenderStepped`/`Heartbeat` loop.
+- **Reuse, don't recreate.** Define `open`/`close` once (a ModuleScript or LocalScript) and call them;
+  don't rebuild tweens per click.
+- **Clean up on close.** Disconnect `Completed`/input connections and set `Visible=false` after a
+  close tween so a hidden panel doesn't eat clicks.

package/.agents/skills/roblox-ui-from-image/SKILL.md

@@ -0,0 +1,138 @@
+---
+name: roblox-ui-from-image
+description: >-
+  How to reproduce a UI design/mockup as a Roblox GUI through the roblox-mcp-pro tools — turning a
+  pasted screenshot, Figma export, or reference image into a pixel-close ScreenGui. Use whenever
+  the user supplies an image of a UI (HUD, menu, shop, popup, title screen, inventory, settings
+  panel) and wants it built in Roblox Studio, or says things like "make this UI", "build this
+  screen", "copy this layout", "match this design". Covers the build→preview→capture→compare→refine
+  loop with manage_ui, ui_preview, and capture_studio, plus UDim2/Color3 conventions and component
+  recipes. Read this before building UI from a reference.
+---
+
+# Building Roblox UI from an image
+
+Goal: given a reference image of a UI, produce a Roblox `ScreenGui` that looks like it. The win
+comes from a **visual feedback loop** — build, look at the real render, compare to the mockup, fix
+— not from one-shot guessing.
+
+## The loop
+
+1. **Get the image.** The user pastes/drags it into chat (you see it directly — no tool needed) or
+   gives a file path you can read. Study it before building.
+2. **Analyze the design** (see checklist below) — structure, sizes, colors, fonts, spacing.
+3. **Build** with `manage_ui` (`action: "create"`, `replace: true` so re-runs don't stack copies).
+4. **Preview clean**: `ui_preview` (`action: "show"`, `path:` your ScreenGui) renders it full-screen
+   on a solid backdrop in edit mode (hides the 3D scene behind it).
+5. **Capture**: `capture_studio` — now you see your UI isolated, centered in the viewport.
+6. **Compare** the capture to the mockup. Note differences (position, size, color, font, spacing).
+7. **Refine** with `manage_ui` (`action: "set"`) on the specific paths, then repeat 5–6 until close.
+8. **Done**: `ui_preview` (`action: "hide"`) to remove the preview overlay.
+
+Always `system_info` first to confirm the plugin is connected. Studio renders `StarterGui` content
+in the edit viewport, so a capture without `ui_preview` also works — but `ui_preview` gives a clean
+backdrop for accurate comparison.
+
+## Analyze the mockup (before building)
+
+- **Hierarchy**: outermost container(s) → panels → elements. Map to ScreenGui → Frame(s) → children.
+- **Anchoring/position**: is it centered, corner-pinned, edge-docked? Pick `AnchorPoint` + `Position`
+  accordingly (center = `AnchorPoint [0.5,0.5]`, `Position [[0.5,0],[0.5,0]]`).
+- **Sizing**: fixed px (offset) vs proportional (scale). Cards/buttons are usually offset; full-screen
+  dim layers are scale.
+- **Colors**: background, panel, accent, text. Convert to `[r,g,b]` 0–1.
+- **Text**: content, font (GothamBold/Gotham/etc.), size, alignment, color.
+- **Corners/strokes/gradients**: rounded → `UICorner`; outline → `UIStroke`; gradient → `UIGradient`.
+- **Repetition/lists**: rows/grids → `UIListLayout`/`UIGridLayout` instead of hand-placing each item.
+
+## Conventions (roblox-mcp-pro property formats)
+
+- `Size`/`Position` are **UDim2**: `[[xScale,xOffset],[yScale,yOffset]]`.
+  - Centered 360×200 card: `Size [[0,360],[0,200]]`, `AnchorPoint [0.5,0.5]`, `Position [[0.5,0],[0.5,0]]`.
+- `BackgroundColor3`/`TextColor3` are **Color3** `[r,g,b]` 0–1 (e.g. `[0.12,0.14,0.2]`).
+- `AnchorPoint` is `[x,y]` (Vector2, 0–1). `Font` is an enum name string (`"GothamBold"`).
+- `UICorner.CornerRadius` is a **UDim**: `[scale,offset]` → `[0,16]` for 16px corners.
+- Set `BorderSizePixel: 0` on Frames/buttons; `BackgroundTransparency: 1` on text-only labels.
+
+## Component recipes
+
+**Rounded panel**
+```
+{ className:"Frame", name:"Card",
+  properties:{ Size:[[0,360],[0,220]], AnchorPoint:[0.5,0.5], Position:[[0.5,0],[0.5,0]],
+               BackgroundColor3:[0.12,0.14,0.2], BorderSizePixel:0 },
+  children:[ { className:"UICorner", properties:{ CornerRadius:[0,16] } } ] }
+```
+
+**Button (rounded, accent — with edge highlight + readable text)**
+```
+{ className:"TextButton", name:"Play",
+  properties:{ Text:"PLAY", Font:"GothamBold", TextSize:20, TextColor3:[1,1,1],
+               BackgroundColor3:[0.2,0.7,0.4], Size:[[0,160],[0,48]], BorderSizePixel:0 },
+  children:[ { className:"UICorner", properties:{ CornerRadius:[0,10] } },
+             // edge highlight — ApplyStrokeMode "Border" (see below); Color is a LIGHTER tint of
+             // the fill ([0.2,0.7,0.4] → [0.4,0.95,0.5]) so the button pops
+             { className:"UIStroke", name:"Border",
+               properties:{ ApplyStrokeMode:"Border", Thickness:2, Color:[0.4,0.95,0.5] } },
+             // text outline — a SECOND stroke, Contextual + dark, so white text stays legible
+             { className:"UIStroke", name:"TextStroke",
+               properties:{ ApplyStrokeMode:"Contextual", Thickness:2, Color:[0,0,0] } } ] }
+```
+
+**Button with a gradient background (gradient must NOT tint the text)**
+A `UIGradient` on a `TextButton` recolors the **text too**, not just the fill. To keep the gradient
+on the button only, give the button empty `Text` and move the label into a child `TextLabel`.
+Also: `UIGradient` **multiplies** with the object's own color, so set the fill `BackgroundColor3` to
+**white `[1,1,1]`** — otherwise the gradient comes out tinted/darker than the colors you specified:
+```
+{ className:"TextButton", name:"Play",
+  properties:{ Text:"", BackgroundColor3:[1,1,1], Size:[[0,160],[0,48]], BorderSizePixel:0 },
+  children:[ { className:"UICorner", properties:{ CornerRadius:[0,10] } },
+             { className:"UIGradient", properties:{ Rotation:90 } },  // set .Color via execute_luau
+             { className:"UIStroke", name:"Border",
+               properties:{ ApplyStrokeMode:"Border", Thickness:2, Color:[0.4,0.95,0.5] } },
+             // text in its OWN label → the button's gradient can't reach it
+             { className:"TextLabel", name:"Label",
+               properties:{ Text:"PLAY", Font:"GothamBold", TextSize:20, TextColor3:[1,1,1],
+                            BackgroundTransparency:1, Size:[[1,0],[1,0]] },
+               children:[ { className:"UIStroke", properties:{ Thickness:2, Color:[0,0,0] } } ] } ] }
+```
+
+**Vertical list (auto-stacked rows)**
+```
+{ className:"Frame", name:"List", properties:{ BackgroundTransparency:1, Size:[[1,0],[1,0]] },
+  children:[ { className:"UIListLayout",
+               properties:{ Padding:[0,8], FillDirection:"Vertical",
+                            HorizontalAlignment:"Center", SortOrder:"LayoutOrder" } },
+             /* row frames here */ ] }
+```
+
+## Notes & limits
+
+- **One-call builds**: pass the whole nested `tree` to `manage_ui create` — don't create node-by-node.
+- **Iterate with `set`**: once built, tweak single properties via `manage_ui set` on the exact path
+  (cheaper than rebuilding) — unless restructuring, then `create` with `replace:true`.
+- **ImageLabel/ImageButton** need a real `Image` asset id (`rbxassetid://…`). If the mockup has
+  images you don't have ids for, build the layout with placeholder Frames and tell the user which
+  images to upload.
+- **Gradients/sequences**: `UIGradient.Color` (ColorSequence) and similar sequence properties may not
+  coerce from simple arrays — set a solid color first, and use `execute_luau` for a true gradient if
+  needed. A `UIGradient` on a `TextButton`/`TextLabel` also **tints the text**, not just the fill —
+  to gradient the button only, give the button empty `Text` and move the label into a child
+  `TextLabel` with `BackgroundTransparency:1` (see the gradient-button recipe above).
+- **UIGradient multiplies with the base color**: the gradient is *multiplied over* the object's own
+  color, so to get the exact ColorSequence colors you specified, first set the underlying property to
+  **white** — `BackgroundColor3:[1,1,1]` for a fill gradient, `TextColor3:[1,1,1]` for a text
+  gradient. A non-white base darkens/tints the whole gradient.
+- **UIStroke on buttons/text — the two-stroke rule**: a `UIStroke` under a `TextButton`/`TextLabel`
+  defaults to `ApplyStrokeMode = "Contextual"`, which outlines the **text glyphs, not the button
+  border**. So a single default stroke gives you a text outline when you wanted an edge highlight.
+  - For a button **edge/glow highlight**, set `ApplyStrokeMode:"Border"`.
+  - **Highlight color = a lighter/whiter tint of the button's own fill**, not a contrasting accent.
+    Push the `BackgroundColor3` toward white (raise each channel, e.g. green fill `[0.2,0.7,0.4]` →
+    edge `[0.4,0.95,0.5]`) so the rim reads as a lit edge and the button visually pops off the panel.
+  - To get **both** an edge highlight *and* a crisp text outline, add **two** UIStrokes on the same
+    button: one `"Border"` (the lighter-tint edge) and one `"Contextual"` (the text). They target
+    different parts and both render.
+  - The **text** stroke should be a **dark/near-black** color so white button text stays legible.
+- After previewing, always `ui_preview hide` so the overlay doesn't linger in CoreGui.

package/README.md

@@ -199,22 +199,16 @@ behavior, set the env var `ROBLOX_MCP_NO_PLUGIN_AUTOINSTALL=1`.)
 Open Roblox Studio — a **Roblox MCP Pro** button appears in the toolbar. (Studio turns on HTTP
 requests automatically when you connect; if needed, set `HttpService.HttpEnabled = true`.)
 
-### Part 3 — Install the agent skills (recommended)
+### Part 3 — Agent skills (automatic)
 
 Skills are short guides that teach your AI how to use the tools well (building UI from an image,
-animating GUIs, writing Studio plugins, etc.). **Only Claude Code and Codex read skills today** —
-other clients still work fine, just without the extra guidance.
+animating GUIs, writing Studio plugins, etc.). **You don't need to do anything** — the server
+installs them for you on startup, the same way it installs the plugin. Only **Claude Code**
+(`~/.claude/skills`) and **Codex** (`~/.codex/skills`) have a skills mechanism, so skills are
+copied there when those clients are present; other clients still work fine, just without the extra
+guidance.
 
-The Windows quick-installer above does this for you. To do it manually, copy each folder from this
-repo's `.agents/skills/` into your agent's skills directory:
-
-| Agent | Skills folder |
-|-------|----------------|
-| Claude Code | `%USERPROFILE%\.claude\skills\` |
-| Codex | `%USERPROFILE%\.codex\skills\` |
-
-Skills to copy: `roblox-mcp-pro`, `roblox-ui-from-image`, `roblox-ui-animation`,
-`roblox-studio-plugin`. Each ends up as `…\skills\<name>\SKILL.md`.
+(To opt out, set `ROBLOX_MCP_NO_SKILL_AUTOINSTALL=1`.)
 
 ### Part 4 — Connect & verify
 

package/dist/index.js

@@ -16,6 +16,7 @@ import { BRIDGE_HOST, BRIDGE_PORT } from "./constants.js";
 import { resolveLicense } from "./licensing/license.js";
 import { installLicenseGate } from "./licensing/gate.js";
 import { installPlugin, ensurePluginInstalled } from "./install-plugin.js";
+import { ensureSkillsInstalled } from "./install-skills.js";
 import { VERSION } from "./version.js";
 function log(message) {
     process.stderr.write(`[roblox-mcp-pro] ${message}\n`);
@@ -43,6 +44,13 @@ async function main() {
             log(`updated Studio plugin → restart Roblox Studio to load the new version`);
         }
     }
+    // Keep agent skills up to date for skill-capable clients (Claude Code, Codex).
+    if (process.env.ROBLOX_MCP_NO_SKILL_AUTOINSTALL !== "1") {
+        const skills = await ensureSkillsInstalled();
+        if (skills.changed > 0) {
+            log(`installed/updated ${skills.changed} agent skill file(s)`);
+        }
+    }
     const server = new McpServer({
         name: "roblox-studio-mcp-server",
         version: "0.1.0",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/install-skills.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Agent-skill distribution. The product skills (guides that teach an agent how
+ * to drive the tools well) ship inside this npm package. On server startup we
+ * copy them into the skill folders of any skill-capable client present on the
+ * machine, so a customer gets them with zero effort, the same way the Studio
+ * plugin self-installs.
+ *
+ * Only Claude Code (~/.claude/skills) and Codex (~/.codex/skills) have a skills
+ * mechanism today; other clients still work, just without the extra guidance.
+ */
+export interface SkillSyncResult {
+    /** Number of skill files newly written or updated. */
+    changed: number;
+    /** Skill-capable clients that received skills. */
+    clients: number;
+}
+/**
+ * Copy bundled skills into each present skill-capable client, writing only when
+ * a file is missing or different. Best-effort: never throws.
+ */
+export declare function ensureSkillsInstalled(): Promise<SkillSyncResult>;
+//# sourceMappingURL=install-skills.d.ts.map

package/dist/install-skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.d.ts","sourceRoot":"","sources":["../src/install-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsCH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,eAAe,CAAC,CAiCtE"}

package/dist/install-skills.js

@@ -0,0 +1,81 @@
+/**
+ * Agent-skill distribution. The product skills (guides that teach an agent how
+ * to drive the tools well) ship inside this npm package. On server startup we
+ * copy them into the skill folders of any skill-capable client present on the
+ * machine, so a customer gets them with zero effort, the same way the Studio
+ * plugin self-installs.
+ *
+ * Only Claude Code (~/.claude/skills) and Codex (~/.codex/skills) have a skills
+ * mechanism today; other clients still work, just without the extra guidance.
+ */
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promises as fs } from "node:fs";
+/** Product skills bundled in the package (must match package.json `files`). */
+const SKILLS = [
+    "roblox-mcp-pro",
+    "roblox-studio-plugin",
+    "roblox-ui-animation",
+    "roblox-ui-from-image",
+];
+/** Skill-capable clients: parent dir that must exist → its skills/ root. */
+function skillTargets() {
+    const h = os.homedir();
+    return [
+        { parent: path.join(h, ".claude"), skillsDir: path.join(h, ".claude", "skills") },
+        { parent: path.join(h, ".codex"), skillsDir: path.join(h, ".codex", "skills") },
+    ];
+}
+function skillsSourceDir() {
+    // dist/install-skills.js → ../.agents/skills (package root; shipped by npm).
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.join(here, "..", ".agents", "skills");
+}
+async function readIfPresent(p) {
+    try {
+        return await fs.readFile(p);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Copy bundled skills into each present skill-capable client, writing only when
+ * a file is missing or different. Best-effort: never throws.
+ */
+export async function ensureSkillsInstalled() {
+    const result = { changed: 0, clients: 0 };
+    const sourceDir = skillsSourceDir();
+    for (const target of skillTargets()) {
+        try {
+            // Only act on clients that are actually installed.
+            await fs.access(target.parent);
+        }
+        catch {
+            continue;
+        }
+        result.clients++;
+        for (const skill of SKILLS) {
+            try {
+                const src = path.join(sourceDir, skill, "SKILL.md");
+                const source = await readIfPresent(src);
+                if (!source)
+                    continue; // skill not in package; skip quietly
+                const destDir = path.join(target.skillsDir, skill);
+                const dest = path.join(destDir, "SKILL.md");
+                const existing = await readIfPresent(dest);
+                if (existing && existing.equals(source))
+                    continue;
+                await fs.mkdir(destDir, { recursive: true });
+                await fs.writeFile(dest, source);
+                result.changed++;
+            }
+            catch {
+                // Skip this skill on error; keep going.
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=install-skills.js.map

package/dist/install-skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skills.js","sourceRoot":"","sources":["../src/install-skills.ts"],"names":[],"mappings":"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"}

package/dist/schemas/common.d.ts

@@ -2,13 +2,10 @@
  * Reusable Zod fragments shared across tool schemas.
  */
 import { z } from "zod";
-import { ResponseFormat } from "../types.js";
 /** A dotted instance path rooted at `game`, e.g. "game.Workspace.Baseplate". */
 export declare const InstancePath: z.ZodString;
 /** A 3-number [x, y, z] vector. */
 export declare const Vec3: z.ZodArray<z.ZodNumber, "many">;
-/** Output format selector (markdown for humans, json for machines). */
-export declare const responseFormat: z.ZodDefault<z.ZodNativeEnum<typeof ResponseFormat>>;
 /** Standard pagination fragment. */
 export declare const pagination: {
     limit: z.ZodDefault<z.ZodNumber>;

package/dist/schemas/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,gFAAgF;AAChF,eAAO,MAAM,YAAY,aAOtB,CAAC;AAEJ,mCAAmC;AACnC,eAAO,MAAM,IAAI,iCAG0B,CAAC;AAE5C,uEAAuE;AACvE,eAAO,MAAM,cAAc,sDAKxB,CAAC;AAEJ,oCAAoC;AACpC,eAAO,MAAM,UAAU;;;CActB,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,eAAO,MAAM,YAAY,aAOtB,CAAC;AAEJ,mCAAmC;AACnC,eAAO,MAAM,IAAI,iCAG0B,CAAC;AAE5C,oCAAoC;AACpC,eAAO,MAAM,UAAU;;;CActB,CAAC"}

package/dist/schemas/common.js

@@ -2,7 +2,6 @@
  * Reusable Zod fragments shared across tool schemas.
  */
 import { z } from "zod";
-import { ResponseFormat } from "../types.js";
 /** A dotted instance path rooted at `game`, e.g. "game.Workspace.Baseplate". */
 export const InstancePath = z
     .string()
@@ -15,11 +14,6 @@ export const Vec3 = z
     .array(z.number())
     .length(3)
     .describe("A 3-number [x, y, z] vector.");
-/** Output format selector (markdown for humans, json for machines). */
-export const responseFormat = z
-    .nativeEnum(ResponseFormat)
-    .default(ResponseFormat.MARKDOWN)
-    .describe("Output format: 'markdown' for human-readable text or 'json' for machine-readable.");
 /** Standard pagination fragment. */
 export const pagination = {
     limit: z

package/dist/schemas/common.js.map

@@ -1 +1 @@
-{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;KAChC,GAAG,CAAC,GAAG,EAAE,qCAAqC,CAAC;KAC/C,QAAQ,CACP,2EAA2E;IACzE,2BAA2B,CAC9B,CAAC;AAEJ,mCAAmC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACjB,MAAM,CAAC,CAAC,CAAC;KACT,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAE5C,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC;KAC5B,UAAU,CAAC,cAAc,CAAC;KAC1B,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC;KAChC,QAAQ,CACP,mFAAmF,CACpF,CAAC;AAEJ,oCAAoC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,2DAA2D,CAAC;IACxE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,wDAAwD,CAAC;CACtE,CAAC"}
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/schemas/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;KAChC,GAAG,CAAC,GAAG,EAAE,qCAAqC,CAAC;KAC/C,QAAQ,CACP,2EAA2E;IACzE,2BAA2B,CAC9B,CAAC;AAEJ,mCAAmC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC;KAClB,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;KACjB,MAAM,CAAC,CAAC,CAAC;KACT,QAAQ,CAAC,8BAA8B,CAAC,CAAC;AAE5C,oCAAoC;AACpC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,2DAA2D,CAAC;IACxE,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,wDAAwD,CAAC;CACtE,CAAC"}

package/dist/types.d.ts

@@ -35,11 +35,6 @@ export interface BridgeStatus {
     inflight: number;
     lastPollAt: number | null;
 }
-/** Output format shared by many tools. */
-export declare enum ResponseFormat {
-    MARKDOWN = "markdown",
-    JSON = "json"
-}
 /** A change event pushed from Studio -> server (used by sync). */
 export interface StudioEvent {
     /** Event kind, e.g. "added" | "removing" | "changed". */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uEAAuE;AACvE,MAAM,WAAW,OAAO;IACtB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,0CAA0C;AAC1C,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,IAAI,SAAS;CACd;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,uEAAuE;AACvE,MAAM,WAAW,OAAO;IACtB,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,IAAI,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,gCAAgC;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/types.js

@@ -1,10 +1,5 @@
 /**
  * Core type definitions shared across the MCP server and the Studio bridge.
  */
-/** Output format shared by many tools. */
-export var ResponseFormat;
-(function (ResponseFormat) {
-    ResponseFormat["MARKDOWN"] = "markdown";
-    ResponseFormat["JSON"] = "json";
-})(ResponseFormat || (ResponseFormat = {}));
+export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuCH,0CAA0C;AAC1C,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,uCAAqB,CAAA;IACrB,+BAAa,CAAA;AACf,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roblox-mcp-pro",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "MCP server that lets AI agents control Roblox Studio: live Luau execution, instance query/mutate, UI/terrain/lighting, and bidirectional Studio<->local sync. Paid subscription with a free trial.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Peerapol",
@@ -32,6 +32,10 @@
     "plugin/src",
     "plugin/default.project.json",
     "plugin/RobloxMcpPro.rbxmx",
+    ".agents/skills/roblox-mcp-pro",
+    ".agents/skills/roblox-studio-plugin",
+    ".agents/skills/roblox-ui-animation",
+    ".agents/skills/roblox-ui-from-image",
     "README.md",
     "LICENSE"
   ],