agentleFS
bethronbethron/travel-concierge/skills/plan-trip/SKILL.md

plan-trip

Skill1 starsChanged 4 months agoMITView on GitHub

This skill should be used whenever the user wants to plan a trip, holiday, vacation, getaway, honeymoon, city break, weekend away or any travel of any kind — including business travel: "business trip to", "work trip", "I have a conference in", "client meetings in", "flying out for work". Trigger on phrases like "plan a trip to", "I want to go to", "help me plan a holiday", "we're thinking of visiting", "organise a week in", or even a bare destination with dates. Use it even if the user only mentions one part (e.g. "find me a hotel in Rome") but has no trip in progress, because this skill sets up the trip workspace that every other Travel Concierge skill relies on.

3 other projects use a version of this.

Adopted by

Most recently taken up by

The file

Show its rules and text

We split this skill into the rules it gives an agent

13 rules. 0 are common, 8 are distinctive, and 5 are very specific to this project.

  • 0

    Common

    Most of the 3 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 5

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Create the trip workspace

    line 25
  2. Distinctive:

    Search flights, stays and activities via connectors

    line 26
  3. Very specific:

    Check for a traveller profile first (see traveller-profile skill.

    line 32
  4. Distinctive:

    Keep the interview short: template, destination (if not given), dates or rough timing, party size, origin airport/city, total budget, and …

    line 43
  5. Distinctive:

    Create a folder per trip in the working directory:

    line 51
  6. Very specific:

    Write trip-brief.md immediately after the interview: destination, dates, party, origin, budget ceiling and currency, style, pace, must-dos, …

    line 64
  7. Distinctive:

    Search using the official connectors, delegating to the specialised skills:

    line 75
  8. Distinctive:

    If a connector is unavailable or returns nothing, say so plainly, fall back to web search for guidance, and clearly mark anything not …

    line 90
  9. Very specific:

    Before finalising, check the trip-weather skill for the travel dates — a live forecast if they fall within the connector's horizon, …

    line 101
  10. Distinctive:

    When the trip is for work (template, phrasing, or a conference/meeting is mentioned), the plan inverts: commitments anchor everything else.

    line 108
  11. Very specific:

    Ask about company constraints: a per-night or total policy cap, preferred airlines/chains, and whether receipts matter — if so, have …

    line 117
  12. Very specific:

    Ask once whether to bolt on leisure ("bleisure"): extend the stay a day or two and plan the free evenings with find-activities and …

    line 122
  13. Distinctive:

    Never claim a price, availability or schedule is confirmed unless it came from a connector result in this session.

    line 142

“Common” is measured: kept by at least 6 in 10 of the 3 edited versions of this file we could read. “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

Plan Trip

Act as a knowledgeable, neutral travel planner. Adapt tone and budget level to whatever the traveller asks for — never assume luxury or backpacker by default.

Workflow overview

  1. Offer templates and run a short interview
  2. Create the trip workspace
  3. Search flights, stays and activities via connectors
  4. Draft a day-by-day itinerary and refine it interactively
  5. Track budget throughout; offer checklists and export at the end

Step 1 — Templates plus a short interview

Check for a traveller profile first (see traveller-profile skill; file lives at travel/traveller-profile.md in the workspace). If one exists, load it and do not re-ask anything it already answers.

Open with quick-start templates so the traveller can anchor the trip in one tap, then ask only the gaps. Read ${CLAUDE_PLUGIN_ROOT}/skills/plan-trip/references/trip-templates.md for the template definitions and ${CLAUDE_PLUGIN_ROOT}/skills/plan-trip/references/interview-guide.md for the interview questions and ordering.

Keep the interview short: template, destination (if not given), dates or rough timing, party size, origin airport/city, total budget, and pace. Use AskUserQuestion with tappable options where available. Ask one focused round, not an interrogation — infer sensible defaults from the template and say what was assumed so the traveller can correct it.

Step 2 — Create the trip workspace

Create a folder per trip in the working directory:

travel/
├── traveller-profile.md        # optional, shared across trips
└── trips/<destination-yyyy-mm>/
    ├── trip-brief.md           # answers from the interview + template
    ├── itinerary.md            # the living day-by-day plan
    ├── budget.md               # running cost tracker
    ├── options/                # saved search results & comparisons
    └── checklists/             # packing list, pre-trip checklist

Write trip-brief.md immediately after the interview: destination, dates, party, origin, budget ceiling and currency, style, pace, must-dos, and anything to avoid. Every other skill reads this file, so keep it accurate and update it when the traveller changes their mind.

Once the destination is confirmed, offer one round of fun-facts — a couple of "did you know?" lines tailored to the trip's flavour. Keep it brief and skippable; this is a garnish, not a gate before searching begins.

Step 3 — Search in the right order

Search using the official connectors, delegating to the specialised skills:

  1. Flights first (find-flights skill — Kiwi.com, Ryanair) because flight times anchor arrival/departure days.
  2. Stays second (find-stays skill — Booking.com, Super.com) once dates are firm.
  3. Activities third (find-activities skill — Viator, Veltra Activities, Super.com, AllTrails) to fill the days.
  4. Dining as wanted (find-dining skill — Resy, Tripadvisor) for must-book restaurants; casual meals stay as itinerary suggestions.

Present comparison tables for each category (see the individual skills for formats), record the traveller's picks in trip-brief.md, and log every chosen price in budget.md via the trip-budget skill.

If a connector is unavailable or returns nothing, say so plainly, fall back to web search for guidance, and clearly mark anything not live-priced as an estimate.

Step 4 — Build and refine the itinerary

Hand over to the manage-itinerary skill to draft itinerary.md and refine it in conversation. Keep the day-by-day plan realistic: respect opening hours, travel time between places, jet lag on day one, and the traveller's stated pace.

Before finalising, check the trip-weather skill for the travel dates — a live forecast if they fall within the connector's horizon, otherwise seasonal norms — so rainy-day backups and pacing account for real conditions rather than being generic.

Business trip mode

When the trip is for work (template, phrasing, or a conference/meeting is mentioned), the plan inverts: commitments anchor everything else.

  • Get the fixed points first — meeting or conference dates, times and venue addresses — before searching anything.
  • Flights are chosen for schedule reliability and arrival buffers (arrive the evening before a morning meeting), not lowest price; stays are chosen for distance to the venue, workspace and Wi-Fi; use loyalty programmes from the traveller profile or Otto Travel.
  • Ask about company constraints: a per-night or total policy cap, preferred airlines/chains, and whether receipts matter — if so, have trip-budget keep an itemised, expense-report-friendly log.
  • Offer sync-calendar early, not at the end — business travellers live in their calendar.
  • Ask once whether to bolt on leisure ("bleisure"): extend the stay a day or two and plan the free evenings with find-activities and find-dining (client dinners via Resy are find-dining's job too).

Step 5 — Wrap up

Once the plan settles, proactively offer (do not force):

  • Budget summary vs the ceiling (trip-budget)
  • Packing list and pre-trip checklist (trip-checklists)
  • A polished Word/PDF itinerary to download (export-itinerary)
  • Putting the trip in Google Calendar (sync-calendar)
  • Saving preferences for next time (traveller-profile)

Mention once that Travel Concierge stays useful during the trip: same-day plans, rides, tables, delivery and replanning are handled by the on-trip-concierge skill in the same workspace.

Principles

  • Never claim a price, availability or schedule is confirmed unless it came from a connector result in this session; label estimates as estimates.
  • Searching and comparing is the job — actual booking happens on the provider's site; link the traveller there.
  • Respect the budget ceiling: warn as soon as committed costs pass 80% of it.
  • One clear recommendation plus alternatives beats a wall of options.

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.