iwsdk-grab
Skill1 starsChanged 32 days agoMITView on GitHub
Use emulated XR controllers to verify proximity grabbing for OneHandGrabbable and TwoHandsGrabbable objects. Use for pick up, move, release, or regression-test requests involving near-hand grab with the squeeze button.
In this repository58 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- cf-cliSkill
- durable-objectsSkill
- game-gdd-authorSkill
- game-playtestSkill
- pmndrs-handleSkill
- pmndrs-pointer-eventsSkill
- pmndrs-uikitSkill
- prototype-fastSkill
- pwa-offlineSkill
- review-game-trailerSkill
- scenario-blender-expertSkill
- scenario-blender-retopologySkill
- scenario-blender-uv-bakingSkill
- threejs-perf-loadingSkill
- webapp-testingSkill
- workers-best-practicesSkill
- wranglerSkill
- xr-perceptual-constraints-displays-and-trackingSkill
- xr-platforms-audio-and-comfortSkill
- xr-referenceSkill
- xr-rendering-input-and-spatial-understandingSkill
- xr-ux-design-and-performance-budgetingSkill
- horizon-launch-roadmapSkill
- horizon-store-listing-assetsSkill
- horizon-web-store-publishSkill
- horizon-web-vrc-checklistSkill
- iwsdk-asset-pipelineSkill
- iwsdk-dev-workflowSkill
- iwsdk-performanceSkill
- iwsdk-project-setupSkill
- iwsdk-quest-device-testingSkill
- iwsdk-testingSkill
- iwsdk-vr-glassesSkill
- quest-browser-webxrSkill
- iwsdk-build-modelSkill
- iwsdk-compose-sceneSkill
- iwsdk-debugSkill
- iwsdk-depth-occlusionSkill
- iwsdk-devSkill
- iwsdk-hostingSkill
- iwsdk-migrate-0-5Skill
- iwsdk-native-xr-testSkill
- iwsdk-physicsSkill
- iwsdk-pwa-packagingSkill
- iwsdk-raySkill
- iwsdk-uiSkill
- hz-immersive-designerSkill
- hz-iwsdk-webxrSkill
- hz-new-project-creationSkill
- hz-perfetto-debugSkill
- hz-quest-verify-firstSkill
- hz-simpleperf-debugSkill
- hz-store-pwaSkill
- hz-store-submitSkill
- hz-vr-debugSkill
- metavr-cliSkill
The file
We split this skill into the rules it gives an agent
7 rules. About 0 are common, 3 are distinctive, and 4 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
4
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 9
Use this workflow only for OneHandGrabbable or TwoHandsGrabbable.
- Distinctive: line 14
Check XR session state and enter XR only when inactive.
- Distinctive: line 30
If movement was requested, animate the held controller to the destination.
- Very specific: line 35
Do not use trigger index 0, xr select, or teleport-style device mutation for proximity grab.
- Distinctive: line 41
Prefer measured ECS state over screenshots.
- Very specific: line 46
When the request names an artifact path, save it directly with npx @iwsdk/cli browser screenshot --output-file <path>.
- Very specific: line 50
Stop once the requested grab/move/release path and final state are proven.
≈ “Common” is an estimate: at least 1 in 5 of the 372,429 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
IWSDK Proximity Grab
Use this workflow only for OneHandGrabbable or TwoHandsGrabbable. A
DistanceGrabbable uses the ray/trigger path instead.
Execute the requested path
- Check XR session state and enter XR only when inactive.
- Find the named live entity and query its components and transform. If it is absent, list nearby grabbable matches once and stop with the evidence.
- Confirm it has
OneHandGrabbableorTwoHandsGrabbable. Do not guess the interaction type from its name. - Animate the requested controller to the object. Default to the right controller only when the user did not choose a hand.
Press and hold squeeze/grip button index
1:{"device":"controller-right","buttons":[{"index":1,"value":1}]}- Query the entity for
Grabbedor another requested observable state. If the grab did not qualify, make one focused correction to controller position and retry once. - If movement was requested, animate the held controller to the destination.
- Release squeeze with index
1, value0, then query the final transform or state. Move the controller away only when overlap would interfere with the result.
Do not use trigger index 0, xr select, or teleport-style device mutation for
proximity grab. Do not edit source merely to make an existing named entity easier
to locate; report missing runtime identity when that is the actual defect.
Evidence and stopping
Prefer measured ECS state over screenshots. Capture one runtime image only when the user requested visual evidence or placement must be judged. Batch related queries and avoid repeating session, hierarchy, or transform discovery after a successful read.
When the request names an artifact path, save it directly with
npx @iwsdk/cli browser screenshot --output-file <path>. A screenshot returned only
to model context does not satisfy a requested file deliverable.
Stop once the requested grab/move/release path and final state are proven. Leave the controller released and the XR session in the state the user requested.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

