snapchat-project-init

Configures Snapchat Lens camera tracking, preview camera, and input media before previewing.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Lens Studio template defaults are frequently wrong for a given Lens, producing projects that look correct in the editor but do nothing in preview. This Skill walks through the three settings that must match the Lens's actual intent before previewing. ## Core Features & Use Cases - Camera Tracking Selection: Maps Lens intent (face effect, surface anchor, world-locked, 360) to the correct DeviceTracking mode or no tracking at all. - Preview Configuration: Uses the PreviewPanelTool MCP tool to set deviceCategory, cameraView (Front/Back), and input media that actually exercises the Lens's trigger. - Intent Inference: Infers settings from the user's request, such as mapping "attach a hat to my head" to face tracking with the front camera. - Use Case: When building an open-mouth laser effect, the Skill sets the front camera and loads a preview video where the mouth opens, so the trigger can be verified. ## Quick Start Set up my Snapchat Lens project for a face effect that triggers when the user opens their mouth, and configure the preview accordingly.

Frequently Asked Questions about snapchat-project-init

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

FAQPage Schema
How do I set up camera tracking for a Snapchat Lens in Lens Studio?

Attach DeviceTracking to the camera only when content should stay fixed in the real world. Use Surface tracking for table or floor anchors, World for walk-around content, Rotation for 360 experiences, and no tracking for face effects.

How do I configure the preview camera in Lens Studio?

Use the PreviewPanelTool MCP tool's setConfig with deviceCategory set to mobile and cameraView set to Front for face effects or Back for world and surface Lenses. The getConfig command reports the current preview state.

Why does my Snapchat Lens work in the editor but not in preview?

Template defaults often mismatch the Lens's actual intent, such as wrong tracking mode or preview input that never triggers the behavior. Set input media that exercises the trigger, like a video with an opening mouth for mouth-triggered effects.

What preview input should I use for a hand-gesture Lens?

Set a Multimedia source via listSources and setConfig containing footage with hands in frame. The input media must exercise the Lens's trigger, otherwise you cannot verify the behavior fires during preview.

When should a Snapchat Lens use the front versus back camera?

Use the front camera for face and selfie effects, which is the common case. Use the back camera for world, surface, and rear-camera Lenses where content anchors to the physical environment.