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/cover-titles.md

View on GitHub
# Cover titles — bilingual poetic case library 封面标题案例库

For rendered deliverables (HTML cover pages, album covers). Pick, adapt, or use as a
quality bar for new coinages. Rules:

- **zh**: 2-6 characters, must survive as a huge serif display word. **en**: 1-5
  elegant words — a companion line, not a translation exercise. (Non-Chinese trip?
  The field roles and Latin budgets are in the section after the table.)
- Cite allusions honestly: classical/public-domain sources may be quoted; in-copyright
  contemporary prose may *inspire* but never be quoted. Mark original coinages 原创化用.
- Subtitle slot: the source line (原句) or the route list. A small credit (—— 作者)
  under the English line is the classiest way to explain an allusion.
- **Cliché blacklist** (never use): 说走就走 / 诗与远方 / 在路上(直接用) / 山在召唤 /
  远方的田野 / Wanderlust / Life is a journey.

| zh | en | 出处 | fits | 用法笔记 |
|---|---|---|---|---|
| 碧海苍梧 | Dawn Seas, Dusk Peaks | 徐霞客「大丈夫当朝碧海而暮苍梧」 | coast+mountain | 旅行文学第一人的志向;副题用原句「朝碧海,暮苍梧」;碧/苍色字自带画意 |
| 江入大荒 | Into the Vast | 李白《渡荆门送别》 | road-trip | 「入」自带单程行进感;大荒=美国西部尺度;副题接「山随平野尽」 |
| 落日熔金 | Molten Gold | 李清照《永遇乐》 | island+coast | 双关熔岩与海上落日;自带金橙×暮紫配色方案;火山行程首选 |
| 天接云涛 | Sea of Clouds | 李清照《渔家傲》 | coast+mixed | 越洋舷窗云海即视感;副题「星河欲转千帆舞」;已用:北欧 noir、土耳其插画(SEA OF CLOUDS AT DAYBREAK)、意大利 portal |
| 九万里风 | Ninety Thousand Miles of Wind | 李清照《渔家傲》化用《庄子》 | island+mixed | 「蓬舟吹取三山去」——三山恰对夏威夷大岛三火山,极雅;已用:澳洲 noir、土耳其 clay(与插画版同出一阕拆两主题) |
| 天地为炉 | The Forge of Creation | 贾谊《鵩鸟赋》 | volcano | 火山口=造化锻炉,库里气象最大;深色封面+熔岩橙大字 |
| 星垂平野 | Stars over the Plains | 杜甫《旅夜书怀》 | national parks | 公园暗夜星空标准答案;诗题本就是「旅夜」;副题「月涌大江流」 |
| 长风万里 | The Long Wind | 李白《宣州谢朓楼》 | mixed | 秋雁应季(9-10月);通用远行题而不俗;副题「送秋雁」点季节 |
| 坐看云起 | Watching Clouds Rise | 王维《终南别业》 | mountain | 徒步松弛感;曝光度高,避热门可倒用「行到水穷」作主题 |
| 银河落九天 | A Waterfall of Stars | 李白《望庐山瀑布》 | mountain | 瀑布+星空双关;注意秋季枯水期慎用瀑布义;五字竖排佳 |
| 光之山脉 | The Range of Light | John Muir 对内华达山脉的命名(公版);中文原创化用译名 | mountain | 优胜美地专属血统(缪尔=国家公园之父);「光」给插画金色侧光题眼 |
| 秋水长天 | Where Water Meets Sky | 王勃《滕王阁序》 | coast | 秋季海岸/湖区;水平线构图天然适配;副题用原句;已用:澳洲 journal、北欧 journal |
| 千江月 | A Thousand River Moons | 禅偈「千江有水千江月」(《嘉泰普灯录》) | mixed+coast | 跨时区/跨日界线妙题——每条江里同一轮月;三字大留白;已用:意大利 glass、越南 splash |
| 万人如海 | A Sea of Faces | 苏轼「万人如海一身藏」 | city | 大城市首选(纽约贴切);副题接「一身藏」=旅人匿名的自由;越南测试 zine 用了缩写「人海」+ A SEA OF FACES |
| 一身藏 | Hidden in the Crowd | 苏轼「万人如海一身藏」下半句 | city+bazaar | 与「万人如海」同源可拆用:一册两主题各取半句;三字大留白;巴扎/夜市/老城迷宫的匿名感 |
| 千门万户 | A Thousand Gates | 王安石《元日》「千门万户曈曈日」 | city+bazaar | 老城连绵门户+日出;巴扎/麦地那行程题眼;副题用原句 |
| 秦时明月 | Moon of Qin | 王昌龄《出塞》「秦时明月汉时关」 | ancient-ruins | 古迹标准答案;英译 MOON OF QIN 已被中国测试 clay/splash 用过(11 字符,玻璃版会折行,见下) |
| 断碑残阳 | Broken Stone, Low Sun | 原创化用(碑=遗址,残阳=黄昏) | ancient-ruins | 以弗所/棉花堡/特奥蒂瓦坎这类露天遗址的黄昏光;英文双短语容易压进任何主题 |
| 长安陌上 | On the Chang'an Road | 卢照邻《长安古意》 | city+ancient-ruins | 古都行程(西安/伊斯坦布尔/京都)通题;「陌上」自带街巷行走感 |
| 大路之歌 | Song of the Open Road | 惠特曼(公版) | road-trip | 美国公路叙事正典源头,比用滥的「在路上」高一辈分 |
| 太阳照常升起 | The Sun Also Rises | 海明威(美国已公版),典出《传道书》 | mixed+island | 六字上限,宜瘦长衬线/竖排;适合日出仪式行程;暗合环球飞行 |
| 归去来 | Homeward | 陶渊明《归去来兮辞》 | mixed | 回程册/终章专用;三字奇数排布大留白 |
| 雪泥鸿爪 | Traces in the Snow | 苏轼「应似飞鸿踏雪泥」 | mixed+mountain | 更适合旅行后回顾相册/游记合集;冬季行程可直用 |
| 长河落日 | Long River, Low Sun | 王维《使至塞上》 | road-trip | 荒漠公路黄昏;圆日+地平线=现成插画脚本;副题「大漠孤烟直」 |
| 逐日 | Chasing the Sun | 《山海经》夸父逐日 | road-trip+mixed | 两字冲击力最强;向东跨洋追日尤贴;结局有余韵,介意者慎用 |
| 汤谷 | Where the Sun Bathes | 《山海经》「汤谷上有扶桑,十日所浴」 | geothermal | 黄石地热的神话对位;最深冷门好牌;务必配副题压住「汤」的字面 |

