lens-studio-field-notes

Provides canonical rules and tool-selection guidance for Lens Studio MCP scene construction workflows.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Lens Studio agent work fails silently when tools are misused: raw HTTP workarounds bypass MCP tools, wrong-phase surfaces cause no-ops, and mixed-surface patching leaves orphaned scene state. This Skill centralizes the hard rules, cross-runtime orchestration patterns, and verification recipes that prevent those failures. ## Core Features & Use Cases - Hard Rules for MCP Usage: Enforces VirtualScene-first scene writes, bare tool naming across Claude Code, Codex, and Cursor runtimes, and correct unit/coordinate conventions (centimeters, right-handed, degrees vs radians). - See-and-Fix Verification Loop: Defines a canonical recipe using RecompileTypeScriptTool, RunAndCollectLogsTool, and CaptureRuntimeViewTool to visually validate builds, including a blind-spot checklist for animation, heavy scenes, and silent failures. - Editor API Delegation Guidance: Specifies when to load the editor-api skill inline versus delegating to the editor-api-specialist subagent, with rules for writing actionable delegation instructions. - Use Case: While building a Spectacles Lens, an agent consults these field notes to choose VirtualScene over scene-graphql mutations, run the platform init skill before previewing, and verify the result with a two-timestamp capture loop. ## Quick Start Ask the agent to load the lens-studio-field-notes skill before starting any Lens Studio scene construction or debugging task.

Frequently Asked Questions about lens-studio-field-notes

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

FAQPage Schema
How do I choose between VirtualScene and scene-graphql in Lens Studio?

Use VirtualScene as the default surface for all scene writes, since one apply call replaces dozens of GraphQL mutations. Reserve scene-graphql and asset-graphql for discovery and introspection only, such as presets, schema queries, and asset library searches.

How do I verify a Lens Studio scene build works correctly?

Run the see-and-fix loop: recompile TypeScript, collect runtime logs for an error baseline, capture the running preview, and visually judge the capture against intent. For animated content, capture at two or more timestamps and repeat until the capture matches the goal.

Why does my Lens Studio MCP tool call fail with InputValidationError?

On Claude Code, MCP tools are deferred, so an InputValidationError usually means the tool schema is not loaded yet. Run ToolSearch with a select query for the tool once to load its schema, then retry the call rather than falling back to HTTP workarounds.

When should I delegate Editor API work to a subagent?

Delegate to the editor-api-specialist subagent when a task needs two or more ExecuteEditorCode calls, several editor.d.ts lookups, complex scene traversals, or bulk mutations sharing execution context. Give the subagent specific object names, IDs, property values, and operation order.

Can I use curl or Bash scripts to work around Lens Studio MCP tools?

No. Raw HTTP calls and Bash workarounds are prohibited because hand-placed assets are invisible to Lens Studio until imported through the proper tool. Treat tool failures as naming or schema-loading issues and resolve them through the MCP tool surface.