From 8d694c389e3a0d3cb761692a90d9c08a4a0ec920 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Csaba=20Attila=20Bir=C3=B3?= <csaba.biro@qubernetic.com>
Date: Fri, 27 Mar 2026 23:53:14 +0100
Subject: [PATCH] docs: update README installation section with
 platform-specific scripts

Replace manual cp with clone + install script instructions for
Linux, macOS, and Windows. Add uninstall and manual fallback sections.
---
 README.md | 49 +++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 47 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index d2cddc7..916f11e 100644
--- a/README.md
+++ b/README.md
@@ -19,11 +19,56 @@ A Claude Code skill that enforces a disciplined Gitflow-based development workfl
 
 ## Installation
 
-Copy the `SKILL.md` file to your global Claude Code skills directory:
+Clone the repo and run the install script for your platform. The script creates a **symlink**, so the skill stays in sync with the repo automatically.
+
+### Linux
+
+```bash
+git clone https://github.com/qubernetic-org/git-workflow-agent-skill.git
+cd git-workflow-agent-skill
+./scripts/install_linux.sh
+```
+
+### macOS
+
+```bash
+git clone https://github.com/qubernetic-org/git-workflow-agent-skill.git
+cd git-workflow-agent-skill
+./scripts/install_macos.sh
+```
+
+### Windows (PowerShell)
+
+```powershell
+git clone https://github.com/qubernetic-org/git-workflow-agent-skill.git
+cd git-workflow-agent-skill
+.\scripts\install_windows.ps1
+```
+
+> **Note:** Windows symlinks require Developer Mode enabled or an elevated terminal. The script falls back to a file copy if symlinks are unavailable.
+
+### Uninstall
+
+```bash
+# Linux
+./scripts/install_linux.sh --uninstall
+
+# macOS
+./scripts/install_macos.sh --uninstall
+```
+
+```powershell
+# Windows
+.\scripts\install_windows.ps1 -Uninstall
+```
+
+### Manual Installation
+
+If you prefer not to use the scripts:
 
 ```bash
 mkdir -p ~/.claude/skills/git-workflow
-cp SKILL.md ~/.claude/skills/git-workflow/SKILL.md
+ln -s "$(pwd)/SKILL.md" ~/.claude/skills/git-workflow/SKILL.md
 ```
 
 The skill will be automatically discovered on the next Claude Code session.