JourniOne-ai/JourniOne-Planning-Skills

JourniOne – Travel Journal Creator (AI‑powered planning skill)

What it is

• An open‑source Skill that can be added to the JourniOne platform (or any compatible client) to turn a travel idea into a day‑by‑day itinerary, suggest hotels and flights, and output a visual “travel journal” that can be explored or shared.

Core capabilities

Feature	What the README says it does
Natural‑language planning	You type or speak a request like “I want four days in Tokyo, I like jazz and walks” and the skill generates two possible itineraries, lets you tweak them, and finally creates a guide.
Daily route generation	The skill builds day‑level routes that respect your pace, interests, and required travel time.
Hotel search & comparison	Through the TourMind hotel service it queries >100 hotel channels (Ctrip, Agoda, Booking.com, etc.), shows live rates, room types, meals, taxes, cancellation terms, and explains why a hotel matches the route and budget.
Flight search	Optional integration with Kiwi.com to fetch flight options that fit the itinerary.
Interactive visual journal	After confirmation you get a flip‑book‑style guide with images, stories, daily plans, and a map view that shows routes and places. The guide can be shared via a public link without needing a JourniOne account.
Privacy‑aware sharing	Public links are possible; the README warns to remove personal data before sharing and points to a privacy document.
Reporting toggle	Basic usage reporting is enabled by default but can be turned off permanently; it does not capture chat content.

How it works under the hood

• The skill is a Node.js (v22+) package. It relies on two other skills that must be present in the client: TourMind hotel Skill (for hotel data) and Kiwi MCP (for flight data). During installation the agent checks for these dependencies and prompts only when manual steps are required.
• When you issue a natural‑language request, the skill sends the request to the JourniOne backend (journione.ai). The backend (presumably an LLM‑driven service) interprets the intent, assembles possible itineraries, and calls the hotel/flight APIs as needed.
• The results are formatted into a structured itinerary, which the client can render as the Journal view (photos, stories) or Map view (Google‑Maps routes).
• Booking actions are only performed after you explicitly request them; creating a guide or comparing prices does not place an order.

Getting started

1. Install – Import the repository via the client’s Skill manager (display name Travel Journal Creator) or follow the INSTALL.md guide to use a release package.
2. Dependencies – Ensure the client already has the TourMind hotel Skill and Kiwi MCP; the installer will verify them.
3. Run – Describe your trip in plain language, iterate on the suggested plans, ask for hotel/flight comparisons, and finally issue “Create the guide from this version.”
4. Share – Export a public link or download the journal to share with friends.

Typical use cases

• Solo travelers who want a quick, AI‑generated itinerary that respects a budget and personal interests.
• Group trip planners who need a visual, shareable guide to discuss options with friends.
• Travel agents looking for a rapid prototype to generate drafts before adding their own branding.

What the repo does not include

• The actual LLM model or the JourniOne backend code; those are hosted at journione.ai.
• Direct payment processing – bookings are handed off to the selected hotel/flight channel.

Bottom line JourniOne‑Planning‑Skills is a genuine, AI‑driven travel‑planning tool that plugs into the JourniOne ecosystem, handling itinerary generation, hotel/flight search, and the creation of a shareable visual travel journal, all orchestrated via natural‑language interaction.