Skip to content

skywain/trip-planner-skill

trip-planner

Unverified

End-to-end international trip planning: turns "I want to go to X for N days" into a verified, bookable plan — route skeleton across cities, flight price scans (international + domestic legs), train-vs-fly decisions, hour-by-hour daily timelines with opening hours, dwell times, holiday collisions and tappable turn-by-turn map links (小时级行程+地图导航+离线KML), hotel shortlists by neighborhood, budget rollup, and a booking checklist with deep links. Use this whenever the user asks to plan a trip, vacation, itinerary or honeymoon, compare flight dates/prices, pick between cities or routes, schedule a travel day hour by hour, fill a spare block of time ("I'm near X with 2 free hours"), turn a finished plan into a designed page (eight themed renders: illustrated / clay / noir / glass / journal / zine / splash / portal — 插画/黏土/夜航/玻璃/手账/Zine/闪屏/穿越版), or asks 旅行规划/行程安排/机票比价/去某国玩N天怎么安排/现在有空档干嘛/把行程做成好看的网页 — even if they only mention one piece (just flights, just hotels, or just navigation), the playbook and verification rules here still apply.

FileKindSize
SKILL.mdskill md32.9 KB
assets/plan.example.jsonconfig12.1 KB
examples/README.mdmarkdown13.0 KB
examples/china-2026/china-splash.htmlother937.1 KB
examples/china-2026/china.art.jsonconfig6.4 KB
examples/china-2026/china.geo.jsonconfig58.3 KB
examples/fixtures/bad/bracketed-note.geo.jsonconfig7.8 KB
examples/fixtures/bad/brief-card-not-text.geo.jsonconfig943 B
examples/fixtures/bad/decision-point-date-two-days-before.geo.jsonconfig848 B
examples/fixtures/bad/decision-point-day-date-not-iso.geo.jsonconfig7.8 KB
examples/fixtures/bad/decision-point-no-if-no.geo.jsonconfig715 B
examples/fixtures/bad/decision-point-same-what.geo.jsonconfig8.2 KB
examples/fixtures/bad/decision-point-src-not-http.geo.jsonconfig803 B
examples/fixtures/bad/decision-point-t-not-hhmm.geo.jsonconfig764 B
examples/fixtures/bad/decision-points-null.geo.jsonconfig594 B
examples/fixtures/bad/driver-enum.geo.jsonconfig711 B
examples/fixtures/bad/driver-self-no-driving-card.geo.jsonconfig736 B
examples/fixtures/bad/driving-card-no-as-of.geo.jsonconfig861 B
examples/fixtures/bad/driving-card-no-desk.geo.jsonconfig800 B
examples/fixtures/bad/driving-card-no-legality-line.geo.jsonconfig811 B
examples/fixtures/bad/driving-card-no-verdict.geo.jsonconfig939 B
examples/fixtures/bad/driving-card-zh-verdict-trailing.geo.jsonconfig967 B
examples/fixtures/bad/hotel-checkout-null.geo.jsonconfig786 B
examples/fixtures/bad/hours-as-of-not-date.geo.jsonconfig674 B
examples/fixtures/bad/hours-bare-string.geo.jsonconfig655 B
examples/fixtures/bad/hours-src-not-http.geo.jsonconfig662 B
examples/fixtures/bad/hours-text-empty.geo.jsonconfig647 B
examples/fixtures/bad/kind-enum.geo.jsonconfig7.9 KB
examples/fixtures/bad/must-false.geo.jsonconfig914 B
examples/fixtures/bad/must-no-stand.geo.jsonconfig755 B
examples/fixtures/bad/must-no-view.geo.jsonconfig758 B
examples/fixtures/bad/must-not-boolean.geo.jsonconfig798 B
examples/fixtures/bad/must-see-unmatched.geo.jsonconfig963 B
examples/fixtures/bad/must-see-view-empty.geo.jsonconfig910 B
examples/fixtures/bad/pending-no-checklist-row.geo.jsonconfig1021 B
examples/fixtures/bad/refundable-not-boolean.geo.jsonconfig686 B
examples/fixtures/bad/rental-leg-no-driving-card.geo.jsonconfig829 B
examples/fixtures/bad/review-counts-disagree.geo.jsonconfig1.0 KB
examples/fixtures/bad/review-lens-enum.geo.jsonconfig1.1 KB
examples/fixtures/bad/review-no-driving-lens.geo.jsonconfig1.3 KB
examples/fixtures/bad/review-not-object.geo.jsonconfig611 B
examples/fixtures/bad/review-single-pass-with-counts.geo.jsonconfig1.0 KB
examples/fixtures/bad/review-two-lenses.geo.jsonconfig959 B
examples/fixtures/bad/self-drive-no-driving-card.geo.jsonconfig635 B
examples/fixtures/bad/sub-stop-no-name.geo.jsonconfig763 B
examples/fixtures/bad/sub-stop-no-query.geo.jsonconfig763 B
examples/fixtures/bad/sub-stops-null.geo.jsonconfig578 B
examples/fixtures/bad/tour-confirmed-prefix.geo.jsonconfig902 B
examples/fixtures/bad/tour-not-boolean.geo.jsonconfig562 B
examples/fixtures/bad/tour-on-day-object.geo.jsonconfig7.8 KB
examples/fixtures/bad/tour-unconfirmed.geo.jsonconfig837 B
examples/fixtures/strict/clean.plan.geo.jsonconfig4.5 KB
examples/fixtures/strict/hours-as-of-after-asof.geo.jsonconfig4.1 KB
examples/fixtures/strict/hours-missing-in-window.geo.jsonconfig4.0 KB
examples/fixtures/strict/hours-stale-as-of.geo.jsonconfig4.1 KB
examples/fixtures/strict/no-generated.geo.jsonconfig3.8 KB
examples/fixtures/strict/refundable-no-clause.geo.jsonconfig3.8 KB
examples/fixtures/strict/rows-without-clock-or-kind.geo.jsonconfig3.7 KB
examples/fixtures/strict/self-drive-not-legal-no-decision.geo.jsonconfig4.4 KB
examples/fixtures/strict/t-n-date-mismatch.geo.jsonconfig3.8 KB
examples/fixtures/strict/tour-no-review.geo.jsonconfig3.4 KB
examples/fixtures/substops.plan.geo.jsonconfig9.1 KB
examples/gates-sample.icsother11.5 KB
examples/japan-2026/japan-illustrated.htmlother1.4 MB
examples/japan-2026/japan.art.jsonconfig6.2 KB
examples/japan-2026/japan.geo.jsonconfig65.5 KB
examples/kyoto-sample.htmlother13.0 KB
examples/kyoto-sample.kmlother1012 B
examples/kyoto-sample.plan.geo.jsonconfig7.2 KB
examples/mexico-2026/mexico-journal.htmlother2.0 MB
examples/mexico-2026/mexico.art.jsonconfig9.4 KB
examples/mexico-2026/mexico.geo.jsonconfig77.1 KB
examples/morocco-2026/morocco-glass.htmlother1.3 MB
examples/morocco-2026/morocco-portal.htmlother13.8 KB
examples/morocco-2026/morocco.art.jsonconfig3.8 KB
examples/morocco-2026/morocco.geo.jsonconfig85.1 KB
examples/nordic-2026/nordic-noir.htmlother686.8 KB
examples/nordic-2026/nordic.art.jsonconfig8.7 KB
examples/nordic-2026/nordic.geo.jsonconfig58.5 KB
examples/turkey-2026/turkey-clay.htmlother1.3 MB
examples/turkey-2026/turkey.art.jsonconfig3.5 KB
examples/turkey-2026/turkey.geo.jsonconfig75.8 KB
examples/vietnam-2026/vietnam-zine.htmlother2.5 MB
examples/vietnam-2026/vietnam.art.jsonconfig10.8 KB
examples/vietnam-2026/vietnam.geo.jsonconfig85.1 KB
references/art-schema.mdmarkdown318 B
references/country-quick-notes.mdmarkdown58.6 KB
references/cover-titles.mdmarkdown10.6 KB
references/data-sources.mdmarkdown49.2 KB
references/navigation.mdmarkdown23.6 KB
references/output-template.mdmarkdown49.2 KB
references/phase-0-intake.mdmarkdown12.4 KB
references/phase-1-brief.mdmarkdown22.8 KB
references/phase-3-legs.mdmarkdown10.5 KB
references/phase-4-days.mdmarkdown13.6 KB
references/phase-6-assemble.mdmarkdown22.3 KB
references/scheduling.mdmarkdown28.8 KB
references/themes.mdmarkdown37.9 KB
scripts/build_site.pyscript47.8 KB
scripts/flight_scan.pyscript18.9 KB
scripts/plan_lint.pyscript58.4 KB
scripts/render_plan.pyscript28.2 KB
scripts/route_tools.pyscript90.0 KB

