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.