gitwtfhub

wtf is spectacles-agent-skills?

ptpavlotkachenko/spectacles-agent-skills — explained in plain English

Analysis updated 2026-05-18

3Audience · developerComplexity · 3/5Setup · easy

TL;DR

Two markdown skill files for AI coding agents that teach them how to build Snap Spectacles Lens Studio projects so a later downgrade to the device's required older version goes smoothly.

Mindmap

mindmap
  root((repo))
    What it does
      Portable project design skill
      Migration troubleshooting skill
      Documents real error fixes
    Tech stack
      Lens Studio
      Markdown skills
      Snap Spectacles
    Use cases
      Plan for a downgrade
      Fix migration errors
      Brief coding agents
    Audience
      Spectacles Lens developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Architect a new Snap Spectacles Lens Studio project so it can be downgraded to an older editor version without rewriting code

REASON 2

Fix specific Lens Studio downgrade errors like corrupted graph headers or materials turning white after cloning

REASON 3

Give an AI coding agent working knowledge of Spectacles specific development gotchas before starting a build

REASON 4

Cut a Lens Studio 5.22 to 5.15 migration from a full day of debugging down to about an hour

What's in the stack?

Lens StudioMarkdown

How it stacks up

ptpavlotkachenko/spectacles-agent-skills000madz000/payload-test-api-route-handler0marildo/imago
Stars333
LanguageTypeScriptPython
Setup difficultyeasyeasyeasy
Complexity3/52/52/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Just copying markdown files into an agent's skills folder, the real value comes from following the advice during Lens Studio development.

The README does not state a license.

Wtf does this do

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.

Yoink these prompts

Prompt 1
Load the spectacles-522-portable-design skill before we start building this Spectacles Lens
Prompt 2
I'm getting an Invalid graph header error migrating to Lens Studio 5.15, what does the migration skill say
Prompt 3
Explain why my cloned material turned white after downgrading to Lens Studio 5.15.4
Prompt 4
Help me rewrite this graph shader as a CPU MeshBuilder effect so it survives the downgrade

Frequently asked questions

wtf is spectacles-agent-skills?

Two markdown skill files for AI coding agents that teach them how to build Snap Spectacles Lens Studio projects so a later downgrade to the device's required older version goes smoothly.

What license does spectacles-agent-skills use?

The README does not state a license.

How hard is spectacles-agent-skills to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is spectacles-agent-skills for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.