Glasses App

What it does

When your agent uses it

• Debugging a host program + device-side Lua app pair
• Asked to display something on / read sensors from the glasses

Example prompts

• “/glasses-app”

Requirements

• Python 3

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

1. 1Parity: device-side Lua is triplicated across the three SDKs and must
2. 2Flutter assets: every .lua file the app uploads must be listed under
3. 3Errors on device: wrap the Lua app loop in pcall and print(err) —
4. 4Memory: the VM has ~30 KB free; collectgarbage('collect') after

What it can do on your machine

Read from SKILL.md and the folder at commit 2ec3f66. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • pip

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  Links to these hosts (documentation or services it may open):

  • docs.brilliant.xyz

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Glasses App loads about 1.2k tokens when it runs, and up to ~3.9k if it reads all its reference files. Until then it costs about 73 tokens; SKILL.md has 469 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~73

When it runs · the whole SKILL.md, loaded when a task matches

~1.2k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~3.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from brilliantlabsAR/brilliant_sdk at commit 2ec3f66, republished under its BSD-3-Clause licence (© brilliantlabsAR). 469 words, ~1,220 tokens.

name

glasses-app

description

Build an app for Brilliant Labs smart glasses (Halo or Frame) with this SDK, in Python, Flutter or WebBluetooth/TypeScript. Use when writing, extending or debugging a host program + device-side Lua app pair, or when asked to display something on / read sensors from the glasses.

connect()
upload_stdlua_libs(['data', <per-message-type libs>])   # e.g. 'plain_text', 'camera'
upload_frame_app('lua/<name>_frame_app.lua')            # your device-side app
attach_print_response_handler()                         # see device print()/errors
start_frame_app()                                       # runs it; blocks until it prints ready
send_message(code, msg.pack()) / attach Rx receivers    # the app conversation
stop_frame_app(); disconnect()

halo-emulator ./my_app_lua_dir/    # REPL + display window

© brilliantlabsAR, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (references) in .claude/skills/glasses-app of brilliantlabsAR/brilliant_sdk.

• SKILL.md
• references/flutter-quickstart.md
• references/frame-api.md
• references/python-quickstart.md
• references/webbluetooth-quickstart.md

Open the folder on GitHubat commit 2ec3f66