Skip to content
SkillModel-led1,865 tokens in use

roblox-physics

Helps an agent pick the right Roblox physics mechanism: assemblies and constraints, collision groups, server raycasts and overlaps, and network ownership.

9,684 stars on the repository Apache License 2.0gamedev-skills/awesome-gamedev-agent-skills · skills/other-engines/roblox-physics
npx skills add gamedev-skills/awesome-gamedev-agent-skills
View source

Install command as written in the repository's README

Skill label

measured from its files

What installing roblox-physics costs

85tokens idle
1,865tokens in use
2,561tokens, up to

Idle is what sits in context while the skill is installed. In use is its instructions, loaded when it runs. Up to adds the files its instructions link. Counts are approximate, made offline with cl100k_base.

Model dependence Model-led

Script-ledMixedModel-led

Mostly instructions, so how well it works depends on the model that follows them.

This describes the skill's structure, how much of it is scripts. It does not say how well it works.

Touches

Nothing detected: no shell, network, file writes, git or credentials in its files.

Declared tags come from the skill's frontmatter; detected ones from its scripts, its code blocks and the commands it names in inline code. This is detected, not audited.

How it scores

Quality

How well the skill is written, counted from its own files: its frontmatter, its steps, examples, stated output and constraints, its size and whether every file it ships is one it names.How we score it →
Good
  • Frontmatter12/15
  • Structure25/25
  • Examples9/15
  • Output10/15
  • Size13/15
  • Resources7/15

Security

Starts at 100 and loses points for each thing in the skill's files that a reader should look at first.How we score it →
Excellent

No findings.

Repository health

Pre-computed score based on development activity, maintenance, community, maturity, and trend momentum.How we score it →
Good
  • Development activity92
  • Maintenance96
  • Community60
  • Maturity24
  • Momentum40

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.

Join founders building with open source

Opinionated takes, migration guides, cost-saving tips, and insights from the open source ecosystem.

Subscribe on SubstackJoin 750+ subscribers