This skill helps an agent handle physics and spatial queries in Roblox. It first decides whether a job is simulation, character control, hit detection or visual motion, then picks the API: constraints and impulses, Raycast and Shapecast, or overlap queries with explicit filters.
It includes a server raycast pattern, an overlap pattern that deduplicates by model, rules for assemblies and network ownership, notes for places that use Server Authority, and a table of symptoms such as welded parts that will not move or rays that hit the shooter.
What You Get
- A table that maps each goal to a mechanism: constraints, impulses, scripted pivots, Humanoid, server queries or local visuals
- A seven-step workflow from inspecting assemblies to checking facts from code in a play session
- Luau patterns for a filtered server raycast and an overlap volume with model deduplication
- A symptom, cause and remedy table plus a reference with query choice, ownership debugging and a test matrix
Common Use Cases
- Finding why a welded mechanism will not move
- Stopping a raycast from hitting the shooter or effect parts
- Replacing deprecated BodyMovers with LinearVelocity and AlignPosition
- Choosing who owns a loose assembly such as a vehicle
What Makes It Unique
The skill separates the three Can flags and tells the agent to define each by role. It sizes forces from mass and intended acceleration and treats Touched as unreliable for hits. It leaves the question of whether a hit counts to the networking skill and supplies only the queries that skill uses.
Under The Hood
The agent loads the SKILL.md and, for collision design or ownership work, one reference on flags, queries, ownership debugging and a verification matrix. It reads and edits Luau files in the project. With a connected Roblox Studio MCP server it starts play, runs Luau on the server to print assembly, mass, owner and collision facts, and reads the console. Without that server it asks you to run the same snippet in the Command Bar and paste the Output. Documentation URLs are listed for re-checking APIs, and nothing is fetched during normal use. An agent settings file for OpenAI sits beside the skill.