raspi_openclaw/vdirsyncer_khal/calendar skill/SKILL.md

name, description, requires, user-invocable

name	description	requires	user-invocable
mailbox_calendar	Liest, erstellt und verwaltet Termine und Aufgaben aus dem mailbox.org-Kalender via khal (Termine) und todoman (Aufgaben). Immer verwenden wenn der Nutzer nach Terminen, Kalender, Aufgaben, Tasks oder To-Dos fragt.	bins khal vdirsyncer	true

mailbox.org Kalender & Aufgaben

Dieser Skill gibt dir Zugriff auf den mailbox.org-Kalender und die Aufgabenliste von hans@dumbass über die lokal synchronisierten vdirsyncer-Verzeichnisse.

Wichtige Pfade

• Kalender-vdir: /home/hans/.local/share/vdirsyncer/calendars/Y2FsOi8vMC8zMg
• Task-vdir: /home/hans/.local/share/vdirsyncer/tasks/MzU
• khal-Binary: /usr/bin/khal
• todo-Binary: /home/hans/bin/todo
• vdirsyncer-Binary: /usr/bin/vdirsyncer

Pflichtregeln

1. Vor jeder Lese-Operation immer zuerst vdirsyncer sync ausführen, damit die Daten aktuell sind.
2. Nach jeder Schreib-Operation (neuer Termin, neue Aufgabe, Abschluss) immer vdirsyncer sync ausführen, damit die Änderung zu mailbox.org hochgeladen wird.
3. Niemals Termine oder Aufgaben erfinden. Wenn keine Daten vorhanden, klar sagen: "Keine Termine/Aufgaben gefunden."
4. Bei Fehlern den genauen Fehlertext an den Nutzer weitergeben.

Kalender-Operationen

Termine anzeigen – heute

exec: vdirsyncer sync
exec: khal list today

Termine anzeigen – nächste N Tage

exec: vdirsyncer sync
exec: khal list today Nd

Beispiel für 7 Tage: khal list today 7d

Termine anzeigen – bestimmtes Datum

exec: vdirsyncer sync
exec: khal list YYYY-MM-DD

Nächste Woche

exec: vdirsyncer sync
exec: khal list monday 7d

Neuen Termin erstellen

exec: khal new YYYY-MM-DD HH:MM HH:MM "Titel des Termins"
exec: vdirsyncer sync

Beispiel: khal new 2026-06-01 14:00 15:00 "Zahnarzt" Ganztägiger Termin: khal new 2026-06-01 "Geburtstag Oma"

Interaktiver Kalender (nur wenn Nutzer explizit fragt)

exec: ikhal

Aufgaben-Operationen

Alle offenen Aufgaben anzeigen

exec: vdirsyncer sync
exec: /home/hans/bin/todo list

Aufgaben mit Fälligkeitsdatum anzeigen

exec: vdirsyncer sync
exec: /home/hans/bin/todo list --due

Neue Aufgabe erstellen (mit Fälligkeitsdatum)

exec: /home/hans/bin/todo new "Titel der Aufgabe" --due YYYY-MM-DD
exec: vdirsyncer sync

Beispiel: /home/hans/bin/todo new "Steuererklärung einreichen" --due 2026-05-31

Neue Aufgabe erstellen (ohne Datum)

exec: /home/hans/bin/todo new "Titel der Aufgabe"
exec: vdirsyncer sync

Aufgabe als erledigt markieren

Zuerst ID der Aufgabe ermitteln:

exec: /home/hans/bin/todo list

Dann mit der angezeigten ID:

exec: /home/hans/bin/todo done <ID>
exec: vdirsyncer sync

Aufgabe löschen

exec: /home/hans/bin/todo delete <ID>
exec: vdirsyncer sync

Ausgabe-Format

• Termine immer mit Datum, Uhrzeit und Titel ausgeben.
• Aufgaben mit ID, Titel und Fälligkeitsdatum (falls vorhanden) ausgeben.
• Wenn khal list leer zurückkommt, sagen: "Keine Termine in diesem Zeitraum."
• Wenn /home/hans/bin/todo list leer zurückkommt, sagen: "Keine offenen Aufgaben."

Fehlerbehandlung

• Wenn vdirsyncer sync mit einem Fehler endet: den Fehler anzeigen, nicht weitermachen.
• Wenn khal oder todo nicht gefunden: prüfen ob die Binaries existieren:

  exec: which khal
  exec: ls /home/hans/bin/todo
  

• Wenn khal "critical: ..." meldet: Konfigurationsfehler, Nutzer auf ~/.config/khal/config hinweisen.

Beispiel-Abläufe

"Was habe ich diese Woche?"

1. vdirsyncer sync
2. khal list today 7d
3. Ausgabe strukturiert zurückgeben.

"Erstelle einen Termin: Arzt am 15. Mai um 9 Uhr"

1. khal new 2026-05-15 09:00 10:00 "Arzt"
2. vdirsyncer sync
3. Bestätigung ausgeben.

"Welche Aufgaben sind fällig?"

1. vdirsyncer sync
2. /home/hans/bin/todo list --due
3. Ausgabe mit IDs und Daten zurückgeben.

"Markiere Aufgabe 3 als erledigt"

1. /home/hans/bin/todo done 3
2. vdirsyncer sync
3. Bestätigung ausgeben.