From a60578a94698655333f827782107f019534f7758 Mon Sep 17 00:00:00 2001
From: Hoid <hoid@openclaw>
Date: Sun, 15 Feb 2026 09:06:00 +0000
Subject: [PATCH] Add BG3 companion skill + update save file schema

---
 memory/bg3.json                           | 16 ++++-
 skills/bg3-companion/SKILL.md             | 83 +++++++++++++++++++++++
 skills/bg3-companion/references/builds.md | 75 ++++++++++++++++++++
 3 files changed, 172 insertions(+), 2 deletions(-)
 create mode 100644 skills/bg3-companion/SKILL.md
 create mode 100644 skills/bg3-companion/references/builds.md

diff --git a/memory/bg3.json b/memory/bg3.json
index eea63c9..522b85d 100644
--- a/memory/bg3.json
+++ b/memory/bg3.json
@@ -1,8 +1,20 @@
 {
+  "mainCharacter": {
+    "name": "",
+    "race": "",
+    "class": "Fighter",
+    "subclass": "",
+    "level": 4,
+    "stats": {},
+    "feats": [],
+    "fightingStyle": "",
+    "equipment": ""
+  },
   "party": [],
-  "level": 4,
   "act": 1,
-  "currentQuest": "Rescue Halsin (goblin camp — too low level currently)",
+  "level": 4,
+  "currentQuest": "Rescue Halsin (goblin camp)",
+  "completedQuests": [],
   "completedAreas": ["Owlbear Cave"],
   "decisions": [],
   "notes": "Suggested leveling in Emerald Grove, Blighted Village, Owlbear Cave, Risen Road before tackling goblin camp."
diff --git a/skills/bg3-companion/SKILL.md b/skills/bg3-companion/SKILL.md
new file mode 100644
index 0000000..f20287e
--- /dev/null
+++ b/skills/bg3-companion/SKILL.md
@@ -0,0 +1,83 @@
+---
+name: bg3-companion
+description: "Baldur's Gate 3 Spielbegleiter. Verwende diesen Skill wenn der User über BG3/Baldur's Gate 3 spricht — Builds, Skillung, Respec, Quests, Kampftipps, wo er hängt, Story-Entscheidungen, oder Party-Zusammenstellung. Immer auf Deutsch antworten."
+---
+
+# BG3 Companion
+
+Spielbegleiter für Baldur's Gate 3. **Immer auf Deutsch antworten.**
+
+## Spielstand
+
+Spielstand wird in `memory/bg3.json` gepflegt. Bei jedem BG3-Gespräch:
+
+1. **Lesen**: `memory/bg3.json` laden für aktuellen Stand
+2. **Aktualisieren**: Neue Infos sofort speichern (Party-Änderungen, Level-Ups, Quest-Fortschritt, Entscheidungen)
+3. **Nie vergessen**: Jede Info die der User gibt MUSS in die JSON — das ist das Gedächtnis
+
+### bg3.json Schema
+
+```json
+{
+  "mainCharacter": {
+    "name": "",
+    "race": "",
+    "class": "",
+    "subclass": "",
+    "level": 0,
+    "stats": { "STR": 0, "DEX": 0, "CON": 0, "INT": 0, "WIS": 0, "CHA": 0 },
+    "feats": [],
+    "fightingStyle": "",
+    "equipment": ""
+  },
+  "party": [
+    {
+      "name": "",
+      "class": "",
+      "subclass": "",
+      "level": 0,
+      "build": "",
+      "notes": ""
+    }
+  ],
+  "act": 1,
+  "level": 0,
+  "currentQuest": "",
+  "completedQuests": [],
+  "completedAreas": [],
+  "decisions": [],
+  "notes": ""
+}
+```
+
+## Kernfunktionen
+
+### 1. Build-Beratung & Respec
+
+- Optimale Builds empfehlen basierend auf Party-Zusammensetzung
+- Komplette Respec-Guides: Stats, Feats, Subclass, Equipment-Prioritäten
+- Synergien zwischen Party-Mitgliedern beachten (z.B. Prone + Advantage)
+- Multiclass-Optionen wenn sinnvoll
+
+### 2. Quest-Hilfe
+
+- Spoiler-arm helfen wenn User hängt — erst Hinweise, dann Details wenn nötig
+- Konsequenzen von Entscheidungen erklären (mit Spoiler-Warnung)
+- Optimale Quest-Reihenfolge für Level/Loot
+
+### 3. Kampftipps
+
+- Taktiken für schwierige Kämpfe
+- Positionierung, Crowd Control, Fokus-Targets
+- Party-Synergien im Kampf
+
+## Referenzen
+
+- `references/builds.md` — Optimale Builds pro Companion und Klasse (bei Bedarf laden)
+
+## Wichtig
+
+- **Immer bg3.json aktualisieren** wenn neue Infos kommen
+- **Deutsch** — Spielbegriffe können auf Englisch bleiben (die meisten spielen auf Englisch)
+- **Keine unnötigen Spoiler** — bei Story-Fragen erst allgemein, dann auf Nachfrage detailliert
+- **Praktisch** — konkrete Empfehlungen statt Theorie-Dumps
diff --git a/skills/bg3-companion/references/builds.md b/skills/bg3-companion/references/builds.md
new file mode 100644
index 0000000..abf6393
--- /dev/null
+++ b/skills/bg3-companion/references/builds.md
@@ -0,0 +1,75 @@
+# BG3 Optimale Builds — Kurzreferenz
+
+## Fighter Builds (Damage-fokussiert)
+
+### Battle Master (GWM) — Bester Melee DPS
+- **Stats**: STR 17 (+1 Feat oder Racial) > CON 14 > DEX 14 > WIS 12
+- **Level 4 Feat**: Great Weapon Master
+- **Level 6 Feat**: +2 STR (auf 20) oder Sentinel
+- **Level 8 Feat**: Alert / Savage Attacker / +2 STR
+- **Fighting Style**: Great Weapon Fighting
+- **Maneuvers**: Trip Attack, Riposte, Precision Attack
+- **Strategie**: Trip → Prone → alle hauen mit Advantage; GWM Bonus Action bei Kill
+
+### Battle Master (Sword & Board) — Tank/DPS Hybrid
+- **Stats**: STR 16 > CON 16 > DEX 14 > WIS 12
+- **Level 4 Feat**: Shield Master oder Sentinel
+- **Fighting Style**: Defence oder Duelling
+- **Maneuvers**: Riposte, Menacing Attack, Trip Attack
+
+### Eldritch Knight — Gish Fighter
+- **Stats**: STR 16 > INT 14 > CON 14
+- **Spells**: Shield, Absorb Elements, Misty Step, Haste (via scroll)
+- **Gut wenn**: Party braucht einen Tank der sich selbst buffed
+
+## Companion Builds
+
+### Lae'zel (Fighter)
+- Am besten als **Battle Master GWM** (siehe oben)
+- Respec Stats: STR 17, DEX 14, CON 14, INT 10, WIS 12, CHA 8
+- Githyanki Racial: Medium Armor, nutze Heavy Armor bei Respec
+
+### Karlach (Barbarian)
+- **Berserker** für max Damage (Frenzy = extra Attack als Bonus Action)
+- **Wildheart (Bear)** für Tankiness
+- Stats: STR 17, DEX 14, CON 16, rest dump
+- Feat: GWM (Level 4), +2 STR (Level 8)
+
+### Astarion (Rogue)
+- **Thief** für 2x Bonus Actions (beste Subclass)
+- Dual Wield oder Ranged (Hand Crossbow + Crossbow Expert)
+- Stats: DEX 17, CON 14, WIS 14
+- Feat: Alert oder +2 DEX
+
+### Shadowheart (Cleric)
+- **Life Domain** (Respec) für bestes Healing
+- **Light Domain** für Damage (Fireball!)
+- **Trickery** (Default) ist schwächer
+- Stats: WIS 17, CON 16, DEX 14
+- Feat: +2 WIS oder War Caster
+
+### Gale (Wizard)
+- **Evocation** für AoE Damage (Sculpt Spells = Party-safe Fireballs)
+- Stats: INT 17, CON 16, DEX 14
+- Feat: +2 INT oder Alert
+- Key Spells: Magic Missile, Scorching Ray, Fireball, Haste, Counterspell
+
+### Wyll (Warlock)
+- **Respec zu Swords Bard** (viel stärker als Warlock)
+- Oder **Fiend Warlock** mit Eldritch Blast spam
+- Stats als Warlock: CHA 17, CON 16, DEX 14
+- Feat: +2 CHA oder Spell Sniper
+
+## Party-Synergien
+
+### Max Damage Party
+Fighter (BM/GWM) + Karlach (Berserker) + Gale (Evocation) + Shadowheart (Light)
+
+### Balanced Party
+Fighter (BM/GWM) + Astarion (Thief) + Gale (Evocation) + Shadowheart (Life)
+
+### Key Combos
+- **Trip Attack + Melee**: Prone gibt Advantage auf alle Melee-Angriffe
+- **Haste + GWM Fighter**: Extra Action = Extra GWM Angriff
+- **Hold Person + Melee**: Auto-Crit im Melee gegen gelähmte Gegner
+- **Grease/Web + Ranged**: Area Denial + leichte Ziele