ls-extensions

Lens Studio native packages: install from Asset Library, pack/unpack `.lsc`/`.lspkg`, bump versions, attach README/`.d.ts`, author setup scripts. APIs `NativePackageDescriptor`, `exportScript`/`exportPackage`, `unpack`, `instantiate`, `SetupScript`.

Migrate a Lens project from Spectacles (2024) to SPECS 27 APIs: WebView, Remote Media, Camera, Depth, Motion Controller, SyncKit, VoiceML→ASR, RemoteReferenceAsset→Supabase. Use when migrating or porting a Lens to SPECS 27, or about deprecated APIs.

Update outdated packages/libraries (SIK, UIKit, SSK, SyncKit) in a Lens Studio project via the Editor API. Use for 'update my packages', 'upgrade SIK', 'update dependencies', 'pull latest SIK', or any package update ask. Requires Lens Studio MCP.

Generate a 3D mesh, model, or asset for a Lens — build, create, or make props, characters, scenery. Four peer backends chosen per asset: SPECS text-to-3D (static default — best texture fidelity, async minutes-long jobs), FAST3D (faster static AI props), code-authored MeshBuilder via the mesh-builder-scripting skill (articulated, animated, parametric TypeScript content), and Blender voxel (blocky aesthetic; the only source of rigged GLBs). GLB backends return the file plus AABB metadata so the caller can size colliders and place the mesh in the world.

Generate musical phrases, chord progressions, beats, jingles, and short pieces via local algorithmic synthesis. Sample-free, license-clean, fully offline. Scale-degree composition, pattern-based arrangement, frequency-separated mixing rules. Outputs 44.1 kHz stereo WAV to Assets/GeneratedSFX/.

Generate non-pitched sound effects (UI, impacts, sweeps, foley, ambient textures, retro 8-bit) via local algorithmic synthesis. Outputs 44.1 kHz WAV to Assets/GeneratedSFX/. For musical phrases or chord progressions use /build-music instead.

Camera configuration, 2D/screen-space rendering, RenderMeshVisual patterns, and visibility debugging for Lens Studio scene construction. Use when setting up cameras (orthographic/perspective), creating screen-space content (ScreenTransform, Image, Text), debugging invisible objects, or planning any scene involving rendering config.

ExecuteEditorCode contract and Editor API paradigms — runtime, access patterns, gotchas, references. Use before writing Editor API TS (`pluginSystem.findInterface`, `LensStudio:*`), grepping `editor.d.ts`, or routing to scene/asset-graphql.

Verifies a Lens Studio package is installed and installs it from the Asset Library if missing. Supports any package including SpectaclesUIKit and SpectaclesInteractionKit. When installing SpectaclesUIKit, also ensures SpectaclesInteractionKit is present first (UIKit depends on SIK). Use when a workflow depends on a specific Lens Studio package.

Search the Google Fonts catalog by style/mood and import/apply font assets to Text/Text3D components in a Lens Studio project. Use when adding typography to a UI panel, theming text to match a mood, or applying a specific font family by name.

Search curated Google Material Icons catalog to find the right icon for Specs UI, then import via IconSelector MCP tool. Use when building UI that needs icons.

Lens Studio TypeScript scripting — component lifecycle, decorators, touch input, screen-to-world conversion, runtime object creation, material cloning, scene queries, and timers. Use when writing any Lens Studio TypeScript script, handling tap/touch events, converting screen to world coordinates, creating objects at runtime, modifying material colors, or debugging null-reference errors in Lens scripts.

Orchestrator for Lens Studio runtime bugs. Routes symptoms (invisible, glitchy, pink material, handler not firing, asset not ready, physics flying off, glued-to-head, layout off) to the specialist that owns the fix.

Debug a running JS Lens. Use when you need to evaluate expressions, set breakpoints, pause/resume execution, or inspect runtime state in a Lens Studio preview or on a Specs device.

Lens Studio log format, severity prefixes, and how to interpret RunAndCollectLogsTool's inline result fields. Use when analyzing logs, debugging compilation failures, or reading preview runtime output.

Plugin-specific field notes for Lens Studio work — scene/asset tool selection (VirtualScene-first), the domain-skill index, Editor API delegation specifics, and scene-prep slash commands. Loaded by /lens-studio-router.

