Travel Itinerary Generator

Travel Itinerary Generator is an AI skill that creates geographically optimized, season-aware, and budget-aligned travel itineraries.

It generates structured, day-by-day vacation plans based on user-provided trip details and follows a validation-driven workflow to ensure realistic, practical travel schedules.

---

✨ Features

• 📍 Destination-aware itinerary planning
• 🗺 Geographic clustering to minimize travel time
• 🌦 Seasonal adjustments based on month of travel
• 💰 Budget-aligned activity suggestions (optional budget support)
• 📅 Smart activity density based on trip length
• 🔁 Iterative refinement support
• 📄 Outputs structured markdown travel plans

---

🧠 How It Works

The skill follows a strict gated workflow:

1️⃣ Input Detection

The skill first scans the user's prompt for:

• Vacation Destination
• Duration of Stay
• Month of Travel
• Budget (Optional)

If all required fields (except optional budget) are present:

• It skips questioning and proceeds to validation.

If fields are missing:

• It asks only for the missing information.
• Questions are asked one at a time.
• It never re-asks for information already provided.

---

2️⃣ Validation Phase

Before generating the itinerary:

• Ensures duration is a positive integer
• Normalizes month format
• Validates numeric budget (if provided)
• Confirms all required fields with the user

If validation fails:

• Re-prompts only for the invalid field
• Does not proceed until corrected

---

3️⃣ Planning Framework (Reference-Driven)

The skill uses internal planning references to ensure quality:

• Attraction Prioritization
  Prioritizes must-see attractions, user interests, and iconic landmarks.

• Geographic Clustering
  Groups attractions by district to minimize backtracking.

• Seasonal Adjustment
  Adapts activities for rainy seasons, extreme heat, winter, or peak tourism.

• Budget Allocation

  • If budget provided → uses exact calculation.
  • If budget omitted → estimates a realistic mid-range budget.
  • Premium experiences labeled as Optional Upgrade.

---

Instructions for Use

1. Make sure you have Node.js and npm installed on your system (required for using npx).

2. Install this skill using one of the following methods:

   • Using the Skills CLI:

     npx skills add https://github.com/tejasashinde/travel-itinerary-generator

   • OR manually:
     • Clone the repository.
     • Place the travel-itinerary-generator folder inside the skills directory (e.g., .claude/skills).

3. Trigger the skill using:

   Plan a 5-day itinerary to Kyoto in October

   OR

   make a travel plan

   and follow the instructions.

License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.