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

examples/fixtures/substops.plan.geo.json

View on GitHub
{
 "_fixture": "Regression fixture for the optional plan fields: timeline-row sub_stops / view / must / tour / confirmed / link / sub_map and hours, a day's decision_points, stops[].driver, prefs.must_see, meta.review behind the review clause, brief.driving's labelled lines and hotels[].options[].checkout / bag_hold (all defined in references/output-template.md; the driving card in references/phase-1-brief.md §Driving card, the review in references/phase-6-assemble.md §Independent review). Invented two-day plan, not advice; renderable as is. Day 2 is a self-drive day — its hop row drives a rental and its arriving stop carries driver: self — which is why the plan carries brief.driving, the review clause in meta.self_check and the last decisions[] row, and meta.review with a driving lens. Expected: scripts/plan_lint.py exits 0 (two WARNs: no gates .ics, no trip.kml); --strict exits 18 (no .ics / .kml, no sun, missing cards, no ladder — not under test). Every link, sub_map and day_map here was written by scripts/route_tools.py links --write; re-running it must leave the file byte-identical. Day 1 has one stop (sub-stop links still written), day 2 has a hop row that must keep its own driving link. The bad/ folder holds one known-bad plan per default-mode lint rule, each with its expected result in _expect; strict/ holds the --strict-only cases beside the clean plan they vary.",
 "trip": "Fixture — sub-stops, 2 days",
 "lang": "en",
 "tz": "Asia/Tokyo",
 "prefs": {
  "travel_style": "mixed",
  "must_see": [
   {
    "name": "Fushimi Inari",
    "view": "the whole city from above"
   },
   {
    "name": "Bamboo grove"
   }
  ]
 },
 "meta": {
  "dates": "2026-11-10 → 2026-11-11",
  "party": "2 adults",
  "route": "Kyoto",
  "budget_total": "n/a — fixture, no prices",
  "generated": "2026-10-02",
  "self_check": "self-checked: 0 issues found and fixed · independent review: 1 confirmed, 0 refuted",
  "review": {
   "mode": "reviewers",
   "lenses": [
    {
     "lens": "driving",
     "note": "day 2 rental: licence legality and the desks' policy re-read against the card's sources (https://example.org/licensing)"
    },
    {
     "lens": "timing",
     "note": "day 1 walk start against the first train; day 2 car-park opening against the 08:45 arrival"
    },
    {
     "lens": "rules",
     "note": "the operator's written confirmation of the gorge lookout re-read against its terms"
    }
   ],
   "confirmed": [
    "day 2 arrival moved to 08:45 — the car park opens at 08:30, not 08:00 (fixed)"
   ],
   "refuted": []
  }
 },
 "decisions": [
  "Day 1 is a guided half-day walk; the operator confirmed the gorge lookout in writing before booking",
  "Day 2 is self-drive: the traveller chose the rental over the train after both were priced",
  "self-checked: 0 issues found and fixed · independent review: 1 confirmed, 0 refuted"
 ],
 "checklist": [
  {
   "item": "Guided walk: ask in writing whether the group climbs to the gorge lookout",
   "deadline": "2026-10-20",
   "note": "answered in writing 2026-10-15 — yes, 20 min at the deck"
  }
 ],
 "days": [
  {
   "date": "2026-11-10",
   "city": "Kyoto",
   "label": "Arashiyama, guided",
   "decision_points": [
    {
     "t": "07:30",
     "what": "go / no-go for the gorge lookout climb",
     "check": "rain radar and the river level in the operator's morning message",
     "if_no": "bamboo grove only; the lookout moves to day 2 after the shrine",
     "by": "the operator moves the walk free until 08:00 · booking terms"
    }
   ],
   "timeline": [
    {
     "t": "09:00-12:30",
     "what": "Arashiyama guided half-day walk",
     "kind": "anchor",
     "tag": "pinned",
     "tour": true,
     "hours": "open access",
     "note": "meeting point: the bridge's north end",
     "sub_stops": [
      {
       "name": "Bamboo grove path",
       "query": "Arashiyama Bamboo Grove, Kyoto, Japan",
       "view": "eye level along the bamboo path",
       "stand": "the path's upper bend, facing uphill",
       "link": "https://www.google.com/maps/search/?api=1&query=Arashiyama+Bamboo+Grove%2C+Kyoto%2C+Japan"
      },
      {
       "name": "Gorge lookout",
       "query": "Kameyama Park, Arashiyama, Kyoto, Japan",
       "view": "overlook of the gorge from the deck",
       "stand": "the hilltop deck, facing up the river gorge",
       "walk_min": 15,
       "must": true,
       "confirmed": "in writing · 2026-10-15 · operator email",
       "link": "https://www.google.com/maps/search/?api=1&query=Kameyama+Park%2C+Arashiyama%2C+Kyoto%2C+Japan"
      }
     ],
     "sub_map": "https://www.google.com/maps/dir/?api=1&origin=Arashiyama+Bamboo+Grove%2C+Kyoto%2C+Japan&destination=Kameyama+Park%2C+Arashiyama%2C+Kyoto%2C+Japan&travelmode=walking"
    },
    {
     "t": "12:30-13:30",
     "what": "lunch near the station",
     "kind": "meal",
     "tag": "swap→riverside stalls"
    }
   ],
   "stops": [
    {
     "name": "Togetsukyo Bridge",
     "query": "Togetsukyo Bridge, Kyoto, Japan",
     "lat": 35.0129,
     "lon": 135.6777
    }
   ]
  },
  {
   "date": "2026-11-11",
   "city": "Kyoto",
   "label": "Fushimi Inari, self-drive",
   "decision_points": [
    {
     "t": "19:00",
     "what": "rental or train for Fushimi Inari",
     "check": "the morning forecast and the road-closure notice for the hill road",
     "if_no": "train — the hop row and the car park drop, the rental is cancelled free",
     "by": "free cancellation until 20:00 the evening before · rental terms",
     "src": "https://example.org/road-notices",
     "date": "2026-11-10"
    }
   ],
   "timeline": [
    {
     "t": "08:15-08:45",
     "what": "drive (rental) Kyoto Station → Fushimi Inari car park",
     "kind": "hop",
     "verify": "est",
     "link": "https://www.google.com/maps/dir/?api=1&origin=34.985800%2C135.758800&destination=34.967100%2C135.772700&travelmode=driving"
    },
    {
     "t": "08:45-11:30",
     "what": "Fushimi Inari Taisha",
     "kind": "anchor",
     "tag": "opener",
     "hours": {
      "text": "grounds open 24 h · car park 08:30-17:00",
      "as_of": "2026-10-02",
      "src": "https://example.org/fushimi-inari-hours"
     },
     "sub_stops": [
      {
       "name": "Tower gate",
       "query": "Romon Gate, Fushimi Inari Taisha, Kyoto, Japan",
       "lat": 34.9671,
       "lon": 135.7727,
       "view": "the classic front view of the gate",
       "stand": "the forecourt steps, facing the gate",
       "link": "https://www.google.com/maps/search/?api=1&query=34.967100%2C135.772700"
      },
      {
       "name": "Thousand gates",
       "query": "Senbon Torii, Fushimi Inari Taisha, Kyoto, Japan",
       "view": "the twin tunnels of gates, side by side",
       "stand": "where the twin tunnels split, facing uphill",
       "walk_min": 5,
       "link": "https://www.google.com/maps/search/?api=1&query=Senbon+Torii%2C+Fushimi+Inari+Taisha%2C+Kyoto%2C+Japan"
      },
      {
       "name": "Crossroads lookout",
       "query": "Yotsutsuji Intersection, Fushimi Inari, Kyoto, Japan",
       "view": "overlook of the city from the crossroads terrace",
       "stand": "the terrace rail, facing west over the city",
       "walk_min": 35,
       "must": true,
       "link": "https://www.google.com/maps/search/?api=1&query=Yotsutsuji+Intersection%2C+Fushimi+Inari%2C+Kyoto%2C+Japan"
      }
     ],
     "sub_map": "https://www.google.com/maps/dir/?api=1&origin=34.967100%2C135.772700&destination=Yotsutsuji+Intersection%2C+Fushimi+Inari%2C+Kyoto%2C+Japan&travelmode=walking&waypoints=Senbon+Torii%2C+Fushimi+Inari+Taisha%2C+Kyoto%2C+Japan"
    }
   ],
   "stops": [
    {
     "name": "Kyoto Station",
     "query": "Kyoto Station, Japan",
     "lat": 34.9858,
     "lon": 135.7588
    },
    {
     "name": "Fushimi Inari Taisha",
     "query": "Fushimi Inari Taisha, Kyoto, Japan",
     "lat": 34.9671,
     "lon": 135.7727,
     "mode": "drive",
     "driver": "self"
    }
   ],
   "day_map": "https://www.google.com/maps/dir/?api=1&origin=34.985800%2C135.758800&destination=34.967100%2C135.772700&travelmode=walking"
  }
 ],
 "hotels": [
  {
   "base": "Kyoto 2 nights",
   "area": "station north",
   "why": "fixture — one line",
   "options": [
    {
     "name": "Property 1",
     "band": "n/a — fixture",
     "checkout": "11:00 · property FAQ · as of 2026-10",
     "bag_hold": "held at the desk until 18:00 · ask at check-in"
    }
   ]
  }
 ],
 "brief": {
  "visa": "fixture card — content is not under test",
  "safety": "fixture card — content is not under test",
  "weather": "fixture card — content is not under test",
  "driving": "Example Prefecture · country-A licence — Legality: legal with IDP · desks: both station brands rent on it with the IDP · fixture source · as of 2026-10\nExample Island · country-A licence — legality: legal with official translation · rentals: the airport desk wants the translation on paper · fixture source · as of 2026-10\n示例县 · B国驾照 — 合法性:合法 · 租车柜台:两家都租 · 县交通部门页面 · 截至2026-10\n示例岛 · A国驾照 — 合法性: legal with IDP · 租车柜台:两家都租 · 岛交通局页面 · 截至2026-10\nInsurance: the rental waiver covers a named second driver only · fixture"
 }
}
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