CommunityImagegithub.com

antigravity-custom-theme

Use when the user wants to design, customize, install, update, or troubleshoot an Antigravity IDE or Manager visual theme from a wallpaper image, color palette, aesthetic mood, or preset.

What is antigravity-custom-theme?

antigravity-custom-theme is a Antigravity agent skill that use when the user wants to design, customize, install, update, or troubleshoot an Antigravity IDE or Manager visual theme from a wallpaper image, color palette, aesthetic mood, or preset.

Works with~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/giakiet22102006/antigravity-custom-theme-skill/tree/HEAD

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

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 — Compiles themes/themes.json + engine/core.js into gitignored dist/theme_payload.js (auto-downscales >2560px rasters to WebP when Pillow is installed).
  • daemon/theme_daemon.js — Cross-platform Node.js (>= 22) CDP daemon watching DevToolsActivePort and dist/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 — Exact themes.json schema, contrast rules, and Antigravity selector notes.

Workflow

  1. 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.
  2. Design cohesive tokens (Dark or Light Glass)
    • Read references/theme-schema.md for every themes.json key.
    • Extract dominant & accent colors from the image to populate primary, secondary, overlayRgb, bg, frameBg, sidebarBg, aiCardBg, headerBg, inputCardBg, and modalBg with crisp readable contrast.
    • For bright/daytime/pastel wallpapers, set "isLight": true with high-contrast dark ink (uiTextColor, pillTextColor) and light frosted aiCardBg/overlayRgb.
    • When the user wants matching chat avatars (or provides character/themed artwork), also craft or crop square userAvatar & agentAvatar assets (PNG/WebP or bespoke SVG emblems) and custom sticker/cornerSvg flourishes.
  3. Stage assets & edit themes/themes.json
    • Save wallpaper under themes/assets/<slug>.webp (or .png), optional SVG stickers/corners, and optional userAvatar / agentAvatar files under themes/assets/.
    • Add a new entry in themes/themes.json referencing "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.
  4. Compile & syntax-check payload
    • Run python scripts/build_payload.py (or python3 scripts/build_payload.py).
    • Run node --check dist/theme_payload.js to ensure zero syntax issues.
  5. Run / hot-reload daemon
    • Windows: powershell -ExecutionPolicy Bypass -File scripts/install-win.ps1
    • macOS / Linux: bash scripts/install-unix.sh (or --foreground for interactive testing)
    • If the daemon is already running, rebuilding dist/theme_payload.js triggers automatic hot-reload via fs.watch.
  6. Verify live via CDP
    • Run node scripts/verify_cdp.js while Antigravity is open.
    • Confirm themeActive: true, hasLiveBlurRule: false, valid .agy-shell background, and readable composer pills before reporting success.

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.js pre-bakes blurred canvas textures (syncPrebakedGlass) instead.
  • Data-Only Theme Authoring: Add themes in themes/themes.json + themes/assets/. Leave engine/core.js untouched 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 + evenodd clip-path behavior intact so embedded Chromium views stay sharp.
  • No Personal Data Leakage: Check modified files for absolute user paths or personal theme_config.json state before committing.

Related Skills