From 660979c5467f09e1805ec6a6461fdb4871b11e9d Mon Sep 17 00:00:00 2001
From: Keith Guerin <keithguerin@gmail.com>
Date: Wed, 18 Mar 2026 09:53:19 -0700
Subject: [PATCH] docs: add UX Team WELCOME guide to auto-display on sync

---
 WELCOME.md             | 40 ++++++++++++++++++++++++++++++++++++++++
 scripts/sync-skills.sh |  3 +++
 2 files changed, 43 insertions(+)
 create mode 100644 WELCOME.md

diff --git a/WELCOME.md b/WELCOME.md
new file mode 100644
index 0000000000..a570328eee
--- /dev/null
+++ b/WELCOME.md
@@ -0,0 +1,40 @@
+# 🚀 Welcome to the UX Team "Global Toolbox"
+
+You have successfully installed the Gemini CLI UX power-ups!
+
+These tools are designed to help us sprint toward the **Gemini 1.0 Milestone**
+without fighting the CLI. They are "opinionated" and built specifically for the
+UX "Vibe Coding" workflow.
+
+## 🛠️ Your New Superpowers
+
+You now have four new commands available in your Gemini CLI session. Because
+they are synced globally, **you can use them on any branch.**
+
+- `/_ux_git-worktree` : Ditch nested branches! Use this to manage your tasks in
+  parallel sibling folders (Base Folder Strategy). It auto-runs `npm install`
+  for you!
+- `/_ux_finish-pr` : Your co-author assistant. It runs tests, updates snapshots,
+  fixes CI linting, and squashes your messy trial-and-error commits before
+  force-pushing.
+- `/_ux_designer` : Run this against your new React/Ink components to guarantee
+  they adhere to the v1.0 strict standards (Signal over Noise, Coherent State,
+  Density).
+- `/string-reviewer` : Audits UI text for strict adherence to the project
+  terminology.
+
+## 🧠 Why are we doing this?
+
+We are intentionally keeping these tools in a "floating" Draft PR branch rather
+than merging them to `main`. This isolation lets the UX team iterate at
+lightning speed on our tooling without polluting the main codebase for backend
+engineers.
+
+_(Note: We plan to migrate this entire toolbox into a formal **Gemini CLI
+Extension** in the near future!)_
+
+## 🏁 Get Started
+
+1. Open your terminal.
+2. Ensure you have run `/skills reload`.
+3. Try typing `/_ux_` to see your new tools in action!
diff --git a/scripts/sync-skills.sh b/scripts/sync-skills.sh
index c0f1d09616..ac1b7ea72a 100755
--- a/scripts/sync-skills.sh
+++ b/scripts/sync-skills.sh
@@ -31,3 +31,6 @@ for SKILL in "${CUSTOM_SKILLS[@]}"; do
 done
 
 echo "Done. Run '/skills reload' in your Gemini session to apply changes."
+echo "--------------------------------------------------"
+echo ""
+cat WELCOME.md