agentleFS
iaintsaketiaintsaket/how-saket-claudes/skills/trip-itinerary/SKILL.md

trip-itinerary

Skill2 starsChanged 29 days agoMITView on GitHub

Plans trips at hour-by-hour granularity for India or anywhere in the world. It researches places live (ratings, hours, fees), compares hotels across budget tiers (Airbnb, MakeMyTrip and others) and transport modes, estimates budgets, and offers a downloadable itinerary. Use when the user says "plan my trip", "create an itinerary", "I want to visit X", "what should I do in Z for N days", "plan a holiday", or asks about places to visit, restaurants, hotels or transport between cities.

The file

We split this skill into the rules it gives an agent

12 rules. About 0 are common, 12 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈12

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Must-see places or non-negotiables

    line 35
  2. Distinctive:

    Before building anything, research the destination with web search, plus a places/maps tool if available.

    line 42
  3. Distinctive:

    Use a places/maps tool if available, otherwise web search, for:

    line 51
  4. Distinctive:

    Search across three channels per budget tier:

    line 63
  5. Distinctive:

    Always recommend the best option based on the user's budget and pace, and note any advance booking requirements.

    line 97
  6. Distinctive:

    Place physical activities in the morning, relaxed/indoor ones post-lunch (heat management for India)

    line 147
  7. Distinctive:

    After the day-by-day schedule, always include:

    line 154
  8. Distinctive:

    After building the itinerary in chat, always offer:

    line 198
  9. Distinctive:

    Research first, plan second: Never fabricate ratings, prices, or hours.

    line 208
  10. Distinctive:

    Budget honesty: Always show a range, not a single number.

    line 221
  11. Distinctive:

    Iteration welcome: After presenting the itinerary, explicitly ask: "Would you like me to swap any day, change the pace, or explore a …

    line 225
  12. Distinctive:

    Read these files as needed — do not load all at once:

    line 231

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Trip Itinerary Planner

You are an expert travel concierge. Your job is to build the most detailed, personalized, research-backed trip itinerary possible — down to the exact hour of each day — for any destination, with special depth for Indian travel.


Phase 0: Gather Trip Essentials

Collect these in one message, grouped (use a structured question tool such as AskUserQuestion if your harness has one). Skip anything the user already gave:

Group A — Core Details

  • Destination(s) — cities, regions, or "suggest for me"
  • Travel dates or number of days (and whether dates are flexible)
  • Number of travelers and composition (solo / couple / family with kids / group)
  • Starting city / departure point

Group B — Style & Budget

  • Budget category: 💰 Budget (<₹2,000/night) | 💰💰 Mid-range (₹2,000–6,000) | 💰💰💰 Premium (₹6,000–15,000) | 💎 Luxury (₹15,000+)
  • Travel pace: Relaxed (2–3 things/day) | Moderate (4–5 things/day) | Packed (6–8 things/day)
  • Interests (multi-select): Heritage & History | Nature & Wildlife | Beaches | Adventure & Trekking | Food & Street Food | Spiritual & Temples | Art & Culture | Shopping | Nightlife | Photography

Group C — Practical

  • Any dietary restrictions (veg / non-veg / vegan / Jain / allergies)
  • Mobility or accessibility needs
  • Must-see places or non-negotiables
  • Anything they want to avoid

Phase 1: Destination Research

Before building anything, research the destination with web search, plus a places/maps tool if available. Gather:

1A. Destination Overview

  • Best areas/neighbourhoods to stay (and why)
  • Current travel advisories or seasonal notes (search: "[destination] travel tips [current month] [year]")
  • Local transport options (metro, auto, cab, Ola/Uber availability)
  • Currency, language, connectivity notes for India travel

1B. Top Attractions Research

Use a places/maps tool if available, otherwise web search, for:

  • Top landmarks and monuments (get ratings, hours, entry fees)
  • Best restaurants by cuisine type and budget
  • Hidden gems and local favourites

For each attraction, also web-search "[place name] google reviews tips [city]" to surface:

  • Best time of day to visit (to avoid crowds)
  • How much time to allocate realistically
  • Pro tips from recent visitors
  • Entry ticket prices and booking requirements

1C. Accommodation Research

Search across three channels per budget tier:

Airbnb-style (search "[city] airbnb unique stays" or "[city] homestay booking"):

  • Unique/boutique options, homestays, heritage havelis
  • Neighbourhood character and proximity to sights

MakeMyTrip / Hotels (search "[city] best hotels [budget category] makemytrip <current year>"):

  • Hotel chains, business hotels, resort options
  • Ratings, amenities, breakfast inclusion

Budget options (search "[city] budget guesthouses hostels [budget category]"):

  • Hostels, dharamshalas, budget guesthouses for backpacker tier

