Fatelo organizzare. Importate, è pronto.

Che cosa fa lo skill

Uno skill è un insieme di istruzioni per un agente IA: alcuni file di testo e un piccolo programma. Questo insegna all’agente com’è fatto un viaggio Voyalta: giorni, voci con orari e fusi orari, idee senza data fissa, attività e documenti.

Dite dove volete andare. L’agente pianifica e scrive un file con estensione .voyalta. Lo aprite, e Voyalta ne ricava un nuovo viaggio — completo, con il volo su due fusi orari, l’hotel per più notti e i numeri di prenotazione al posto giusto.

I viaggi già presenti restano intatti. Un’importazione crea sempre un nuovo viaggio e non sovrascrive mai nulla.

Che cosa vi serve

Fino ad allora:

• Percorso completo — un Mac e un agente con accesso ai file, per esempio Claude Code, Claude Desktop, Codex CLI o Gemini CLI. L’agente pianifica e crea il file in un’unica volta.
• Mezzo percorso — una chat nel browser, per esempio ChatGPT, Gemini o Claude sul web. Ricevete il piano di viaggio finito in JSON e poi create il file su un Mac con un solo comando.

E naturalmente Voyalta — il file si apre su iPhone, iPad e Mac.

Scarica

L’archivio contiene quattro file:

• SKILL.md — le istruzioni per l’agente. È il cuore di tutto.
• references/FORMAT.md — il formato del file nel dettaglio, se all’agente servisse un riscontro preciso.
• examples/hongkong.json — un viaggio di esempio come modello.
• scripts/make_voyalta.py — trasforma il piano di viaggio nel file di viaggio finito.

Installazione

Il modo in cui lo skill arriva nell’agente dipende da ciò che usate. Tutto il resto è uguale ovunque.

unzip ~/Downloads/voyalta-reise-skill.zip -d ~/.claude/skills/

python3 voyalta-reise/scripts/make_voyalta.py reiseplan.json -o ~/Desktop

Farsi organizzare un viaggio

Da qui in poi conta solo quello che raccontate. Un esempio:

Preparami quattro giorni a Lisbona a marzo: volo da Zurigo,
un hotel nel centro storico, due musei, una gita a Sintra
e qualche idea su dove mangiare. Fanne un file Voyalta.

Più informazioni date, meno l’agente deve indovinare: date, budget, con chi viaggiate, che cosa vi interessa. Le prenotazioni già fatte conviene indicarle con orario e numero di prenotazione — finiscono così al posto giusto nel piano.

Gli agenti bravi non inventano nulla. Ciò che non sanno lo lasciano vuoto: un numero di prenotazione inventato sembra vero ed è peggio di un campo vuoto. Ciò che non ha ancora una data entra nel viaggio come idea e lì vi aspetta.

1. Descrivete il viaggio.
2. L’agente lo compone e scrive il piano.
3. Il programma ne crea il file di viaggio e lo verifica.
4. Lo aprite in Voyalta.

Importare in Voyalta

• Mac — doppio clic sul file.
• iPhone e iPad — toccatelo nell’app File, oppure inviatelo a Voyalta dal menu di condivisione.
• Da un altro dispositivo — portate il file sul dispositivo con AirDrop, e-mail o iCloud Drive e apritelo lì.

Voyalta crea un nuovo viaggio e poi vi dice quante voci, attività e documenti sono arrivati. Se il viaggio ha lo stesso nome di uno esistente, viene aggiunto un numero — non si unisce mai nulla.

Se qualcosa non va, basta eliminare di nuovo il viaggio. Finisce nel cestino, come ogni altro.

Buono a sapersi

Il file non è cifrato

Chi lo possiede legge in chiaro numeri di prenotazione, contatti e ogni documento allegato. Una carta d’imbarco riporta spesso il codice con cui si può modificare la prenotazione. Inviate quindi il file con la stessa prudenza dei documenti stessi.

Che cosa non viene incluso

L’agente può includere solo documenti i cui file sono già da voi — un biglietto che non esiste ancora non può essere allegato. Un link web condiviso appartiene sempre a un solo viaggio e non viene mai incluso.

Controllate il piano

Un agente IA pianifica in fretta, ma non è infallibile. Orari di apertura, giorni festivi, tempi di percorrenza e prezzi cambiano — ripassate il viaggio dopo l’importazione, prima di prenotare.

Per i curiosi

Il formato è aperto: references/FORMAT.md nell’archivio descrive il file per intero. Chi vuole, può costruirci i propri strumenti.