How to Resolve Windows-Specific Installation Issues for Antigravity Awesome Skills

Antigravity Awesome Skills now installs on Windows without extra OS configuration, but the repository provides dedicated recovery guides and batch scripts for truncation crashes and selective skill activation.

The sickn33/antigravity-awesome-skills repository includes comprehensive resources for handling Windows-specific installation issues, from standard setup to advanced recovery scenarios. Whether you are deploying the tool on a fresh Windows machine or troubleshooting a crash loop, the project maintains Windows-native utilities that eliminate dependency on Unix-only tools.

Standard Windows Installation (No Workarounds Needed)

As of PR #299, Antigravity Awesome Skills supports Windows out-of-the-box installation. The legacy requirement to enable core.symlinks=true or Windows Developer Mode has been removed from the installation flow.

According to the source code in README.md (lines 326-336), the standard installation uses either npx or direct git clone without additional flags:

:: Method 1: Clone directly into the Antigravity skills folder
git clone https://github.com/sickn33/antigravity-awesome-skills.git %USERPROFILE%\.gemini\antigravity\.agent\skills

:: Method 2: Use the npm installer (recommended)
npx antigravity-awesome-skills

Both methods are confirmed to work under PowerShell and cmd.exe, with the Node-based CLI in bin/install.js handling line-ending and environment-variable quirks automatically.

Handling the Truncation Crash Loop on Windows

If Antigravity crashes with a "TrajectoryChatConverter could not convert a single message before hitting truncation" error, the repository provides a dedicated recovery path documented in docs/users/windows-truncation-recovery.md.

Manual Recovery Steps

The recovery guide instructs you to clear persisted browser databases and temporary files that may have corrupted during the crash. The process targets three specific Windows locations:

• %USERPROFILE%\.gemini\antigravity-browser-profile\Default (Local Storage, Session Storage, IndexedDB)
• %AppData%\antigravity (application configuration)
• %TEMP% (temporary runtime files)

You can execute the official batch helper included in the documentation:

:: Run the recovery batch helper from the repository root
call docs\users\windows-truncation-recovery.bat

The helper automates backup-then-delete operations, prompting for confirmation before removing the corrupted data and forcing a fresh start on next launch.

Selective Skill Activation for Windows Performance

For Windows environments with limited resources, the full Antigravity skill catalog may overload the runtime. The repository provides scripts/activate-skills.bat, a Windows-native batch utility that manages selective skill activation without requiring Unix tools like rsync or ln.

Using the Activation Batch Script

The script performs three core operations:

1. Syncs a library copy from the repository (%REPO_SKILLS% → %LIBRARY_DIR%)
2. Archives the existing skill set (timestamped folder) when using the --clear flag
3. Restores only requested bundles from the library into the active %SKILLS_DIR%

To clear current skills and activate only the "Web Wizard" bundle:

scripts\activate-skills.bat --clear "Web Wizard"

To append additional bundles without clearing existing ones:

scripts\activate-skills.bat "Integration & APIs" "Security Engineer"

The script relies entirely on Windows native tools (robocopy, python if available) and handles path translation between forward slashes (used internally) and backslashes required for Windows archive operations.

Summary

• Standard installation on Windows requires no special configuration since PR #299 removed the core.symlinks=true requirement.
• Truncation crash recovery is handled via docs/users/windows-truncation-recovery.md, which provides steps to clear corrupted browser profiles and temp files.
• Selective skill activation uses scripts/activate-skills.bat to manage resource constraints by loading only necessary skill bundles.
• All Windows utilities in the repository avoid Unix-only dependencies, using robocopy and native batch scripting instead.

Frequently Asked Questions

Do I need to enable Windows Developer Mode to install Antigravity Awesome Skills?

No. As of PR #299, the repository removed the legacy requirement for core.symlinks=true or Developer Mode. The standard installation via npx antigravity-awesome-skills or git clone works on standard Windows configurations without additional OS-level changes.

How do I fix the "TrajectoryChatConverter could not convert a single message before hitting truncation" error on Windows?

Follow the recovery guide in docs/users/windows-truncation-recovery.md. This involves deleting corrupted data from %USERPROFILE%\.gemini\antigravity-browser-profile\Default (specifically Local Storage, Session Storage, and IndexedDB), clearing %AppData%\antigravity, and removing temporary files from %TEMP%. The included batch helper automates this backup-and-cleanup process.

Can I run Antigravity Awesome Skills on Windows without installing all skills?

Yes. Use the scripts/activate-skills.bat utility to selectively load only the bundles you need. Run scripts\activate-skills.bat --clear "Bundle Name" to archive your current installation and activate only specific skills, or omit --clear to append bundles to your existing setup. This prevents resource overload on Windows systems with limited memory or storage.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}