api-world-query

Cast rays against real-world surfaces using WorldQueryModule for AR object placement in LensStudio/TypeScript workflows.

Updated Jun 24, 2026
One-click install
npx skills add https://github.com/specs-devs/agentic-tools --skill api-world-query
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-world-query
Source: https://github.com/specs-devs/agentic-tools/tree/main/skills/api-world-query
Command: npx skills add https://github.com/specs-devs/agentic-tools --skill api-world-query

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides fast ray casting against real-world surfaces to support accurate AR object placement, depth testing, and surface-normal alignment in Spectacles.

Core Features & Use Cases

  • Real-time surface hit testing using the WorldQueryModule for AR object placement.
  • Depth-aware placement with surface normals for natural alignment on floors, tables, and other surfaces.
  • Use Case: Build AR experiences that spawn objects precisely where the user points, with stable grounding on detected surfaces.

Quick Start

Place an AR object on the first detected real-world surface using WorldQueryModule.

Frequently Asked Questions about api-world-query

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I place AR objects on real-world surfaces in Spectacles?

To place AR objects on real-world surfaces, you use ray casting to perform hit tests against detected environments. This enables stable grounding and precise object spawning where the user points in the AR space.

Can I align spawned AR objects using surface normals and depth data?

Yes, depth-aware placement utilizes surface normals to achieve natural alignment on floors and tables. This ensures AR objects conform accurately to the physical geometry of detected real-world surfaces.

Do I need the WorldQueryModule to perform hit testing in LensStudio?

Yes, WorldQueryModule is required to execute real-time surface hit testing for AR object placement. It must be available within your LensStudio TypeScript workflow to manage hit-test sessions.

What's the best way to manage ray input for surface placement in TypeScript?

The best way to manage ray input for surface placement is using SIK-based ray input integrated with your LensStudio TypeScript workflows. This combination handles hit-test sessions and rendering for AR object spawning.

Why does my AR object placement fail without depth data on Spectacles?

AR object placement fails without depth data because the ray casting mechanism relies on depth testing to detect real-world surfaces. Accurate hit tests require depth information to calculate surface normals and grounding.