ptpavlotkachenko/spectacles-agent-skills

Spectacles Agent Skills is a small collection of ready made instructions for AI coding agents like Claude Code, Cursor, or Codex, aimed at people building apps for Snap's Spectacles smart glasses inside Lens Studio. The author develops in the newer Lens Studio 5.22, which supports AI agent tools and an editor programming interface, then downgrades the finished project to the older Lens Studio 5.15.4 that the physical Spectacles device actually needs for testing. Their first attempt at that downgrade took a full day of fixing problems, a later project, built with these lessons already baked in, took about an hour with no code changes needed at all. The repository packages that experience into two separate skills. The first, meant to be given to an agent before starting a new project, teaches it to build the project in a way that keeps a future downgrade simple: keep the visual editor scene to a single object and build everything else through code while the app is running, avoid a certain kind of visual shader that fails silently after conversion, set material properties on cloned objects in code rather than relying on values that reset in the older version, and stick to APIs and file reference styles that both versions of Lens Studio support. The second skill is a troubleshooting guide for the actual migration, listing specific error messages the author has hit, such as repeated compression warnings, an empty pass list error, a corrupted graph header, an import loop, materials turning white after being cloned, and a newer project file corrupting an older one, each paired with its known fix. Installing the skills for Claude Code means cloning the repository and copying its skills folder into the local Claude skills directory, after which Claude picks the right skill automatically based on what you are working on, or you can call it by name directly. For other agents, the plain markdown files can simply be pasted into their own rules or context. The author reports both skills came from two real hardware projects that went through the full version cycle.