references/phase-3-legs.md

View on GitHub
# Phase 3 — Flights & intercity legs (the procedure)

Read this at the start of Phase 3, before the first flight scan. SKILL.md Phase 3 is the
contract — inputs, outputs, and the gates that decide pass/fail; this file is the whole
procedure it points at: the plan shape, international flights (price sources, airports,
separate tickets, LCC arithmetic), intercity rail vs fly, driving legs, and what every
leg row records.

Inputs: the chosen route skeleton (Phase 2), `prefs.travel_style`, the Phase 1 visa /
entry facts (transit countries included) and, for a car-first segment,
`prefs.languages` and `brief.driving`. Outputs: `legs[]` rows — one pick + one backup
per leg — the checklist rows for flights, date-locked rail and rentals, the budget rows
they imply, and the baggage walkthrough for multi-leg trips.

## Write to the plan shape

From here on you are writing `plan.geo.json`. **`assets/plan.example.json` is the single
source of truth for the plan's top-level shape** — `legs`, `checklist`, `budget`,
`hotels`, `brief`, `days[]`… — so open it (or output-template.md §Top-level plan
skeleton, copied from it) before writing a field. `budget` is a list of
`{cat, per_person, total, note}` rows, not `{note, rows}`; `legs` rows use
`from/to/dep/arr`. A wrong shape does not fail loudly: the renderers WARN and print an
empty section (they used to crash — the Vietnam test lost both themed pages to it).