## Non-Chinese trips — same fields, Latin budgets

The table above is a Chinese canon; for an English (or any Latin-script) trip use it
as **method**, not menu — an allusion, a season word, a colour word, a place-scale
word — and fill the same art fields (settled after the London→Japan test, F9):

- **Field roles do not change** (`themes.<theme>.cover`, see ART-SCHEMA): `zh` = the
  big display title (h1) — **it may be an English phrase**, the key name is
  historical; `sub` = the copy line under it (route list or the quoted source line);
  `en` = the CAPS English line, a companion not a translation — when `zh` is already
  English, make `en` a longer second line, not a repeat; `credit` = the source, small
  (`— after Bashō, public domain` / `original coinage`); `kick` / `kick_en` stay the
  short trip word (`Japan 2026` / `JAPAN 2026`).
- **Latin character budgets per theme** (the renderers were sized for 2-6 CJK
  glyphs; these are the measured or declared ceilings, spaces included):
  - 插画 illustrated `h1` ≈ **11 characters** — "Late Maples" fills the 500 px line
    edge to edge; 12+ wraps or shrinks;
  - 手账 journal `h1` **auto-sizes in 4 tiers** by weighted length (a CJK glyph
    counts 1, a Latin letter/digit 0.6): ≤5 Latin chars = full size, ≤7 one notch
    down, ≤10 smaller, anything longer shrinks to fit the width in one line and
    never wraps — so ~10 Latin characters is where it stops looking like a title;
  - zine `days[].theme` (vertical `.vtitle`) **≤ 10 characters** — English letters
    stack upright and read as decoration; longer than 10 turns into a 1,400 px
    column (override per day via `themes.zine.days[d].theme`); zine **`cover.zh` is
    a vertical column of 2-4 glyphs** (`clamp(96px,19vw,196px)` per glyph — 4 CJK
    characters are already ~784 px tall on desktop; a 5th glyph or a Latin word
    longer than 4 letters clips off the page — 人海 / KOYO are the right size);
  - 夜航 noir `h1` (`.lead h1`, `clamp(56px,12vw,168px)`, `.1em` tracking, full
    viewport width minus the gutter, and it **wraps** rather than shrinks):
    **≤ 10 characters conservative** — mobile 375 px is the binding case (~9-10
    chars at the 56 px floor); the Mexico test shipped "Night Vigil" (11) and it
    rendered, desktop-probed — verify with `xprobe.sh … module` at both widths
    before shipping longer;
  - 黏土 clay `h1`: with a title sticker the budget belongs to the **image** — the
    sticker is `min(420px, 72vw)` wide, so ~**12 characters** with the last letter
    given room (the "QINC" lesson below); the text fallback (`clamp(40px,8vw,84px)`,
    weight 900, `.1em`) fits ~12 at 375 px and wraps beyond — "≤12, verify with
    xprobe" either way;
  - 玻璃 glass `h1`: **≤ 10 characters measured** (the Morocco test: "MOON OF QIN" =
    11 wraps over the hero plate; "Ochre Road" = 10 is the safe example) — 闪屏
    splash `h1`: **≤ 12 characters** placeholder until the builders publish a
    measured value (title board); on either, a longer phrase goes to `sub`;
  - `en` (CAPS line) — ≤ ~32 characters on every theme; `sub` — one route line
    ≤ ~40 characters or two lines with `\n`.
