How do I install the Uloop Raycast skill?

Run npx skillmds@latest add haruma-k/uloop-raycast in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Uloop Raycast safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Uloop Raycast?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Uloop Raycast free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Uloop Raycast?

haruma-k (@haruma-k) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Uloop Raycast by haruma-k — Agent Skill

Name: Uloop Raycast
Author: haruma-k

File contents

npx --yes uloop-cli@2.2.0 raycast

Check what a top-left Game View coordinate hits in 3D physics.

Usage

npx --yes uloop-cli@2.2.0 raycast --x <x> --y <y> [--layer-mask <mask>] [--max-distance <distance>]

Parameters

Parameter	Type	Default	Description
`--x`	number	`0`	Target X position in Game View pixels (origin: top-left). Use `AnnotatedElements[].SimX`, `RaycastGridPoints[].InputX`, or raw image pixels converted with `ScreenshotToInputFormula`.
`--y`	number	`0`	Target Y position in Game View pixels (origin: top-left). Use `AnnotatedElements[].SimY`, `RaycastGridPoints[].InputY`, or raw image pixels converted with `ScreenshotToInputFormula`.
`--layer-mask`	number	Unity default raycast layers	Physics layer mask used by the raycast.
`--max-distance`	number	`1000`	Maximum raycast distance in world units.

Coordinate System

--x / --y use the same top-left Game View input coordinates as simulate-mouse-input.
Raw image pixels from npx --yes uloop-cli@2.2.0 screenshot --capture-mode rendering must be converted with ScreenshotToInputFormula.
AnnotatedElements[].SimX/SimY and RaycastGridPoints[].InputX/InputY can be passed directly to this tool.
Do not flip Y in the caller. The tool converts internally:

unity_x = input_x
unity_y = gameViewHeight - input_y

Examples

# Check what is under a screenshot coordinate
npx --yes uloop-cli@2.2.0 raycast --x 960 --y 540

# Check only specific layers
npx --yes uloop-cli@2.2.0 raycast --x 960 --y 540 --layer-mask 1

Output

Returns JSON with:

Success: Whether the command completed
Message: Status message
Hit: Whether physics hit anything
HitGameObjectName / HitGameObjectPath: Hit object identity when Hit is true
HitLayer / HitLayerName: Hit object layer when Hit is true
Distance, HitPointX/Y/Z, HitNormalX/Y/Z: Hit details when Hit is true
InputCoordinateSystem, UnityCoordinateSystem, GameViewWidth/Height, InputPositionX/Y, InjectedUnityPositionX/Y, CoordinateConversionFormula: Coordinate conversion details

Notes

Requires an active Camera.main.
Uses Unity Physics raycasts, not UI EventSystem raycasts.

---name: uloop-raycastdescription: Raycast from Camera.main through a Game View coordinate. Use when you need to check what a screenshot coordinate would hit in 3D physics before clicking or long-pressing with simulate-mouse-input.---# npx --yes uloop-cli@2.2.0 raycastCheck what a top-left Game View coordinate hits in 3D physics.## Usage```bashnpx --yes uloop-cli@2.2.0 raycast --x <x> --y <y> [--layer-mask <mask>] [--max-distance <distance>]```## Parameters| Parameter | Type | Default | Description ||-----------|------|---------|-------------|| `--x` | number | `0` | Target X position in Game View pixels (origin: top-left). Use `AnnotatedElements[].SimX`, `RaycastGridPoints[].InputX`, or raw image pixels converted with `ScreenshotToInputFormula`. || `--y` | number | `0` | Target Y position in Game View pixels (origin: top-left). Use `AnnotatedElements[].SimY`, `RaycastGridPoints[].InputY`, or raw image pixels converted with `ScreenshotToInputFormula`. || `--layer-mask` | number | Unity default raycast layers | Physics layer mask used by the raycast. || `--max-distance` | number | `1000` | Maximum raycast distance in world units. |## Coordinate System- `--x` / `--y` use the same top-left Game View input coordinates as `simulate-mouse-input`.- Raw image pixels from `npx --yes uloop-cli@2.2.0 screenshot --capture-mode rendering` must be converted with `ScreenshotToInputFormula`.- `AnnotatedElements[].SimX/SimY` and `RaycastGridPoints[].InputX/InputY` can be passed directly to this tool.- Do not flip Y in the caller. The tool converts internally:```textunity_x = input_xunity_y = gameViewHeight - input_y```## Examples```bash# Check what is under a screenshot coordinatenpx --yes uloop-cli@2.2.0 raycast --x 960 --y 540# Check only specific layersnpx --yes uloop-cli@2.2.0 raycast --x 960 --y 540 --layer-mask 1```## OutputReturns JSON with:- `Success`: Whether the command completed- `Message`: Status message- `Hit`: Whether physics hit anything- `HitGameObjectName` / `HitGameObjectPath`: Hit object identity when `Hit` is true- `HitLayer` / `HitLayerName`: Hit object layer when `Hit` is true- `Distance`, `HitPointX/Y/Z`, `HitNormalX/Y/Z`: Hit details when `Hit` is true- `InputCoordinateSystem`, `UnityCoordinateSystem`, `GameViewWidth/Height`, `InputPositionX/Y`, `InjectedUnityPositionX/Y`, `CoordinateConversionFormula`: Coordinate conversion details## Notes- Requires an active `Camera.main`.- Uses Unity Physics raycasts, not UI EventSystem raycasts.

Frequently asked questions

Uloop Raycast