## International

**International:**
- Run `scripts/flight_scan.py` (Google Flights data, keyless; `--help` for usage) to
  grid-scan the date window and both open-jaw directions. Fails twice → browser on
  Google Flights (URL recipes in data-sources.md); that blocked too → the second
  price source (Skyscanner / Kayak; on CN networks Trip.com/携程 is the primary and
  Google the backup); "price unverified" only when every source fails — §When
  things fail. **Every international pick and backup
  is priced in ≥ 2 sources** (Google + Skyscanner / Kayak / Trip.com / the carrier's
  site — data-sources.md §Flights → Second price source); `legs.note` names them
  with the as-of date, a > 10 % disagreement prints as a band. No browser pane →
  Google alone, and `legs.note` says "single source — no browser".
- Multi-airport cities: compare fare + ground transfer cost + time (HND vs NRT,
  LHR vs LGW/STN…). A ¥400-cheaper fare into a far airport often loses.
- Departing CN: also spot-check one LCC directly in the browser (Spring 春秋, Peach,
  Scoot…) — aggregators miss or misprice some LCC inventory.
- **Separate tickets across an international connection are a visa trap, not just
  a baggage nuisance** — audit whenever two PNRs meet at a foreign hub, including
  tickets the user bought before coming to you. Separate-journey policies tag bags
  only to the first ticket's endpoint, and carousels sit landside — so claiming +
  re-checking can REQUIRE entering the transit country. Before writing "no visa
  needed", check: the first carrier's separate-PNR interline stance (assume no
  through-check), the passport's transit-country visa need, and airside overnight
  options if the layover crosses a night. A needed transit visa goes on the
  checklist with its deadline counted back from the departure date.
- LCC arithmetic: add the checked-bag fee before comparing — a "cheap" fare + ¥280 bag
  usually isn't.

## Intercity within the destination

**Intercity within the destination:**
- Mode rule: rail wins under ~5 h station-to-station (city-center to city-center, no
  airport buffers); fly beyond that or across water; overnight options only for
  shoestring budgets.
- Price on the **operator's** site — resellers add fees. Country-quick-notes.md lists
  the operators and their booking-window rules (high-speed fares rise as buckets sell).

## Driving legs

**Driving legs (parks and car-first destinations):**
- A national park without a car is a bus-tour compromise — decide that explicitly with
  the user, never by default. The user sees it at checkpoint (a) as a pair priced
  all-in for the same days: **self-drive** (base + taxes + collision waiver /
  liability + fuel + one-way fee + park entry) against **the tour** (fare + nights the
  traveller books themselves + surcharges + tips — data-sources.md §Group tours, Price
  anatomy). Each side shows which must-see pictures it actually reaches
  (phase-4-days.md step 2); the tour side shows its commentary language against
  `prefs.languages` (data-sources.md §Group tours, Structure quirks to check); the
  self-drive side shows the two licence columns from
  `brief.driving` (phase-1-brief.md §Driving card), legality first. The own-language
  consensus line (phase-1-brief.md §Where the facts come from) sits beside the pair.
  A rental is its own leg, its `type` saying so ("car rental" / 租车 — a self-drive
  trigger, phase-1-brief.md §Driving card): pick-up/drop-off at airports, one-way drop
  fees noted, and the airport↔park drive budgeted honestly (Las Vegas→Grand Canyon
  South Rim ≈ 4.5 h, Salt Lake City→Moab ≈ 3.5-4 h — the map's "nearby airport" is
  half a day of driving).