- **Two worked English examples**:
  - `zh: "Late Maples"` · `en: "EIGHT DAYS IN THE RED SEASON"` · `sub: "Tokyo →
    Hakone → Kyoto · 21-28 Nov"` · `credit: "after Bashō — public domain source;
    title is an original coinage"` (Japan koyo trip; the season word does the work
    the colour word 碧/苍 does in the table).
  - `zh: "MOON OF QIN"` · `en: "XI'AN AND BEIJING, EIGHT NIGHTS"` · `sub: "秦时明月汉时关
    — 王昌龄"` · `credit: "Wang Changling, 8th c. — public domain"` (China trip; the
    source line lives in `sub` and stays Chinese — bilingual by design, not by
    accident. Note the clay sticker put its crescent right after "QIN" and read
    "QINC": when a title is baked into an image, leave the last letter breathing
    room. And 11 characters is **one too many for glass** — it wrapped over the
    hero plate in the Morocco test; that trip's `zh: "Ochre Road"` (10) · `en:
    "MARRAKECH TO THE BLUE MOUNTAIN"` · `credit: "original coinage · Ibn Battuta set
    out from Tangier, 1325"` is the glass-safe shape.)
- **Cite honestly in English too**: a public-domain original line (Bashō, Li Bai,
  Whitman, Muir) may be quoted and is marked `public domain`; a phrase you made up
  is marked `original coinage`; in-copyright prose may inspire but is never quoted.
  Same cliché blacklist applies (`Wanderlust`, `Life is a journey`, `Eat Pray…`).

**Worked example** (US 2026: 北京→纽约→哥伦布球赛→黄石→优胜美地→夏威夷火山→北京):
top pick 碧海苍梧(全程弧线总括:碧海=太平洋+夏威夷压轴,苍梧=黄石/优胜美地远山),
备选 江入大荒(横贯大陆段的镜头语言)、落日熔金(火山压轴点题+自带配色)。封面排布:
eyebrow 日期 → h1 碧海苍梧 → EN 字距行 DAWN SEAS · DUSK PEAKS → 引线「朝碧海而暮苍梧
—— 徐霞客」→ 路线副题。
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