VoyaltaWas der Skill macht
Ein Skill ist eine Anleitung für einen KI-Agenten — ein paar Textdateien und ein kleines Programm. Dieser hier bringt dem Agenten bei, wie eine Voyalta-Reise aufgebaut ist: Tage, Einträge mit Uhrzeiten und Zeitzonen, Ideen ohne festen Termin, Aufgaben und Unterlagen.
Du sagst, wohin es geht. Der Agent plant und schreibt eine Datei mit der Endung .voyalta. Du öffnest sie, und Voyalta macht daraus eine neue Reise — vollständig, mit Flug in zwei Zeitzonen, Hotel über mehrere Nächte und Buchungsnummern an der richtigen Stelle.
Deine bestehenden Reisen bleiben unberührt. Ein Import legt immer eine neue Reise an und überschreibt nie etwas.
Was du dafür brauchst
Im Moment geht der ganze Weg nur auf einem Mac — und nur mit einem Agenten, der auf deine Dateien zugreifen darf. Die Reisedatei wird mit einem Werkzeug gebaut, das zu macOS gehört. Ein Chat im Browser kann den Reiseplan schreiben, die Datei daraus bauen kann er nicht.
Das ändert sich: Eine spätere Version von Voyalta liest den Reiseplan auch direkt als JSON-Datei ein. Dann reicht ein beliebiger Chat auf einem beliebigen Gerät, und dieser Umweg entfällt.
Bis dahin gilt:
- Voller Weg — ein Mac und ein Agent mit Dateizugriff, etwa Claude Code, Claude Desktop, Codex CLI oder Gemini CLI. Der Agent plant und baut die Datei in einem Zug.
- Halber Weg — ein Chat im Browser, etwa ChatGPT, Gemini oder Claude im Web. Du bekommst den fertigen Reiseplan als JSON und baust die Datei anschliessend auf einem Mac mit einem Befehl.
Voyalta selbst brauchst du natürlich auch — die Datei lässt sich auf iPhone, iPad und Mac öffnen.
Herunterladen
voyalta-reise-skill.zip
Im Archiv liegen vier Dateien:
SKILL.md— die Anleitung für den Agenten. Das ist das Herzstück.references/FORMAT.md— das Dateiformat im Detail, für den Fall, dass der Agent genauer nachsehen muss.examples/hongkong.json— eine Beispielreise als Vorlage.scripts/make_voyalta.py— baut aus dem Reiseplan die fertige Reisedatei.
Einrichten
Je nachdem, womit du arbeitest, kommt der Skill anders in den Agenten. Alles danach ist überall gleich.
Claude Code
Das Archiv in den Skill-Ordner entpacken, fertig. Claude findet den Skill dann von selbst, sobald du nach einer Reise fragst.
unzip ~/Downloads/voyalta-reise-skill.zip -d ~/.claude/skills/Claude Desktop
In den Einstellungen unter Capabilities → Skills das Archiv hochladen. Damit der Agent die Datei auch bauen kann, braucht er Zugriff auf deine Dateien — in Claude Desktop über den Dateisystem-Connector.
Codex CLI, Gemini CLI und andere Terminal-Agenten
Das Archiv in deinen Arbeitsordner entpacken und den Agenten auf die Anleitung zeigen lassen: „Lies voyalta-reise/SKILL.md und halte dich daran.“ Wer mit AGENTS.md oder GEMINI.md arbeitet, nimmt die Zeile dort auf.
ChatGPT, Gemini oder Claude im Browser
Lade SKILL.md und references/FORMAT.md in den Chat — bei ChatGPT als Wissensdateien eines Projekts, bei Gemini und Claude als Anhang. Der Chat schreibt dir dann den Reiseplan als JSON. Den speicherst du auf deinem Mac und baust die Datei mit einem Befehl:
python3 voyalta-reise/scripts/make_voyalta.py reiseplan.json -o ~/DesktopEine Reise planen lassen
Jetzt zählt nur noch, was du erzählst. Ein Beispiel:
Stell mir vier Tage Lissabon im März zusammen: Flug ab Zürich,
ein Hotel in der Altstadt, zwei Museen, ein Tagesausflug nach
Sintra und ein paar Essensideen. Mach daraus eine Voyalta-Datei.Je mehr du mitgibst, desto weniger muss der Agent raten: Reisedaten, Budget, mit wem du unterwegs bist, was dich interessiert. Buchungen, die schon stehen, nennst du am besten mit Uhrzeit und Buchungsnummer — sie landen dann an der richtigen Stelle im Plan.
Gute Agenten erfinden nichts. Was sie nicht wissen, lassen sie leer: Eine erfundene Buchungsnummer sieht echt aus und ist schlimmer als ein leeres Feld. Was noch keinen Termin hat, kommt als Idee in die Reise und wartet dort auf dich.
- Du beschreibst die Reise.
- Der Agent stellt sie zusammen und schreibt den Plan.
- Das Programm baut daraus die Reisedatei und prüft sie.
- Du öffnest sie in Voyalta.
In Voyalta importieren
- Mac — Doppelklick auf die Datei.
- iPhone und iPad — in der Dateien-App antippen, oder über das Teilen-Menü an Voyalta schicken.
- Von einem anderen Gerät — die Datei per AirDrop, Mail oder iCloud Drive aufs Gerät bringen und dort öffnen.
Voyalta legt eine neue Reise an und sagt dir danach, wie viele Einträge, Aufgaben und Unterlagen angekommen sind. Trägt die Reise denselben Namen wie eine vorhandene, bekommt sie eine Nummer angehängt — zusammengeführt wird nie.
Stimmt etwas nicht, löschst du die Reise einfach wieder. Sie liegt dann im Papierkorb, wie jede andere auch.
Gut zu wissen
Die Datei ist nicht verschlüsselt
Wer sie hat, liest Buchungsnummern, Kontakte und jede angehängte Unterlage im Klartext. Ein Boardingpass trägt oft den Code, mit dem sich die Buchung ändern lässt. Verschicke die Datei also so umsichtig wie die Unterlagen selbst.
Was nicht mitkommt
Unterlagen nimmt der Agent nur auf, wenn die Dateien bei dir liegen — ein Ticket, das es noch nicht gibt, kann er nicht anhängen. Ein geteilter Web-Link gehört immer zu genau einer Reise und wandert nie mit.
Prüf den Plan
Ein KI-Agent plant schnell, aber nicht unfehlbar. Öffnungszeiten, Feiertage, Anfahrtszeiten und Preise ändern sich — sieh die Reise nach dem Import einmal durch, bevor du buchst.
Für Neugierige
Das Format liegt offen: references/FORMAT.md im Archiv beschreibt die Datei vollständig. Wer mag, baut sich eigene Werkzeuge darauf.