- Record per driving leg: pick-up/drop point + counter hours, one-way drop fee,
  airport↔park drive time (budgeted honestly), car class (and whether it has CarPlay /
  Android Auto — navigation.md §Self-drive days), price +
  as-of date, insurance note, fuel estimate, park entrance fee (per **vehicle** in the
  US; 3+ parks → an annual pass wins — the $80 America the Beautiful is
  residents-only since 2026, non-residents take the $250 pass from the 2nd park,
  country notes §USA), and the licence's legal status and the desk's terms from
  `brief.driving`. **Rental tactics** go in the same record: price the class on the
  brand's site for the traveller's home market too ⚡ (country sites often bundle the
  waiver and liability for less than the destination rate plus counter add-ons); pay
  at the counter, not prepaid, while the drive decision is open; book the return a
  little late — the slack is free where early returns cost nothing (read the terms);
  skip prepaid fuel, toll packs where the route has no toll roads, and accident cover
  the traveller's insurance already gives; take the class locals actually rent on that
  terrain instead of assuming a compact. Price surfaces and what an inclusive rate
  must contain: data-sources.md §Car rental.
- **Every self-drive day carries a no-car fallback, worked out before anything is
  cancelled**: the bus or park shuttle, taxi and walking chain that still reaches the
  day's main anchor, with timetable (weekday grid included) and price — for a refused
  licence at the counter, a missing car, or a driver unfit to drive. When the drive
  goes ahead, a free-cancellation booking held against it (data-sources.md §Group
  tours, Reserve-now-pay-later) does not wait for its cutoff if no new information
  will arrive before it (the counter's answer comes only at pick-up): release it at a
  calm moment once the fallback is walked on the map, not at the last one.
- Gateway towns run out of cars and rooms in season — the rental and the first night
  go on the booking checklist, not the "later" pile.

## Record for every leg

**Record for every leg**: carrier, date, dep/arr local times, price + currency + as-of
date, **checked-bag fee** (US domestic: $35-45 per bag per one-way on every major
since Southwest ended free bags in 2025 — 4 legs is a real budget line; UA Basic
Economy is personal-item-only on domestic and short-haul Latin America routes,
while long-haul international Basic Economy does include the carry-on ⚡),
refund/change class, deep link. A non-refundable fare sets `"refundable": false` on
its legs row (shape: output-template.md §Top-level plan skeleton; it triggers the
independent review — phase-6-assemble.md §Independent review). Once booked,
`legs.note` says which reference does what: the carrier's **record locator** (usually
6 characters, on the e-ticket receipt) is what the carrier's app and check-in want —
an OTA's order number is not — and the 13-digit e-ticket number finds the receipt
after the trip; the codes themselves stay out of the rendered page. Multi-leg trips
get a
**baggage walkthrough**: where the big bag physically is on every tour/venue day
(day tours = bag stays at hotel; stadiums ban bags; 2-day tours are often
overnight-bag-only). Output 1 pick + 1 backup per leg. **A backup counts only if it
still reaches the leg's pinned dependency** (tour pickup, event, onward flight); when
none does, the leg is **must-catch** — `legs.note` says "no usable backup" and the plan
buys margin instead (arrive the day before, or take the earliest departure). The ground
run to a dawn must-catch goes by pre-booked car, with rail as the backup: early weekend
trains are the thinnest (live case: a Sunday-dawn commuter train cancelled outright, on
a non-refundable ticket).

## Exit criteria — tick every line before Phase 4

- [ ] `legs`, `budget`, `checklist` follow `assets/plan.example.json` shapes (budget is
      a list of rows; legs use from / to / dep / arr).
- [ ] Every international pick and backup is priced in ≥ 2 sources, `legs.note` names
      them with the as-of date (or says "single source — no browser"), a > 10 %
      disagreement prints as a band.
- [ ] The separate-tickets audit ran for every foreign hub where two PNRs meet — before
      "no visa needed" was written anywhere; a needed transit visa is on the checklist
      with its deadline.
- [ ] Every leg row: carrier · date · dep / arr local · price + currency + as-of ·
      checked-bag fee · refund / change class · deep link; a non-refundable fare
      carries `"refundable": false`; one pick + one backup that
      still reaches the pinned dependency (or "no usable backup" on a must-catch leg).
- [ ] A car-first segment went to the user as the all-in pair (self-drive vs tour,
      what each reaches, commentary language, licence legality) — decided with the
      user, never by default; headless, the days run on the legal option and the
      assumptions block shows both columns (phase-1-brief.md §Driving card step 4).
- [ ] Self-drive: the rental is its own leg with pick-up / drop-off, counter hours, car
      class, price + as-of, one-way drop fee, airport↔park drive time, insurance note,
      fuel, park fees, licence status from `brief.driving`; every self-drive day has
      its no-car fallback (timetable + price); the
      rental and the first gateway night are on the checklist.
- [ ] Multi-leg trips carry the baggage walkthrough (where the big bag is on every tour
      / venue day).
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall