A WebXR skimboarding world for Meta Quest 3 with 14 Claude-driven villagers. Play: skimworld.vercel.app
A skimboarding world for Meta Quest 3 (WebXR — runs in the Quest Browser, no store install), also playable on desktop.
Everywhere is covered in a thin film of water. You get around by skimboarding: run, throw your board ahead, hop onto it as it slides, and plane across the mirror. Five stilt villages with their own vibes, waves, wind, waterfalls, thermals, giant skimboats — and 14 villagers whose minds run on Claude.

| | |
|---|---|
|
|
|
|
|
|
Play it: https://skimworld.vercel.app (open it in the Quest Browser and press Enter VR).
npm install npm run dev # game on :5173, villager server on :8787
Open http://localhost:5173 on desktop.
Live villager minds: export ANTHROPIC_API_KEY (or run ant auth login) before npm run dev. If the key is in ~/.zshrc, launch from an interactive shell (zsh -ic 'npm run dev'); .claude/launch.json already does this. Without credentials the villagers fall back to scripted lines and the world still works. Model defaults to claude-opus-5-5; override with NPC_MODEL / LIFE_MODEL.
On Quest 3 (WebXR needs a secure context):
adb reverse tcp:5173 tcp:5173, then open http://localhost:5173 in the Quest Browser, ornpm run dev:https, open https://<your-mac-lan-ip>:5173, accept the self-signed cert.Press Enter VR.
The live site is the Vercel project skimworld on the miles-wiesenthals-projects (Pro) team.
dist/. Every /api/* request is rewritten to one function, api/index.ts, which runs the same handler as the local server (server/api.ts).skimworld-memory: each request loads it and writes it back. Locally it stays in server/data/memory.json.ANTHROPIC_API_KEY is a sensitive production env var. Spend guards: SKIM_DAILY_CALLS (default 400 Claude calls per UTC day, then scripted lines) and SKIM_TICK_MINUTES (default 10, the minimum real time between life ticks).x-skim-key header matching SKIM_ACCESS_KEY (a sensitive production env var). Everyone else gets the full game with scripted villagers and the browser's own voice, and their chats aren't saved into shared villager memory. To unlock a browser or headset, open the game once as https://skimworld.vercel.app/#key=<SKIM_ACCESS_KEY>: the key is kept in that browser's local storage and removed from the address bar. If SKIM_ACCESS_KEY is unset on Vercel, everyone is locked; unset locally, everything is unlocked./api/world/reset is refused on Vercel unless the request carries the x-skim-admin header matching SKIM_ADMIN_TOKEN (not set, so reset is off).Deploy with:
vercel deploy --prod
The skimboard physics (src/game/skimmer.ts) is shared by you and every villager:
Zones: Brinehook's rolling waves (catch the faces), Saltglass's 14 m/s wind (get a sail at June's Sail Loft; trim it), Highfall's chutes and waterfalls (take the Mist Lift up, ride the chute down at 50+ km/h, or get a glide wing from Sora and ride the thermals), and Glowmarsh, where the water glows where you cut it.
Skimboats: The Long Glide and Wavecutter are giant skimboards running trade loops. Skim into one to hop aboard; run off the deck with your board for a boat drop.
| | Quest 3 | Desktop | |---|---|---| | Run | swing your arms (or left stick) | W | | Throw board / kick out / pick up | right trigger | E | | Hop on / ollie | A, or really hop | Space | | Pump / charge / absorb | really crouch | Shift (hold) | | Carve | lean your body (left stick X assists) | A / D | | Spin in the air | right stick X | ← → | | Sail up / trim | X / aim it with your left hand | F / Z X | | Glide wing | both grips or arms spread; raise or lower your hands to pitch | G, W/S pitch | | Talk | B, then point and trigger a reply (or Speak) | T, type | | Snap turn | right stick (on foot) | drag to orbit |
Desktop extras: 1–5 fast-travel, R respawn, [ ] shift time, M mute, H help.
14 people across five villages (shared/npcs.ts): Tomas the retired champion, Mari the board shaper and her daughter Pip, Felix of the Stilt Cup café, June the sailmaker and Ren the turbine engineer, Kip, Nalu and Dr. Ama in Brinehook, Sora and Hollis on Highfall, Vex at the Lumen Club, and the two skimboat captains Bao and Odette. Each has a personality, backstory, goals, a secret, relationships and a daily schedule. They physically ride, work on their decks, and captain their boats on that schedule.
server/brain.ts:
server/data/memory.json, including the world clock, so a new session resumes on the day the villagers last lived through.
shared/ world.ts (terrain, film, waves, wind, thermals), villages.ts, npcs.ts, noise.ts
src/game skimmer.ts (physics), game.ts (loop, VR rig, feedback), npcs.ts, boats.ts, input.ts
src/render ground.ts (film shader), sky.ts, villages.ts, models.ts, effects.ts
src/ui hud.ts, dialog.ts, panel.ts src/audio/audio.ts (procedural sound)
server/ index.ts, brain.ts (Claude), memory.ts
tests/ physics.test.ts
npm test runs the physics tests; npm run build builds the static game into dist/ (npm start serves it plus the villager server on one port).
MIT, see LICENSE.