Document game architecture and update README

README.md

@@ -50,14 +50,37 @@ npm run dev
 - Three.js + TypeScript + Vite
 - Steuerung: WASD bewegen, Space springen, Maus zielen,
   Linksklick Schwert, Rechtsklick Feuerball (per Skill),
-  Q Kettenblitz (per Skill), E Teleport (per Skill), H Hitboxen (Debug)
-- Roguelike-Skillsystem: Kills geben XP, bei Level-Up pausiert das Spiel
-  und bietet 3 Skill-Karten (neue Skills oder Upgrades). Seed (Startmenü)
-  steuert die Angebote, "Nochmal spielen" behält den Seed bei.
+  Q/E/1–4 Skills (Hotbar, siehe unten), ESC Pause, H Hitboxen (Debug)
+
+### Skillsystem
+
+Kills geben XP, bei Level-Up pausiert das Spiel und bietet 3 Skill-Karten
+(neue Skills oder Upgrades). Seed (Startmenü) steuert die Angebote,
+„Nochmal spielen" behält den Seed bei.
+
+| Skill | Art | Effekt |
+|---|---|---|
+| Feuerball | Aktiv (Rechtsklick) | Explodierender Feuerball |
+| Teleport | Aktiv (Hotbar) | Teleport zum Zielpunkt |
+| Kettenblitz | Aktiv (Hotbar) | Blitz springt auf mehrere Gegner |
+| Falle | Aktiv (Hotbar) | Hält 1 Gegner fest und fügt Schaden zu |
+| Gaswolke | Aktiv (Hotbar) | Bleibt am Boden, Schaden über Zeit |
+| Aura | Passiv | Bodenkreis um den Spieler, Schaden + Wegstoß |
+| Bumerang | Passiv | Kreist um den Spieler (ab Stufe 3 mehrere) |
+| Reichweite / Schärfe | Passiv | Schwert-Range/-Schaden |
+| Regeneration / HP-Absorption | Passiv | Heilung |
+| Schild | Passiv | Absorbiert Schaden, lädt nach 8 s neu |
+| Vitalität / Dornen / Flinke Füße | Passiv | Max-HP / Kontakt-DPS / Tempo |
+
+- **Hotbar**: Aktive Skills werden in Erwerbs-Reihenfolge auf Q, E, 1–4
+  verteilt; Cooldown-Anzeigen zeigen Taste + Name, Level-up-Karten die
+  künftige Taste.
+- **Schadens-Feedback**: Blutpartikel, roter Vignette-Flash, Blob blitzt rot
+  auf, ab <30 % HP pulsierende rote Vignette.
 
 ## Verzeichnisse
 
 - `Original/` — Original-Build (Blobtest.exe, JME3-Libs)
 - `extracted/` — Aus dem Original extrahierte Assets
 - `decompiled/` — Decompilierter Java-Source
-- `web/` — Browser-Version
+- `web/` — Browser-Version (Code-Struktur: siehe `AGENTS.md`)