# How to Resolve Windows-Specific Installation Issues for Antigravity Awesome Skills > Resolve Windows installation issues for Antigravity Awesome Skills with dedicated recovery guides and batch scripts. Get your skills running smoothly on Windows. - Repository: [sickn33/antigravity-awesome-skills](https://github.com/sickn33/antigravity-awesome-skills) - Tags: how-to-guide - Published: 2026-03-18 --- **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`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/README.md) (lines 326-336), the standard installation uses either `npx` or direct `git clone` without additional flags: ```bat :: 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`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/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`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/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: ```bat :: 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: ```bat scripts\activate-skills.bat --clear "Web Wizard" ``` To append additional bundles without clearing existing ones: ```bat 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`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/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`](https://github.com/sickn33/antigravity-awesome-skills/blob/main/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.