AGENT SKILL

plan-trip

Guided trip planning workflow. Asks destination, dates, travelers, class, and flexibility, then runs parallel flight/hotel search with cpp math and booking plan.

License 许可
MIT
最近更新
2026-11-09
Stars
★ 978
Forks
120

01 前言 Front Matter

name
plan-trip
license
MIT
summary
Guided trip planner. The hero command for the toolkit.
category
orchestration
description
Guided trip planning workflow. Asks destination, dates, travelers, class, and flexibility, then runs parallel flight/hotel search with cpp math and booking plan.
disable-model-invocation
true

03 SKILL.md 正文

Plan Trip Skill

The user invoked this skill explicitly. Run a guided trip planning workflow that produces a concrete, opinionated recommendation with cents-per-point math, transfer paths, and a booking plan.

How to run this

If the user already gave details in their prompt arguments, use those. Otherwise, ask in this order, one question at a time. Don't fire all the questions at once.

  1. Where? Destination(s). Accept regions ("Scandinavia"), cities ("Tokyo"), or specific airports.
  2. When? Departure month or date range. Note flexibility: "exact dates" vs "any week in March" matters a lot for award availability.
  3. Who? Number of travelers, ages if children/infants. The toolkit supports infant pricing and seat configurations.
  4. What class? Economy / premium economy / business / first. Default to economy if unstated.
  5. Trip length? Number of nights at destination if applicable.
  6. Points or cash? Three valid answers: "best of both" (default), "points only" (treat cash as last resort), "cash only" (skip award search).

After question 6, confirm the plan back to the user in one sentence and start the workflow.

The workflow

Once you have the inputs:

  1. Load lessons-learned first. Non-optional. Other skills depend on it.
  2. Load flight-search-strategy for the canonical parallel search plan.
  3. Pull balances via the awardwallet skill if the user's intent is points or "best of both" AND if balances aren't already in this session's context. Skip the pull if you already know them.
  4. Run cash search in parallel via duffel, ignav, google-flights, and the relevant free MCPs (Skiplagged, Kiwi).
  5. Run award search in parallel via seats-aero across ALL programs (never filter to one program upfront — see lessons-learned).
  6. Cross-reference with transfer-partners and transfer-bonuses to find the cheapest currency you actually have.
  7. Apply points-valuations to compute cents-per-point on each award option.
  8. Surface anything from award-sweet-spots that matches this route.
  9. Check stopovers if the destination involves a connection. Multi-city trips might unlock "two destinations for the price of one" via Aeroplan, Alaska, or Flying Blue.
  10. Show the math in a markdown table. One row per option, ranked. Columns: program, miles cost, cash co-pay, total $ value, cpp, hold-before-transfer rule, recommendation.
  11. Pick a winner with one-sentence reasoning.
  12. Show booking next steps via booking-guidance: which program to call, hold rules, transfer timing, phone numbers if needed.

Hotels and ground transit

If the trip is more than just flights, mention these as available next steps in your closing summary (not as a question):

  • Hotels via compare-hotels (FHR/THC/Edit/Booking/Trivago/Airbnb/TaW)
  • Stopover side trips via stopovers + the relevant transit skill (scandinavia-transit for Norway/Sweden/Denmark, deutsche-bahn for Germany / Austria / Switzerland / Netherlands / France / Belgium)
  • Atlas Obscura suggestions for unique places at the destination
  • Airport route sanity check via wikipedia-airports if the user asks about an obscure carrier or regional service

Don't dump all of these at once. Lead with the flight recommendation. Mention hotels/activities as concrete follow-up actions the user can ask for next.

Output style

  • Markdown tables for results
  • Bold the winning option
  • Always show cpp on award redemptions
  • Cite the source skill for each piece of data ("via seats-aero", "via awardwallet")
  • End with a "Next steps" section listing concrete follow-up commands the user can issue. Examples: "Next steps: I can check specific dates around X, search hotels at Y, look up sweet-spot redemptions you're not using." This must be a declarative statement, NOT a question. Don't write "Want me to..." or "Should I..." (the system prompt's PRE-OUTPUT GATE bans those patterns).

Don't do this

  • Don't dump 12 options. Pick 3-5 and rank.
  • Don't assume the user has every API key. If a key is missing, say so and tell them what's still searchable. Cash flights work without any keys at all.
  • Don't transfer points speculatively. The booking-guidance skill enforces "hold before transfer" rules. Respect them.

04 同仓库更多 Skills

borski
borski/travel-hacking-toolkit

wikipedia-airports

Discover destinations served from any airport via Wikipedia. Sanity-check whether an airline flies a specific route, find regional service that fare tools miss, identify late-split-return airport options.

★ 978
borski
borski/travel-hacking-toolkit

wheretocredit

Mileage earning rates by airline and booking class via wheretocredit.com. Redeemable and qualifying miles across 50+ programs. Use when deciding where to credit a flight or comparing earning rates.

★ 978
borski
borski/travel-hacking-toolkit

vrbo

Search VRBO (Vrbo / Expedia Group) vacation rentals including entire homes, condos, and cabins via Patchright browser automation. VRBO sits behind Akamai Bot Manager so plain HTTP and standard Playwright get a 429 bot wall. Use for whole-home or group stays, multi-bedroom rentals, and Airbnb-vs-VRBO comparisons. Trigger phrases include search VRBO, Vrbo rentals, vacation rental, cabin rental, whole house, condo for the group.

★ 978
borski
borski/travel-hacking-toolkit

tripadvisor

TripAdvisor Content API for hotel ratings, restaurant search, attraction reviews, rankings, and nearby locations. Use when evaluating hotels or researching destinations. 5K calls/month.

★ 978
borski
borski/travel-hacking-toolkit

trip-planner

Full trip planning orchestration. Combines flight search, hotel search, and points optimization into one cost analysis. Use when the user says "plan a trip" or wants the complete picture for a destination.

★ 978
borski
borski/travel-hacking-toolkit

trip-log

Save flight searches, itineraries, and booked trips to the trips/logs/ directory for future reference. OPT-IN — use when the user asks to log a trip or look up past searches, or on every search only if the user has said they want automatic logging. Also use to update status when a trip is booked or completed.

★ 978