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

assets/plan.example.json

View on GitHub
{
 "_readme": "Runnable schema example — copy it to plan.geo.json, replace everything, keep the shape. The .geo stem matters: geocode then edits the file in place, so check/links/kml/render all read one file. The same file feeds scripts/route_tools.py (days[].stops) and scripts/render_plan.py (everything else). INVARIANT: days[].stops mirrors that day's anchors + modelled strolls in visit order — the maps and the walking total are computed from it. Two stops deliberately ship without lat/lon so `check` reports them and exits 2 until you run `geocode`; that is the intended first step, not a defect. All prices, hours and links are PLACEHOLDERS: never ship them unverified. tz: optional IANA zone — top-level default, days[].tz overrides; a plan that crosses zones stamps tz on every day before sun --write. lang: top-level \"zh\"|\"en\" — always write it; absent silently defaults to zh, wrong for every en plan. Every renderer and route_tools sun read it (--lang overrides); prefs has no lang field.",
 "_readme_triggered": "Shapes that appear only when their trigger does — absent from this file on purpose, never written as empty keys: brief.driving + prefs.drivers (a self-drive option exists — phase-1-brief.md §Driving card) · prefs.languages (a guided option may be priced) · prefs.must_see (the traveller named must-sees; an entry with a view needs a must: true sub-stop with a view and a stand) · tour: true on a row + confirmed on its must sub-stops (a guided tour owns the block) · stops[].driver ∈ self | hired | taxi | tour on the drive stops of a day someone drives · days[].decision_points (a go / no-go call on the day or the evening before — route_tools.py ics writes its event) · refundable: false on a checklist or legs row (a non-refundable booking or fare) · 'On-trip re-audit · D+N' checklist rows (a trip of seven days or more) · a 'Before leaving <country>' checklist row (the traveller keeps the local number; deadline the day before the last departure from that country, after the on-trip rows) · '· independent review: …' after the self-check line + meta.review behind it (a self-drive option, a non-refundable booking or a timed check-in — the lint sees the machine-readable part: the self-drive set, refundable: false, tour: true; a timed check-in without a tour block stays procedure-only). Each is defined in references/output-template.md, except the driving card (references/phase-1-brief.md §Driving card) and the review clause (references/phase-6-assemble.md §Independent review); plan_lint.py checks the ones it can.",
 "_readme_prefs": "prefs = what Phase 0 (Intake) learned or assumed, written down once so Phases 2-6 and any later replan read one place instead of re-asking. Enums: theme ∈ illustrated|clay|noir|glass|journal|zine|splash|portal (default illustrated) · pictures ∈ native|key|stock (the picture-capability check: own generator | themes/.auth_header | built-in stock kit) · travel_style ∈ public|self-drive|group-tour|mixed · scenery ⊂ nature|city|beach|forest|lake|mountain · pace = anchors per day (2/3/4) · lodging and budget are free text · notes = every inferred value, so the assumptions block at checkpoint (a) can be written from this one object. Every renderer IGNORES prefs (it is not in theme_common.PLAN_SHAPE) — the block is for the planning agent, not for the page. · drivers = [{who, licence_country (ISO2 of the country that issued the licence)}], present when a self-drive option exists — brief.driving checks each one and plan_lint then requires that card · languages = the language codes the party can follow spoken commentary in, present when a guided option may be priced · must_see = [{name, view?}], the must-sees as the traveller named them, view (free text: the picture the traveller came for) only when the draw is a picture (output-template.md §Intake prefs)",
 "trip": "Example trip — 2 days",
 "lang": "zh",
 "tz": "Asia/Tokyo",
 "prefs": {
  "theme": "illustrated",
  "pictures": "stock",
  "travel_style": "public",
  "lodging": "hotel · mid-range, refundable",
  "scenery": ["city", "nature"],
  "pace": 3,
  "budget": "mid",
  "notes": "assumed origin PVG (zh request, no origin given)"
 },
 "meta": {
  "dates": "2026-10-05 → 2026-10-07",
  "party": "1 adult",
  "route": "City A → City B",
  "budget_total": "PLACEHOLDER",
  "fx": "1 CNY = 23.73 JPY (ECB via frankfurter.dev, 2026-07-31)",
  "generated": "2026-08-01",
  "self_check": "自检: 发现并修复 N 处"
 },
 "decisions": [
  "One line per decision you made on the traveller's behalf — each one vetoable"
 ],
 "checklist": [
  {"item": "Travel-clinic consult (vaccines / prophylaxis per the health page)",
   "deadline": "departure minus 4-6 weeks (NOW if inside 6 weeks) · PLACEHOLDER date",
   "note": "PLACEHOLDER — agenda: the page's 'recommended for most / some travellers' rows + activity tags; the plan never doses"},
  {"item": "Timed-entry ticket X", "deadline": "opens 10th of prior month",
   "price": "PLACEHOLDER", "link": "https://example.org/tickets",
   "note": "sells out same day"},
  {"item": "T-14 re-check: hours + fees of every anchor, advisory level, visa rule",
   "deadline": "T-14 · PLACEHOLDER date",
   "note": "PLACEHOLDER — the anchors and legs[] numbers this T-14 row covers"},
  {"item": "T-7 re-check: forecast for every base, re-apply weather rule 10",
   "deadline": "T-7 · PLACEHOLDER date",
   "note": "PLACEHOLDER — the bases whose forecast this T-7 row re-runs"},
  {"item": "T-3 re-check: strikes / closures on the route, forecast, tickets in wallet, hours of every anchor up to T-3+14 re-read",
   "deadline": "T-3 · PLACEHOLDER date", "note": "PLACEHOLDER — one line per moving day: operator + transit-notice URL"},
  {"item": "T-1: eSIM live + home-number SMS, copies, cash per brief.money, cards unblocked",
   "deadline": "T-1 · PLACEHOLDER date", "note": "PLACEHOLDER — eSIM provider · cash figure from brief.money · cards to unblock"}
 ],
 "legs": [
  {"type": "international flight", "date": "2026-10-05", "carrier": "PLACEHOLDER",
   "from": "AAA", "to": "BBB", "dep": "18:20", "arr": "next day 13:40",
   "price": "PLACEHOLDER", "bags": "23 kg included",
   "link": "https://www.google.com/travel/flights", "backup": "second-best option"}
 ],
 "days": [
  {"date": "2026-10-05", "tz": "Asia/Tokyo", "city": "Kyoto", "label": "East Kyoto",
   "sun": "天亮 05:28 · ☀ 05:53 / 🌇 17:38 · JST · sunrise-sunset.org",
   "walking_km": {"total": 5.4,
                  "how": "on foot 1.7 ×1.3 + 散步 1.5 + 馆内 ~1.7"},
   "ribbon": "Anchor 1 →步行10′→ Anchor 2 →步行8′→ lunch →巴士25′→ Anchor 3 →步行→ stroll",
   "day_map": "PLACEHOLDER — the DAY CHAIN url from route_tools links",
   "rain_alt": "indoor alternative — closure-checked for THIS date",
   "late_cut": "running >1 h late → cut the stroll, then Anchor 2",
   "timeline": [
    {"t": "08:00-09:15", "what": "Anchor 1", "kind": "anchor", "price": "PLACEHOLDER",
     "note": "opens 06:00, first hour is empty", "tag": "opener",
     "sub_stops": [
      {"name": "Viewpoint A", "query": "Okunoin, Kiyomizu-dera, Kyoto, Japan",
       "view": "the whole stage from the far terrace", "stand": "where to stand · which way to face", "walk_min": 3,
       "must": true,
       "link": "https://www.google.com/maps/search/?api=1&query=Okunoin%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan"},
      {"name": "Viewpoint B", "query": "Otowa Waterfall, Kiyomizu-dera, Kyoto, Japan",
       "view": "from below, under the wooden stage", "stand": "where to stand · which way to face", "walk_min": 4,
       "link": "https://www.google.com/maps/search/?api=1&query=Otowa+Waterfall%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan"}],
     "sub_map": "https://www.google.com/maps/dir/?api=1&origin=Okunoin%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan&destination=Otowa+Waterfall%2C+Kiyomizu-dera%2C+Kyoto%2C+Japan&travelmode=walking"},
    {"t": "09:15-09:45", "what": "步行 Anchor 1→Anchor 2 0.7 km · 10分(+缓冲)",
     "kind": "hop", "verify": "est",
     "link": "PLACEHOLDER — per-hop url from route_tools links"},
    {"t": "09:45-10:45", "what": "Anchor 2", "kind": "anchor", "price": "PLACEHOLDER",
     "hours": {"text": "09:00-17:30 · last entry 17:00", "as_of": "2026-08-01",
               "src": "https://example.org/anchor-2-hours"}},
    {"t": "10:45-11:00", "what": "步行 Anchor 2→lunch area 0.5 km · 8分", "kind": "hop",
     "verify": "est", "link": "PLACEHOLDER"},
    {"t": "11:00-12:15", "what": "lunch · food area, not a named restaurant",
     "kind": "meal", "tag": "swap→second food area"},
    {"t": "12:15-13:00",
     "what": "巴士 203(往銀閣寺道) ~25分 ¥230 · 祇園→銀閣寺道 · 下车步行8分",
     "kind": "hop", "verify": "est", "link": "PLACEHOLDER"},
    {"t": "13:00-14:30", "what": "Anchor 3", "kind": "anchor", "price": "PLACEHOLDER"},
    {"t": "14:30-14:40", "what": "步行 Anchor 3→stroll start 0.6 km · 10分",
     "kind": "hop", "verify": "est", "link": "PLACEHOLDER"},
    {"t": "14:40-15:40", "what": "stroll ~1.5 km — modelled as a stop so it counts",
     "kind": "free", "tag": "skippable"}
   ],
   "stops": [
    {"name": "Anchor 1", "query": "Kiyomizu-dera, Kyoto, Japan",
     "lat": 34.994303, "lon": 135.784439},
    {"name": "Anchor 2", "query": "Kodai-ji, Kyoto, Japan"},
    {"name": "lunch area", "query": "八坂神社, 京都市東山区"},
    {"name": "Anchor 3", "lat": 35.0269, "lon": 135.7984, "mode": "transit"},
    {"name": "stroll midpoint", "lat": 35.0227, "lon": 135.7949}
   ]},
  {"date": "2026-10-06", "city": "Kyoto → Osaka", "label": "移动日",
   "travel_day": true,
   "late_cut": "bags not stored → drop the single anchor",
   "timeline": [
    {"t": "08:00-09:00",
     "what": "checkout · bags to station lockers (fallback: hotel storage + loop back)",
     "kind": "free", "note": "large lockers gone by mid-morning in peak season",
     "tag": "pinned"},
    {"t": "09:15-11:31", "what": "特急/新干线 (往…方向) · A→B · 出口N", "kind": "hop",
     "verify": "verified", "note": "verified timetable keeps its exact minutes",
     "link": "PLACEHOLDER"},
    {"t": "15:00", "what": "check-in — a move day carries ≤2 anchors only if bags are handled before the first; otherwise 1",
     "kind": "free", "tag": "pinned"}
   ],
   "stops": []}
 ],
 "hotels": [
  {"base": "Kyoto 3 nights", "area": "neighborhood name",
   "why": "on the line you actually use · safe after dark · flat pavement for luggage",
   "options": [
    {"name": "Property 1", "band": "PLACEHOLDER/night",
     "link": "https://www.booking.com/searchresults.html?ss=Kyoto&checkin=2026-10-05&checkout=2026-10-08",
     "checkout": "11:00 · property FAQ · as of 2026-08",
     "bag_hold": "held at the desk until 18:00 · ask at check-in"}
   ]}
 ],
 "budget": [
  {"cat": "flights", "per_person": "PLACEHOLDER", "total": "PLACEHOLDER",
   "note": "as of 2026-08-01"},
  {"cat": "buffer (10-15%)", "per_person": "PLACEHOLDER", "total": "PLACEHOLDER",
   "note": "FX drift + price moves"}
 ],
 "brief": {
  "visa": "type · fee · processing days · passport-validity rule",
  "emergency": "six lines: local police / ambulance / fire · home consular hotline · nearest mission per base · insurer assistance line + policy no. · lost-passport steps · 24h ER + pharmacy per base — every number as-of",
  "safety": "line 0 advisory level · source · as-of, then six lines: named scams · pickpocket hotspots · taxi rule · after-dark avoid list per base · what to do when it happens · legal red lines",
  "health": "five lines from one CDC / TravelHealthPro page: vaccines + consult date · vector-borne season · water and food · rabies · notice level + as-of",
  "holidays": "collisions from date.nager.at + local festivals",
  "weather": "temps · rain odds · daylight · mode (forecast / normals) + as-of",
  "money": "five lines: refuse DCC · card FX fee → buffer · ATM fee and cap · cash number · which cards and wallets work (+ origin block)",
  "connectivity": "eSIM ballpark · plug type · digital-safety line",
  "insurance": "cover floor · exclusions matched by activity name · assistance hotline"
 },
 "unverified": [
  "everything that survived two searches unverified goes here, visibly"
 ]
}
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