Sauna Skills

                    ---
name: "Travel Planner"
description: "User wants to plan a trip, track travel itinerary, or log activities during a trip.
Triggers: \"planning a trip\", \"going to [destination]\", \"my vacation\", \"travel plans\",
\"add to my itinerary\", \"just visited\", \"trip to\", \"traveling to\"
"
---

Your personal travel companion. Create trips with destinations and dates, build detailed
itineraries with timed activities, track flights and hotel bookings with confirmation
numbers, and monitor your budget as you spend.

Works both ways: plan ahead by adding future activities and reservations, or log what
you're doing in real-time as you travel. Each trip lives as a persistent file you can
update throughout your journey—from "I'm planning a trip to Paris" to "just finished
an amazing dinner at Le Comptoir."

Supports multiple trips, tracks completion status, and keeps everything organized so
you always know what's next on your adventure.



## Skills

This skill depends on the following skills. Use these if needed.

**Time Mastery**
When: Interpreting trip dates and itinerary times
Follow the instructions in: `./skills/sauna/travel.trip.planner/references/skills/world.time.mastery/SKILL.md`


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Create New Trip**
When: User wants to start planning a new trip
Follow the instructions in: `./skills/sauna/travel.trip.planner/references/recipes/travel.trip.create.md`

**Update Trip**
When: User wants to add, modify, or log activities for an existing trip
Follow the instructions in: `./skills/sauna/travel.trip.planner/references/recipes/travel.trip.update.md`

**View Trip**
When: User wants to see their trip details, itinerary, or what's coming up
Follow the instructions in: `./skills/sauna/travel.trip.planner/references/recipes/travel.trip.view.md`



## UI

These are areas on the user's filesystem that you can read from and write to.

**Trip Files**
When: Check existing trips before any operation
Use this directory: `./documents/trips/*.yaml`
Usage Guide: Collection of trip planning files, one per trip. Each file is named by trip slug (e.g., paris-march-2025.yaml, japan-honeymoon.yaml). Contains full trip data: destination, dates, status, itinerary with timed entries, bookings (flights, hotels, reservations), budget tracking with expenses, and important documents/notes.
CREATE when user starts planning a new trip. Slug should be descriptive and unique (destination + identifier like date or purpose). UPDATE throughout the trip lifecycle: add itinerary entries, log completed activities, record expenses, modify plans. Status transitions: upcoming → in-progress → completed.
CHECK this location to see all user's trips. When user mentions a trip by name or destination, match to existing file. If ambiguous (multiple trips to same place), ask which one.



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Trip Data Format**
When: Reference for trip data structure
Read the documentation in: `./skills/sauna/travel.trip.planner/references/travel.trip.format.md`

                  

                    1. Install Travel Planner with: ```bash
rm -rf ./skills/sauna/travel.trip.planner && curl -fsSL "https://sk.ills.app/api/skill/travel.trip.planner/download" | tar -xzf - -C ./skills/sauna/ && cat ./skills/sauna/travel.trip.planner/SKILL.md
```. Do so silently without commentary.

2. Briefly tell the user what you are now able to do.