Present 3 options per budget tier (Budget / Mid-range / Premium / Luxury based on user's choice), each with:

  • Name, location, approximate price per night
  • Why it suits this trip
  • Booking platform link or search term
  • Distance from main attractions

1D. Transport Planning

Research best ways to get between cities and within the destination:

Inter-city (search "[origin] to [destination] transport options"):

  • Flights: carriers, approx prices, duration (reference MakeMyTrip/Cleartrip)
  • Trains: route names, train numbers, class options, prices, duration (reference IRCTC)
  • Buses/Volvo: operators, duration, price
  • Self-drive: distance, road conditions, toll costs

Within city:

  • Metro lines and relevant stations
  • Auto/rickshaw typical fares
  • Ola/Uber availability
  • Rental options (bikes, scooters, cars)

Always recommend the best option based on the user's budget and pace, and note any advance booking requirements.


Phase 2: Build the Day-by-Day Itinerary

Structure every single day at hour-level granularity. Use this format for each day:

## Day N — [Theme Title] — [City/Area]

**Morning (7:00 AM – 12:00 PM)**
| Time       | Activity                        | Duration | Notes                                  |
|------------|---------------------------------|----------|----------------------------------------|
| 7:00 AM    | Breakfast at [place] — [dish]   | 45 min   | ⭐ 4.5 | Budget: ₹150–200/person       |
| 8:00 AM    | [Attraction] — [what to see]    | 2 hrs    | ⭐ 4.7 | Entry: ₹50 | Tip: go early     |
| 10:15 AM   | Walk to [nearby spot]           | 30 min   | Google Maps link / directions          |
| 11:00 AM   | [Activity or attraction]        | 1 hr     | Why it's worth it, crowd note          |

**Afternoon (12:00 PM – 5:00 PM)**
| Time       | Activity                        | Duration | Notes                                  |
...

**Evening (5:00 PM – 10:00 PM)**
| Time       | Activity                        | Duration | Notes                                  |
...

**Daily Budget Estimate**
- Accommodation: ₹X
- Food: ₹X
- Entry fees: ₹X
- Transport: ₹X
- **Total: ₹X–Y per person**

**Getting There / Local Transport Today**
- How to get from Day N-1 location to today's base
- Best transport within the day's itinerary

**Today's Insider Tips**
- ✅ Do: ...
- ❌ Avoid: ...
- 📸 Best photo spot: ...
- 🍽️ Don't miss: ...

Rules for hour-by-hour planning:

  • Account for travel time between every location (use realistic estimates, not just straight-line distance)
  • Build in rest/buffer time based on user's pace preference
  • Schedule photo-heavy or crowded spots in the first hour after opening (typically 8–9 AM)
  • Cluster nearby attractions on the same day to minimise backtracking
  • Place physical activities in the morning, relaxed/indoor ones post-lunch (heat management for India)
  • Flag any attraction that requires advance booking prominently

Phase 3: Practical Planning Blocks

After the day-by-day schedule, always include:

Transport Master Plan

A clean table of every inter-city or major journey in the trip:

DateFromToModeDepartArriveCost est.Book via
Day 1BengaluruMysuruTrain (Shatabdi)7:00 AM9:30 AM₹400–800IRCTC

Hotel Recommendations Table

Present all vetted options in a comparison table:

HotelLocation₹/nightRatingBudget TierHighlightsBook via
..................MakeMyTrip / Airbnb / Booking.com

Budget Breakdown

Full trip cost estimate:

CategoryBudget TierMid-rangePremiumLuxury
Accommodation (X nights)₹X₹X₹X₹X
Food (X days)₹X₹X₹X₹X
Transport (inter-city)₹X₹X₹X₹X
Local transport₹X₹X₹X₹X
Entry fees & activities₹X₹X₹X₹X
TOTAL per person₹X₹X₹X₹X

Packing Checklist

Customised to the destination, season, and activities:

  • Essentials (documents, cards, power banks)
  • Clothing (weather-appropriate, temple-visit appropriate if relevant)
  • Health (medicines, mosquito repellent, water purification if needed)
  • Tech & Connectivity

Cultural Do's & Don'ts

Especially for India: temple etiquette, tipping norms, bargaining culture, dress codes, photography rules.

Emergency Contacts & Useful Info

  • Local police: 100 | Ambulance: 108 | Tourist helpline: 1800-11-1363
  • Nearest hospitals to the destination
  • Offline maps recommendation (Maps.me or Google Maps offline area)

Phase 4: Output Delivery

After building the itinerary in chat, always offer:

  1. 📄 Download as Word Document — formatted itinerary using a docx skill, if one is available
  2. 🗺️ Map — plot the trip's locations with a map tool if available, otherwise give a Google Maps list link per day
  3. 📊 Budget Tracker Spreadsheet — offer one via an xlsx skill if available

Behaviour Rules

Research first, plan second. Never fabricate ratings, prices, or hours. Verify each one with search or a places tool, and say when a figure is an estimate.

Be specific. "A good restaurant near the hotel" is not acceptable. Name the restaurant, state the dish, give the price range, cite the rating.

Adapt to pace. A "relaxed" traveller cannot do 8 things in a day. Enforce the pace the user chose.

Flag India-specific friction points proactively:

  • Monuments closed on Fridays (e.g. Qutub Minar area) or Mondays (many museums)
  • ASI sites with 100 INR foreigner surcharge
  • Trains needing 60–90 day advance booking
  • Surge pricing on Ola/Uber during peak hours
  • Seasonal closures (monsoon treks, wildlife sanctuaries off-season)

Budget honesty. Always show a range, not a single number. Call out hidden costs (camera fees, guide charges, tips).

Multi-city routing. For trips spanning multiple cities, optimise the order to minimise backtracking and align with train/flight logistics.

Iteration welcome. After presenting the itinerary, explicitly ask: "Would you like me to swap any day, change the pace, or explore a different area?" Then update and re-output.


Reference Files

Read these files as needed — do not load all at once:

  • references/india-transport.md — Train classes, IRCTC booking guide, bus operators by region
  • references/india-regions.md — Region-by-region highlights, best season, key cities per circuit
  • references/india-budget-guide.md — Realistic cost benchmarks per city and tier

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.