Front door for any Lens Studio / Specs / Spectacles / Snapchat Lens task — invoke PROACTIVELY at the start of such a conversation, before the user names a skill. Triggers: Specs, Spectacles, AR glasses, Snap Lens, Snapchat lens/camera, Snap camera, Snap mini app, Lens Studio, .esproj, SIK, UI Kit, VirtualScene; asks like 'build/make a specs|spectacles|snapchat <game or app>', 'make a Snap Lens that...', 'prototype an AR experience', 'build a 3D game' in an LS project. ('specs'/'Spectacles' = Snap's AR glasses, not test specs/RSpec; 'snapchat' = a Lens in the camera, not a 3rd-party API.) Gates LS 5.22+ / project / MCP readiness (never scaffolds; if cwd isn't an LS project, asks you to open it and restart the session so MCP is picked up), uses the platform you named (asks Specs vs Snapchat only if you didn't), then routes to the platform workflow.

Material creation, configuration, and assignment patterns for Lens Studio scene construction. Use this skill whenever creating materials, setting colors or PBR properties, assigning materials to objects, or debugging material-related rendering issues. Covers the critical distinction between Editor/GraphQL API and Runtime Lens API material access — using the wrong API is a common source of silent failures.

Runtime MeshBuilder API reference for Lens Studio — construct or mutate meshes from TypeScript (primitive helpers, lathe, extrude, tube, topology examples, dynamic vertex updates, skinned meshes, vertex colors). Use when writing a script that builds or animates geometry at runtime. For author-time static GLB generation (SPECS Text-to-3D / FAST3D / Blender voxel), use `/build-mesh` instead.

Analyzes Perfetto (.pftrace) traces for Lens Studio—quick JSON summary first, then optional deep SQL via a persistent trace server. Use when the user mentions .pftrace, Perfetto, Mobile Lens Profiler, Spectacles Monitor traces, frame drops, jank, LAT, or trace performance analysis.

Build or debug Lens Studio physics — gravity, collisions, joints, raycast input, trigger zones, force-driven motion, and physics-driven AR (objects colliding with face/hand/world mesh). Use when wiring `BodyComponent`/`ColliderComponent`/`ConstraintComponent`/`WorldComponent`, building ragdolls, vehicles, breakables, or draggable props, debugging tunneling/constraints, or using `Physics.ForceMode`/`createGlobalProbe`/`addPointConstraint`/`WorldSettingsAsset`/`Matter`/`Filter`. Fires on `.esproj` with `Physics.*` or code like `body.addForce`/`probe.rayCast`. SKIP for other engines (Unity, Unreal, three.js, matter.js, Cannon, Rapier, Godot), non-physics LS work (visual-only face mesh, materials, TouchEvent with no body), and Hair/Cloth sim.

Use when inspecting the live Lens Studio preview — querying scene state, discovering objects by component or property, reading transforms / bounds / component values, exploring the scene hierarchy, or capturing orthographic renders. Universal across Specs and Snapchat Lenses. For driving the preview with hand actions (Pinch / Hover / Drag / etc.), use the specs-preview-interaction skill instead.

Reset the Lens Studio preview to a clean state before scene generation. Captures a baseline log timestamp. Use before any scene generation task or when starting fresh.

Load when constructing or modifying a scene in Lens Studio. Teaches the canonical preset-first workflow (read → presets → re-read → apply → save). Indexes the domain skills (cameras, materials, shaders, VFX, physics).

Create or edit custom shaders and shader graphs — `.graphShader` YAML, GLSL code nodes, and library subgraphs.

Snapchat (in-camera Lens) project setup — camera tracking mode, preview camera (front/back) and input via PreviewPanelTool, and project target, each inferred from the Lens's intent. Use when setting up or sanity-checking a Snapchat Lens before previewing.

Integrate AI APIs (Gemini Live, OpenAI Realtime, DALL-E, Snap3D) using the Remote Service Gateway (RSG) package in Specs. Load when implementing AI chat, voice, vision, image generation, or function calling features.

Use the ASR Module for real-time speech-to-text on Specs. Best for dictation, transcription, and chat input (voice → LLM). Supports 40+ languages and mixed input. Not recommended for voice commands or keyword spotting.

AudioComponent on Specs — playback modes (LowPower/LowLatency), Mix-to-Snap, mic input profiles (Voice/Analysis, Echo Cancellation, Bystander Speech Rejection). Load for audio playback, ambient sound, button SFX, or mic / AsrModule use.

Build Specs UI in Lens Studio using SpectaclesUIKit (FlexLayout / GridLayout / Frame / BackPlate / Button / Switch / Slider / TextInputField). Use when the user wants to create a UI panel, status HUD, settings screen, media browser, dock, storefront, or any 2D-ish UI rendered in world space. Generates a TypeScript BaseScriptComponent under Assets/Scripts/ and wires it into the scene.

Access Specs camera frames via CameraModule — live stream, still capture, intrinsics, 3D↔2D project/unproject, crop and composite patterns. Camera + internet is publishable via Transparent Permission. Load for CV, AR overlays, ML/AI.

Static ExecuteEditorCode snippets for simultaneous Lens Studio Preview performance traces. Use when recording .pftrace files via preview.profiling.startTrace without helper scripts.

Anchor AR content to a real-world place on Specs using Custom Locations + LocatedAtComponent (onFound). Load for location-locked or site-specific AR, scanning-based placement, hiding the scan mesh, location groups, or Connected-Lens placement.

Specs layer on `ls-clad:lens-debug`. Load alongside it for Specs-only bugs: SIK, RSG, SyncKit, SnapML, VIO/SLAM tracking, on-device perf tooling, Specs perf rules, world-space UI render order / z-fighting, feature compatibility.

Access real-time depth frames on Specs via DepthModule — per-pixel depth, back-projection to world space, camera intrinsics, and a depth+color snapshot cache for AI grounding. Load for depth AR placement, occlusion, or spatial queries.

All Specs hand-interaction guidance — SIK + GestureModule. Load for ANY hand interaction — buttons, hover, tap, swipe, throw, spring-returning grabs, pinch-pull, palm-tap menus, phone-controller switching, inventing a new gesture, or debugging 'my SIK event listener isn't firing'. Includes the init-order rule — SIK / `HandInputData` / `GestureModule` subscriptions must bind inside `OnStartEvent`, not `onAwake`.

Make HTTP/HTTPS requests, download remote media (images, video, audio, glTF), and check internet availability in Specs using the InternetModule and Fetch API. Load when implementing network requests, REST API calls, or remote asset loading.

Show an AR keyboard for text input in Specs using the TextInputSystem. Supports text, URL, numpad, and phone keyboard types. Load when implementing text input fields, search boxes, message entry, or any user text input.

Verifies the LEAF testing framework is installed in a Lens Studio project and installs it if missing. LEAF ships as a single Leaf package in the Asset Library; matches the SIK version on install. Use before writing or running LEAF tests.

Run LEAF scenarios directly in the Lens Studio Preview panel — opens the LeafPlugin panel, lists scenarios, and runs them via the Lens Studio MCP. The fastest iteration loop during development.