Antigravity Custom Theme Skill
Creates and applies custom glassmorphic themes (wallpapers, cohesive palettes, custom composer ornaments, pre-baked glass panels, and split-browser-safe overlays) to Antigravity without modifying application binaries.
Repository Layout
themes/themes.json— Theme presets (colors, wallpaper path, SVG ornaments, glass alpha/saturation defaults).themes/assets/— Raster wallpapers (.webp/.png/.jpg) and SVG stickers/corner flourishes.engine/core.js— Standalone DOM + CSS injection engine (Zero Live Blur, L-glass layout, split-browser hole cutout, composer pill contrast, live theme settings modal).scripts/build_payload.py— Compilesthemes/themes.json+engine/core.jsinto gitignoreddist/theme_payload.js(auto-downscales >2560px rasters to WebP when Pillow is installed).daemon/theme_daemon.js— Cross-platform Node.js (>= 22) CDP daemon watchingDevToolsActivePortanddist/theme_payload.js.scripts/install-win.ps1,scripts/install-unix.sh,scripts/uninstall.js,scripts/verify_cdp.js— OS setup, removal, and live CDP verification.references/theme-schema.md— Exactthemes.jsonschema, contrast rules, and Antigravity selector notes.
Workflow
- Gather aesthetic & inspect image
- Ask briefly for any missing intent only if ambiguous (mood: cozy warm, cyberpunk neon, anime cel, cosmic gold, minimalist pure-CSS gradient, etc.).
- If the user provides an image with an unwanted corner watermark/signature, clean/crop it cleanly before staging.
- Design cohesive tokens (Dark or Light Glass)
- Read
references/theme-schema.mdfor everythemes.jsonkey. - Extract dominant & accent colors from the image to populate
primary,secondary,overlayRgb,bg,frameBg,sidebarBg,aiCardBg,headerBg,inputCardBg, andmodalBgwith crisp readable contrast. - For bright/daytime/pastel wallpapers, set
"isLight": truewith high-contrast dark ink (uiTextColor,pillTextColor) and light frostedaiCardBg/overlayRgb. - When the user wants matching chat avatars (or provides character/themed artwork), also craft or crop square
userAvatar&agentAvatarassets (PNG/WebP or bespoke SVG emblems) and customsticker/cornerSvgflourishes.
- Read
- Stage assets & edit
themes/themes.json- Save wallpaper under
themes/assets/<slug>.webp(or.png), optional SVG stickers/corners, and optionaluserAvatar/agentAvatarfiles underthemes/assets/. - Add a new entry in
themes/themes.jsonreferencing"assets/<filename>"(keep existing sample presets unless asked to remove them). - Never hardcode personal OS paths (
C:\Users\...,/Users/...,/home/...) in JSON, JS, or scripts.
- Save wallpaper under
- Compile & syntax-check payload
- Run
python scripts/build_payload.py(orpython3 scripts/build_payload.py). - Run
node --check dist/theme_payload.jsto ensure zero syntax issues.
- Run
- Run / hot-reload daemon
- Windows:
powershell -ExecutionPolicy Bypass -File scripts/install-win.ps1 - macOS / Linux:
bash scripts/install-unix.sh(or--foregroundfor interactive testing) - If the daemon is already running, rebuilding
dist/theme_payload.jstriggers automatic hot-reload viafs.watch.
- Windows:
- Verify live via CDP
- Run
node scripts/verify_cdp.jswhile Antigravity is open. - Confirm
themeActive: true,hasLiveBlurRule: false, valid.agy-shellbackground, and readable composer pills before reporting success.
- Run
Non-Negotiable Architecture Rules
- Zero Live Blur: Never add CSS
backdrop-filter: blur(...)to.agy-shell,.agy-chat-frame, or scrollable panes — Electron scrolling drops frames badly under live blur.engine/core.jspre-bakes blurred canvas textures (syncPrebakedGlass) instead. - Data-Only Theme Authoring: Add themes in
themes/themes.json+themes/assets/. Leaveengine/core.jsuntouched unless Antigravity changes its upstream DOM selectors. - Split Browser Cutout: Never paint opaque overlays over the right-side browser pane; keep
data-has-browser-hole+evenoddclip-pathbehavior intact so embedded Chromium views stay sharp. - No Personal Data Leakage: Check modified files for absolute user paths or personal
theme_config.jsonstate before committing.