lens-studio-router

Detects Lens Studio projects, gates MCP readiness, and routes builds to Specs or Snapchat workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Starting a Lens Studio, Specs, or Snapchat Lens build requires the right project open, a compatible Lens Studio version, a reachable MCP server, and a signed-in user — and then the request must reach the correct platform workflow. This Skill performs that environment detection, readiness gating, and platform routing automatically so builds never start against a broken or ambiguous setup. ## Core Features & Use Cases - Project Detection and Readiness Gate: Finds the .esproj project at the working directory, verifies Lens Studio 5.22+ is installed and running, probes the MCP server, and enforces a mandatory sign-in check before any build work begins. - Platform Routing: Resolves Specs vs Snapchat from the user's request, the project's targetPlatform, or a blocking question — never guessing — then hands off to the specs-experience-builder subagent or the core Snapchat Lens Studio skills. - Preflight Mode and Blocked Payloads: Supports a preflight_only mode for readiness checks without triggering a build, and emits structured blocked payloads with specific reasons (e.g. mcp_plugin_off, not_signed_in, wrong_project_open) plus suggested next steps when anything fails. - Use Case: You ask your coding agent to "build a Specs game" from a Lens Studio project directory. The router confirms the project is open, MCP is live, and you are signed in, then spawns the Specs builder with a complete handoff payload — or tells you exactly what to fix first. ## Quick Start Ask your agent to build a Specs or Snapchat Lens experience from inside your Lens Studio project directory and let the router prepare the environment and route the request.

Frequently Asked Questions about lens-studio-router

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

FAQPage Schema
How do I start building a Specs or Snapchat Lens with an AI agent?

Open your Lens Studio project, restart your coding-assistant session so it registers the Lens Studio MCP server, then describe what you want to build. The router detects the .esproj project, gates readiness, resolves the platform, and routes to the Specs builder or Snapchat skills.

What Lens Studio version is required for the MCP workflow?

Lens Studio 5.22 or higher is required. The router probes installed app bundles, partitions candidates by version using version-aware comparison, and blocks with lens_studio_wrong_version when only older or unreadable builds are found.

Why does the router say no project is present in my directory?

The router requires a .esproj file or both Assets/ and Packages/ directories at the current working directory, and it never scaffolds a project. Open the project in Lens Studio, restart the agent session so MCP registers, and re-invoke from that directory.

Does the router decide between Specs and Snapchat automatically?

It follows strict precedence: a platform you stated wins, then the project's .esproj targetPlatform field, and only if both are silent does it ask you to choose. It never guesses the platform from genre or phrasing.

Why am I blocked with not_signed_in even though MCP is working?

MCP connectivity does not imply sign-in. The router checks Editor.IAuthorization isAuthorized exactly once and only proceeds on an explicit true; sign in from the Lens Studio profile menu, confirm when asked, and it re-checks once.

Can I run only the environment readiness check without a build?

Yes, invoke with mode set to preflight_only. It runs Detect and Gate only, then prints a preflight payload with project path, Lens Studio version, MCP status, and authorization state without resolving a platform or spawning any builder.