From cfb8af32864f692ad977f5f6c2b110da7fc84103 Mon Sep 17 00:00:00 2001 From: sck_0 Date: Thu, 12 Mar 2026 12:38:35 +0100 Subject: [PATCH] chore: release v7.6.0 --- CHANGELOG.md | 31 +++++ README.md | 31 ++++- docs/integrations/jetski-cortex.md | 20 +++- docs/users/faq.md | 16 +++ docs/users/getting-started.md | 3 + docs/users/windows-truncation-recovery.md | 132 ++++++++++++++++++++++ package.json | 4 +- skills/metasploit-framework/SKILL.md | 25 ++-- skills_index.json | 2 +- walkthrough.md | 15 ++- 10 files changed, 260 insertions(+), 19 deletions(-) create mode 100644 docs/users/windows-truncation-recovery.md diff --git a/CHANGELOG.md b/CHANGELOG.md index 79007145..2cf42cbe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -8,6 +8,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 --- ## [Unreleased] + +## [7.6.0] - 2026-03-12 - "Maintenance Sweep" + +> **Merged community PRs, documented Windows truncation recovery, and hardened Metasploit setup guidance** + +This release finishes a focused maintenance sweep across open pull requests and issues. It merges four community updates, ships the Jetski/Gemini overflow and path-safety documentation from the context overflow fix, adds a Windows recovery guide for truncation crash loops, and removes the non-deterministic Metasploit installer flow from the security skill. + +## New Skills + +- **acceptance-orchestrator** β€” acceptance-driven execution orchestration (PR #277) +- **closed-loop-delivery** β€” delivery workflow with feedback loops (PR #277) +- **create-issue-gate** β€” issue creation quality gate (PR #277) +- **interview-coach** β€” interview preparation and coaching (PR #272) + +## Improvements + +- **PR maintenance**: Merged PRs #277, #272, #275, #278, and #271 using GitHub squash merge so all contributors receive merge credit. +- **Jetski/Gemini loader docs**: Documented `overflowBehavior` handling and `skillsRoot`-confined path validation in the reference loader and integration guide (PR #271). +- **Windows recovery docs**: Added `docs/users/windows-truncation-recovery.md` and linked it from the main user docs for truncation/context crash loops on Windows. +- **Metasploit safety**: Replaced the remote installer pattern in `skills/metasploit-framework/SKILL.md` with an explicit "Metasploit must already be installed" prerequisite, and marked the skill as `risk: offensive` with the required warning. +- **Repo sync**: Refreshed README metadata, generated registry files, and contributor acknowledgements before release. + +## Credits + +- **[@qcwssss](https://github.com/qcwssss)** for `acceptance-orchestrator`, `closed-loop-delivery`, and `create-issue-gate` (PR #277) +- **[@dbhat93](https://github.com/dbhat93)** for `interview-coach` (PR #272) +- **[@rafsilva85](https://github.com/rafsilva85)** for the credit source addition (PR #275) +- **[@iftikharg786](https://github.com/iftikharg786)** for the star-history update branch that was refreshed and merged as PR #278 +- **[@DiggaX](https://github.com/DiggaX)** for the Windows recovery workflow shared in issue #274 +- **[@copilot-swe-agent](https://github.com/apps/copilot-swe-agent)** for the Jetski/Gemini overflow loader changes in PR #271 + ## [7.5.0] - 2026-03-11 - "Socratic Governance" > **Introducing Truth Engines, Local Inference optimizations, and Advanced Output Formatting** diff --git a/README.md b/README.md index e2466b23..8ea69c0d 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ - + # 🌌 Antigravity Awesome Skills: 1,250+ Agentic Skills for Claude Code, Gemini CLI, Cursor, Copilot & More > **The Ultimate Collection of 1,250+ Universal Agentic Skills for AI Coding Assistants β€” Claude Code, Gemini CLI, Codex CLI, Antigravity IDE, GitHub Copilot, Cursor, OpenCode, AdaL** @@ -299,6 +299,30 @@ Counts change as new skills are added. For the current full registry, see [CATAL | [`docs/users/faq.md`](docs/users/faq.md) | [`docs/contributors/quality-bar.md`](docs/contributors/quality-bar.md) | [`docs/maintainers/ci-drift-fix.md`](docs/maintainers/ci-drift-fix.md) | | [`docs/users/visual-guide.md`](docs/users/visual-guide.md) | [`docs/contributors/examples.md`](docs/contributors/examples.md) | [`docs/maintainers/skills-update-guide.md`](docs/maintainers/skills-update-guide.md) Β· [`.github/MAINTENANCE.md`](.github/MAINTENANCE.md) | +## Troubleshooting + +### Windows symlink problems + +If Windows does not preserve the official skill symlinks correctly, clone with: + +```bash +git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-skills.git .agent/skills +``` + +Or enable Developer Mode in Windows Settings before cloning. + +### Windows truncation or context crash loop + +If Antigravity or a Jetski/Cortex-based host keeps reopening into a truncation error, use the dedicated recovery guide: + +- [`docs/users/windows-truncation-recovery.md`](docs/users/windows-truncation-recovery.md) + +That guide includes: + +- backup paths before cleanup +- the storage folders that usually need to be cleared +- an optional batch helper adapted from [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274) + ## Web App The web app is the fastest way to navigate a large repository like this. @@ -419,6 +443,11 @@ We officially thank the following contributors for their help in making this rep - [@Enreign](https://github.com/Enreign) - [@kennyzheng-builds](https://github.com/kennyzheng-builds) - [@sickn33](https://github.com/sickn33) +- [@qcwssss](https://github.com/qcwssss) +- [@dbhat93](https://github.com/dbhat93) +- [@rafsilva85](https://github.com/rafsilva85) +- [@iftikharg786](https://github.com/iftikharg786) +- [@copilot-swe-agent](https://github.com/apps/copilot-swe-agent) - [@munir-abbasi](https://github.com/munir-abbasi) - [@ssumanbiswas](https://github.com/ssumanbiswas) - [@zinzied](https://github.com/zinzied) diff --git a/docs/integrations/jetski-cortex.md b/docs/integrations/jetski-cortex.md index c8d4c49a..31993aea 100644 --- a/docs/integrations/jetski-cortex.md +++ b/docs/integrations/jetski-cortex.md @@ -242,9 +242,27 @@ Per ulteriore controllo: - spostate le skill non necessarie in `skills/.disabled/` per escluderle in certi ambienti; - usate i **bundle** descritti in [`docs/users/bundles.md`](../users/bundles.md) per caricare solo gruppi tematici. +## 8. Recovery su Windows se siete gia in crash loop + +Se l’host continua a riaprire la stessa trajectory corrotta dopo un errore di truncation: + +- rimuovete la skill o il pacchetto problematico; +- cancellate Local Storage / Session Storage / IndexedDB usati da Antigravity; +- svuotate `%TEMP%`; +- riavviate con un loader lazy e limiti espliciti. + +Guida completa: + +- [`docs/users/windows-truncation-recovery.md`](../users/windows-truncation-recovery.md) + +Per evitare che il problema si ripresenti: + +- mantenete `overflowBehavior: "error"` quando preferite un fallimento esplicito; +- continuate a validare che i path risolti restino dentro `skillsRoot`. + --- -## 8. Riepilogo +## 9. Riepilogo - Non concatenate mai tutte le `SKILL.md` in un singolo prompt. - Usate `data/skills_index.json` come manifest leggero. diff --git a/docs/users/faq.md b/docs/users/faq.md index 8ebeb4e9..c9ca985a 100644 --- a/docs/users/faq.md +++ b/docs/users/faq.md @@ -116,6 +116,22 @@ git clone -c core.symlinks=true https://github.com/sickn33/antigravity-awesome-s Or enable "Developer Mode" in Windows Settings. +### I hit a truncation or context crash loop on Windows. How do I recover? + +If Antigravity or a Jetski/Cortex-based host keeps reopening into: + +> `TrajectoryChatConverter: could not convert a single message before hitting truncation` + +use the dedicated Windows recovery guide: + +- [`windows-truncation-recovery.md`](windows-truncation-recovery.md) + +It includes: + +- the manual cleanup steps for broken Local Storage / Session Storage / IndexedDB state +- the default Antigravity Windows paths to back up first +- an optional batch script adapted from [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274) + ### How do I update skills? Navigate to your skills directory and pull the latest changes: diff --git a/docs/users/getting-started.md b/docs/users/getting-started.md index 363fe13a..e346a30b 100644 --- a/docs/users/getting-started.md +++ b/docs/users/getting-started.md @@ -130,6 +130,9 @@ A: You clone the whole repo once; your AI only _reads_ the skills you invoke (or **Q: Can I make my own skills?** A: Yes! Use the **@skill-creator** skill to build your own. +**Q: What if Antigravity on Windows gets stuck in a truncation crash loop?** +A: Follow the recovery steps in [windows-truncation-recovery.md](windows-truncation-recovery.md). It explains which Antigravity storage folders to back up and clear, and includes an optional batch helper adapted from [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274). + **Q: Is this free?** A: Yes, MIT License. Open Source forever. diff --git a/docs/users/windows-truncation-recovery.md b/docs/users/windows-truncation-recovery.md new file mode 100644 index 00000000..295b6deb --- /dev/null +++ b/docs/users/windows-truncation-recovery.md @@ -0,0 +1,132 @@ +# Windows Recovery for Truncation Crash Loops + +Use this guide if Antigravity or a Jetski/Cortex-based integration on Windows gets stuck in a restart loop with an error like: + +> `TrajectoryChatConverter: could not convert a single message before hitting truncation` + +This usually means a previous run stored a broken trajectory or tried to load too many skill instructions into one message. + +## When to use this guide + +- Antigravity crashes immediately after launch on Windows +- the app keeps resuming the same broken session +- a newly installed skill or bundle caused the failure +- you already removed the offending skill but the app still reopens into the same error + +## Safety first + +Before deleting anything, back up these folders if they exist: + +- `%USERPROFILE%\.gemini\antigravity-browser-profile\Default` +- `%AppData%\antigravity` +- `%USERPROFILE%\.gemini\antigravity` + +If you installed skills into a different location, also back up that custom directory. + +## Manual recovery steps + +1. Fully close Antigravity. +2. Remove the offending skill or package from your Antigravity skill install. + Default path: + + ```text + %USERPROFILE%\.gemini\antigravity\plugins\skills + ``` + +3. Delete the stored browser database folders if they exist: + + ```text + %USERPROFILE%\.gemini\antigravity-browser-profile\Default\Local Storage + %USERPROFILE%\.gemini\antigravity-browser-profile\Default\Session Storage + %USERPROFILE%\.gemini\antigravity-browser-profile\Default\IndexedDB + ``` + +4. Delete the Antigravity app storage folders if they exist: + + ```text + %AppData%\antigravity\Local Storage + %AppData%\antigravity\Session Storage + ``` + +5. Clear your Windows temp directory: + + ```text + %TEMP% + ``` + +6. Restart Antigravity. +7. Reinstall only the skills you actually need, or switch your integration to lazy loading with explicit limits. + +## Recommended prevention + +- Do not concatenate every `SKILL.md` into one system prompt. +- Use `data/skills_index.json` as a lightweight manifest. +- Load `SKILL.md` files only when a skill is actually requested. +- Set explicit limits for skills per turn. +- Prefer `overflowBehavior: "error"` in the reference Jetski/Gemini loader so the host fails clearly instead of silently overfilling the context window. + +See: + +- [`docs/integrations/jetski-cortex.md`](../integrations/jetski-cortex.md) +- [`examples/jetski-gemini-loader/README.md`](../../examples/jetski-gemini-loader/README.md) + +## Optional Windows batch helper + +The following script is adapted from the community recovery workflow shared by [@DiggaX](https://github.com/DiggaX) in [issue #274](https://github.com/sickn33/antigravity-awesome-skills/issues/274). Review it before running it. + +```bat +@echo off +setlocal enabledelayedexpansion +title Anti-Gravity_Recovery_Tool_Universal + +set "TIMESTAMP=%date:~6,4%-%date:~3,2%-%date:~0,2%_%time:~0,2%-%time:~3,2%" +set "TIMESTAMP=%TIMESTAMP: =0%" +set "BACKUP_DIR=%USERPROFILE%\Desktop\AG_Emergency_Backup_%TIMESTAMP%" + +set "PATH_BROWSER=%USERPROFILE%\.gemini\antigravity-browser-profile\Default" +set "PATH_APPCONFIG=%AppData%\antigravity" +set "PATH_MAIN=%USERPROFILE%\.gemini\antigravity" + +echo ============================================================ +echo ANTI-GRAVITY RECOVERY ^& REPAIR TOOL (UNIVERSAL) +echo ============================================================ +echo. +echo This tool targets the truncation crash loop on Windows. +echo [INFO] Backup location: %BACKUP_DIR% +echo. + +if not exist "%BACKUP_DIR%" mkdir "%BACKUP_DIR%" + +if exist "%PATH_BROWSER%" xcopy "%PATH_BROWSER%" "%BACKUP_DIR%\Browser_Profile" /E /I /Y /Q +if exist "%PATH_APPCONFIG%" xcopy "%PATH_APPCONFIG%" "%BACKUP_DIR%\App_Config" /E /I /Y /Q +if exist "%PATH_MAIN%" xcopy "%PATH_MAIN%" "%BACKUP_DIR%\Main_Skills" /E /I /Y /Q + +( +echo === ANTI-GRAVITY RESTORATION GUIDE === +echo. +echo Restore Browser_Profile to: %PATH_BROWSER% +echo Restore App_Config to: %PATH_APPCONFIG% +echo Restore Main_Skills to: %PATH_MAIN% +echo. +echo Close Antigravity before restoring. +) > "%BACKUP_DIR%\RECOVERY_INSTRUCTIONS.txt" + +set /p "repair=Start the repair now? [Y/N]: " + +if /i "%repair%"=="Y" ( + if exist "%PATH_BROWSER%\Local Storage" rd /s /q "%PATH_BROWSER%\Local Storage" + if exist "%PATH_BROWSER%\Session Storage" rd /s /q "%PATH_BROWSER%\Session Storage" + if exist "%PATH_BROWSER%\IndexedDB" rd /s /q "%PATH_BROWSER%\IndexedDB" + if exist "%PATH_APPCONFIG%\Local Storage" rd /s /q "%PATH_APPCONFIG%\Local Storage" + if exist "%PATH_APPCONFIG%\Session Storage" rd /s /q "%PATH_APPCONFIG%\Session Storage" + del /q /s %temp%\* >nul 2>&1 + for /d %%x in (%temp%\*) do @rd /s /q "%%x" >nul 2>&1 + echo [SUCCESS] Recovery cleanup completed. +) else ( + echo Recovery skipped. No files were deleted. +) + +echo. +echo Next step: remove the broken skill from %PATH_MAIN%\plugins\skills +pause +``` diff --git a/package.json b/package.json index 517b4767..2700e7c2 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "antigravity-awesome-skills", - "version": "7.5.0", - "description": "1,246+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.", + "version": "7.6.0", + "description": "1,250+ agentic skills for Claude Code, Gemini CLI, Cursor, Antigravity & more. Installer CLI.", "license": "MIT", "scripts": { "validate": "node tools/scripts/run-python.js tools/scripts/validate_skills.py", diff --git a/skills/metasploit-framework/SKILL.md b/skills/metasploit-framework/SKILL.md index 55d8a136..88175650 100644 --- a/skills/metasploit-framework/SKILL.md +++ b/skills/metasploit-framework/SKILL.md @@ -1,7 +1,7 @@ --- name: metasploit-framework description: "This skill should be used when the user asks to \"use Metasploit for penetration testing\", \"exploit vulnerabilities with msfconsole\", \"create payloads with msfvenom\", \"perform post-exp..." -risk: unknown +risk: offensive source: community author: zebbern date_added: "2026-02-27" @@ -9,6 +9,11 @@ date_added: "2026-02-27" # Metasploit Framework +> **⚠️ AUTHORIZED USE ONLY** +> This skill is for educational purposes or authorized security assessments only. +> You must have explicit, written permission from the system owner before using this tool. +> Misuse of this tool is illegal and strictly prohibited. + ## Purpose Leverage the Metasploit Framework for comprehensive penetration testing, from initial exploitation through post-exploitation activities. Metasploit provides a unified platform for vulnerability exploitation, payload generation, auxiliary scanning, and maintaining access to compromised systems during authorized security assessments. @@ -17,17 +22,15 @@ Leverage the Metasploit Framework for comprehensive penetration testing, from in ### Required Tools ```bash -# Metasploit comes pre-installed on Kali Linux -# For other systems: -curl https://raw.githubusercontent.com/rapid7/metasploit-omnibus/master/config/templates/metasploit-framework-wrappers/msfupdate.erb > msfinstall -chmod 755 msfinstall -./msfinstall - -# Start PostgreSQL for database support -sudo systemctl start postgresql -sudo msfdb init +# Metasploit must already be installed before using this skill. +# Kali Linux usually ships with it preinstalled. +msfconsole --version ``` +Installation varies by operating system and package source. Follow your platform's documented package-manager or vendor installation process before using this skill. Do not rely on an unpinned remote installer script from inside this skill. + +If you want database-backed features such as workspace tracking, initialize `msfdb` using the instructions for your local installation. This skill assumes Metasploit is already available and does not require `sudo`, `systemctl`, or other privileged host-level setup steps. + ### Required Knowledge - Network and system fundamentals - Understanding of vulnerabilities and exploits @@ -39,6 +42,8 @@ sudo msfdb init - Network access to target systems - Understanding of scope and rules of engagement +Before running exploit modules, ask the user to confirm the exact target host, scope, and authorization state. + ## Outputs and Deliverables 1. **Exploitation Evidence** - Screenshots and logs of successful compromises diff --git a/skills_index.json b/skills_index.json index 7e8f6a36..cdc194db 100644 --- a/skills_index.json +++ b/skills_index.json @@ -7655,7 +7655,7 @@ "category": "uncategorized", "name": "metasploit-framework", "description": "This skill should be used when the user asks to \"use Metasploit for penetration testing\", \"exploit vulnerabilities with msfconsole\", \"create payloads with msfvenom\", \"perform post-exp...", - "risk": "unknown", + "risk": "offensive", "source": "community", "date_added": "2026-02-27" }, diff --git a/walkthrough.md b/walkthrough.md index b38f34fc..504d5c0d 100644 --- a/walkthrough.md +++ b/walkthrough.md @@ -1,5 +1,12 @@ -# Session Handoff - Merged 3 PRs +# Maintenance Walkthrough - 2026-03-12 -- **Completed Tasks**: Merged PRs 261, 260, and 250 using the established GitHub maintenance procedures. Fixed drift and merge conflicts locally for 261 and 250 respectively before squashing. -- **Post-Merge**: Rebased `main`, verified generated validation chains, and successfully appended new contributors (@Enreign, @kennyzheng-builds) to the README. -- **Artifacts**: See internal context for full execution logs and step details. +- Merged PRs `#277`, `#272`, `#275`, `#278`, and `#271` via GitHub squash merge after bringing contributor branches into a mergeable state and refreshing PR bodies against the quality checklist in `.github/MAINTENANCE.md`. +- Verified PR `#271` locally with `npm run validate:references` and `npm run test` before merge; confirmed `#269` auto-closed from the merged PR body. +- Added a user-facing Windows truncation recovery guide at `docs/users/windows-truncation-recovery.md`, linked it from `README.md`, `docs/users/faq.md`, `docs/users/getting-started.md`, and `docs/integrations/jetski-cortex.md`, and credited the workflow to issue `#274`. +- Updated `skills/metasploit-framework/SKILL.md` to remove the remote installer flow, require an existing Metasploit installation, and add the required offensive-skill warning. +- Ran the required maintenance validations after the direct fixes: + - `npm run validate` + - `npm run validate:references` + - `npm run chain` + - `npm run catalog` +- Final release prep, issue closure comments, and verification were completed on `main`.