From e695e55cca5cf8e0a91de0d02f708f9d8524a5e6 Mon Sep 17 00:00:00 2001
From: Oliver Vogt <oliver@vogt.de.com>
Date: Sat, 22 Aug 2026 19:23:18 +0200
Subject: [PATCH] =?UTF-8?q?Haupt-README=20mit=20Inhaltsverzeichnis=20und?=
 =?UTF-8?q?=20Repo-=C3=9Cbersicht=20hinzuf=C3=BCgen?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 71 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4000b5a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,71 @@
+# Amazon Alexa Skills
+
+Sammlung eigener, privater Alexa Custom Skills. Jeder Skill liegt in einem eigenen Unterordner mit vollständiger Dokumentation.
+
+## Inhaltsverzeichnis
+
+- [Übersicht](#übersicht)
+- [Skills](#skills)
+  - [Home Assistant Skill](#home-assistant-skill)
+- [Allgemeine Voraussetzungen](#allgemeine-voraussetzungen)
+- [Repo-Struktur](#repo-struktur)
+- [Sicherheitshinweise](#sicherheitshinweise)
+
+---
+
+## Übersicht
+
+Dieses Repository enthält den Code, die Konfiguration und die Dokumentation für selbst entwickelte Alexa Skills. Alle Skills sind **privat** (nicht im Alexa Skill Store veröffentlicht) und laufen als **Alexa-hosted Skills** (Node.js) — es ist keine eigene AWS-Infrastruktur nötig.
+
+---
+
+## Skills
+
+### Home Assistant Skill
+
+📁 [`home-assistant-skill/`](home-assistant-skill/)
+
+Fragt per Sprache Werte aus Home Assistant ab, z.B. Raumtemperaturen von Heizungsthermostaten.
+
+**Beispiel:**
+> "Alexa, frag Home Assistant wie warm es im Wohnzimmer ist"
+> → "Die Temperatur im Wohnzimmer beträgt 24.4 Grad."
+
+**Status:** ✅ `GetTemperatureIntent` funktionsfähig · ⏳ `GetPowerUsageIntent` (Stromverbrauch) noch offen
+
+➡️ [Vollständige Anleitung & Dokumentation](home-assistant-skill/README.md)
+
+---
+
+## Allgemeine Voraussetzungen
+
+Für alle Skills in diesem Repo gilt:
+
+- Amazon Developer Account (ggf. mit Identitätsverifizierung — Amazon fordert bei manchen Accounts einen Ausweis-Upload unter "Verify Identity")
+- Grundkenntnisse der [Alexa Developer Console](https://developer.amazon.com/alexa/console/ask)
+- Node.js-Kenntnisse für Anpassungen am Lambda-Code
+
+Skill-spezifische Voraussetzungen (z.B. eine erreichbare Home-Assistant-Instanz) stehen jeweils in der README des Unterordners.
+
+---
+
+## Repo-Struktur
+
+```
+Amazon-Alexa-Skills/
+├── README.md                      # diese Übersicht
+└── home-assistant-skill/
+    ├── README.md                  # Step-by-Step-Anleitung
+    ├── index.js                   # Lambda-Handler
+    ├── package.json               # Node-Abhängigkeiten
+    └── .env.example               # Vorlage für Secrets
+```
+
+Neue Skills werden jeweils als eigener Unterordner mit derselben Struktur (`README.md`, Code, `.env.example`) ergänzt.
+
+---
+
+## Sicherheitshinweise
+
+- **Keine echten Secrets committen.** `.env`-Dateien mit echten Tokens gehören nicht ins Repo — nur `.env.example` mit Platzhaltern. Alexa-hosted Skills bieten keine Environment-Variables-Oberfläche in der Konsole; Secrets landen daher direkt im Skill-Code selbst (nicht in diesem Git-Repo).
+- Dieses Repository ist **privat** — das ist Voraussetzung dafür, dass die dokumentierten Vorgehensweisen (z.B. Hardcoding von Tokens im Skill-Code) vertretbar sind. Bei einer Veröffentlichung oder Freigabe für Dritte müssten Secrets vorher ausgetauscht und sauberer verwaltet werden.