lens-debug

Routes Lens Studio runtime bug symptoms to the specialist skill that owns the fix.

16|2|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/lens-studio-devs/ls-extensions --skill lens-debug-lens-studio-devs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lens-debug
Source: https://github.com/lens-studio-devs/ls-extensions/tree/main/plugins/ls-clad/skills/lens-debug
Command: npx skills add https://github.com/lens-studio-devs/ls-extensions --skill lens-debug-lens-studio-devs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Debugging Lens Studio Lenses is hard because symptoms like invisible objects, pink materials, or handlers that never fire can originate in rendering, scripting, physics, or tracking layers. This Skill triages a symptom description and routes it to the correct specialist skill or reference document instead of guessing at fixes. ## Core Features & Use Cases - Symptom-based decision tree: Maps visual symptoms (invisible, glitchy, pink material, layout wrong) and runtime symptoms (glued to head, handler not firing, asset not ready, physics drifting) to targeted triage cards in references/known-issues.md. - Specialist routing: Directs TypeScript scripting bugs to lens-api debugging references, Specs subsystem issues (SIK, RSG, SyncKit, VIO/SLAM) to specs-debug, and log reading to lens-log-analysis. - Debugging discipline: Enforces a Step 0 sanity check (Lens compiles, startup log clean, scene wiring complete), pacing rules for guessing vs incremental diagnosis, and a stop-and-ask rule when incremental debugging stalls. - Use Case: A developer reports an object stays glued to the camera. The Skill routes to the known-issues card, which identifies the missing DeviceTracking component or wrong parent transform as the most common cause. ## Quick Start Ask the agent to debug why my Lens Studio object is invisible at runtime using the lens-debug skill.

Frequently Asked Questions about lens-debug

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

FAQPage Schema
How do I debug an invisible object in Lens Studio?

Check sceneObject.enabled and component enabled state first, then verify the render layer is in the camera's Render Layer set and the object is within the camera near/far planes. The known-issues reference also covers single-sided meshes, z-fighting, and AABB bounds checks.

Why does my Lens Studio material show solid pink?

A solid pink or magenta material means a missing shader or texture asset, or an unassigned texture input slot on the material. Reimport the asset and confirm every required input in the Material Inspector points at a real texture.

Why is my Lens Studio event handler never firing?

Common causes are hierarchy order (a component's onAwake reading state another component sets later), subscribing to OnStartEvent after it already fired, or cross-object access from onAwake. Move cross-object work to onStart.

How do I stop Lens Studio content from following the camera?

Re-parent the object out from under the Camera so it no longer inherits the camera transform, then add a DeviceTracking component to the root Camera. Specs Lenses require World tracking mode for walk-around content.

When should I stop debugging and ask the user for more information?

Stop when the incremental fallback (clean log, scene-graphql query, instrumented re-run) has not located the bug. Ask for a screen recording, scene state at failure, a minimal repro, the last working change, and target hardware.