Skip to content
Back to search

roadtrip-skill

An AI agent skill that turns "start + days" into a road trip you can actually drive.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/waybox-ai--roadtrip-skill/badge.svg)](/listings/waybox-ai--roadtrip-skill)

HTML

<a href="/listings/waybox-ai--roadtrip-skill"><img src="/api/listings/waybox-ai--roadtrip-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Claude Code

/plugin marketplace add Waybox-AI/roadtrip-skill
/plugin install roadtrip-navigator@roadtrip-skill

Then ask for a road trip in ordinary language. The skill activates automatically; `/roadtrip` is available when you want to invoke it explicitly.

Codex, Cursor, and other SKILL.md-compatible agents

npx skills add Waybox-AI/roadtrip-skill

See [INSTALL.md](INSTALL.md) for per-agent and manual installation notes.

MCP server

The routing, weather, park, charging, border, lodging, place-validation, and rendering tools are also available as a 14-tool MCP server for Codex, Gemini CLI, Claude Code, and other MCP hosts.

# OpenAI Codex CLI
codex mcp add roadtrip -- uvx --from git+https://github.com/Waybox-AI/roadtrip-skill roadtrip-mcp

# Google Gemini CLI
gemini mcp add roadtrip uvx --from git+https://github.com/Waybox-AI/roadtrip-skill roadtrip-mcp

# Claude Code
claude mcp add roadtrip -- uvx --from git+https://github.com/Waybox-AI/roadtrip-skill roadtrip-mcp

The skill carries the planning discipline; the MCP server carries the typed execution tools. See [mcp_server/README.md](mcp_server/README.md).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 22 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "roadtrip-skill",
  3. "owner": {
  4. "name": "Waybox AI",
  5. "url": "https://github.com/Waybox-AI"
  6. },
  7. "plugins": [
  8. {
  9. "name": "roadtrip-navigator",
  10. "source": "./",
  11. "description": "Turn \"start + days\" or an existing route into a road trip you can actually drive: paced into days, with overnight stops, fuel/charging, park reservations, seasonal road risks, and a map-first single-file HTML page.",
  12. "version": "1.1.0",
  13. "category": "travel",
  14. "keywords": [
  15. "road trip",
  16. "travel",
  17. "national parks",
  18. "EV charging"
  19. ]
  20. }
  21. ]
  22. }
README.md · README · 244 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="assets/readme-hero.png" alt="RoadTrip Navigator" />
  3. # RoadTrip Navigator
  4. **A road trip plan, checked before you drive.**
  5. Plan a route from scratch—or paste the itinerary you already made. RoadTrip Navigator checks the details that decide whether the trip actually works, then turns it into one shareable, offline-friendly itinerary.
  6. English · [简体中文](README.zh.md)
  7. [![CI/CD Status](https://img.shields.io/github/actions/workflow/status/Waybox-AI/roadtrip-skill/ci-cd.yml?branch=main&label=CI/CD&style=for-the-badge&logo=githubactions&logoColor=white)](https://github.com/Waybox-AI/roadtrip-skill/actions/workflows/ci-cd.yml)
  8. [![License: MIT](https://img.shields.io/badge/license-MIT-green.svg?style=for-the-badge)](LICENSE)
  9. [![Claude Code + compatible agents](https://img.shields.io/badge/works%20with-Claude%20Code%20%2B%20compatible%20agents-blue.svg?style=for-the-badge)](INSTALL.md)
  10. [![No API keys required](https://img.shields.io/badge/API%20keys-none%20required-brightgreen.svg?style=for-the-badge)](#install)
  11. [![Try it in your browser](https://img.shields.io/badge/web%20version-roadtripskill.dev-orange.svg?style=for-the-badge)](https://roadtripskill.dev)
  12. </div>
  13. <div align="center">
  14. <img src="assets/demo.gif" alt="RoadTrip Navigator demo" />
  15. </div>
  16. ## Two ways to start
  17. ### Plan one
  18. > Plan a 7-day Southwest national-parks loop from Las Vegas—2 adults, gas SUV, September.
  19. RoadTrip Navigator proposes two viable routes, helps you choose, and builds the trip around realistic driving days, overnight stops, bookings, weather, fuel or charging, and seasonal road access.
  20. ### Check one
  21. > Here is my itinerary. Tell me what is unrealistic, risky, or missing—and fix it without changing the parts that already work.
  22. Paste day-by-day text, a linked plan, or an itinerary you already drafted. The skill keeps your route as the starting point, stress-tests it, and calls out problems such as:
  23. ```text
  24. ⚠ Day 3 is about 5.5 hours of driving with a child in the car.
  25. Suggested fix: overnight in Forks and move the coast stops to Day 4.
  26. ⚠ Arrival is after sunset and after the park gate closes.
  27. Suggested fix: leave 90 minutes earlier or move the hike to tomorrow.
  28. ⚠ This mountain pass is normally closed for your travel date.
  29. Suggested fix: use the winter route and add 42 miles.
  30. ⚠ Estimated EV arrival charge is below the trip buffer.
  31. Suggested fix: add a mid-route DC fast-charge stop.
  32. ```
  33. The result is not just a list of recommendations. It is a revised itinerary that explains what passed, what did not, and what still needs confirmation.
  34. ## What gets checked
  35. Most AI trip planners are good at inspiration. Road trips fail in the operational details.
  36. | Reality check | Generic AI itinerary | RoadTrip Navigator |
  37. | --- | --- | --- |
  38. | **Daily driving** | A sequence of stops | Routes each day against a realistic drive limit, overnight location, daylight, and gate hours |
  39. | **Place names and routing** | Quietly accepts bad inputs | Validates user-supplied places and backfills per-day distance and drive time from routing tools when available |
  40. | **Weather and seasons** | Generic packing advice | Separates live forecast from climatology, surfaces weather advisories, and flags seasonal closures or reroutes |
  41. | **Reservations** | “Book early” | Builds dated booking tasks on the appropriate system and organizes hotels, restaurants, and attractions |
  42. | **Fuel and EV range** | Usually ignored | Recomputes energy cost, warns about sparse corridors, simulates leg-by-leg state of charge, and can add mid-route fast charging |
  43. | **Borders and time zones** | Arrival times that do not add up | Corrects time-zone effects and adds US–Canada–Mexico document, insurance, customs, and exemption notes |
  44. | **Prices and confidence** | Precise-looking guesses | Labels figures as verified, reference, or estimate; shows prices only when they can be supported |
  45. ## One file for the whole car
  46. The final deliverable is a single `trip.html` file built from an editable `tripData.json`.
  47. Open it on a phone. Send it to the passenger seat. Print it. Share it. Re-render it after an edit.
  48. It contains:
  49. - A map-first route with numbered stops.
  50. - One-tap Google Maps and Apple Maps links for each leg.
  51. - A complete daily timeline with weather, meals, activities, lodging, and warnings.
  52. - Booking views for every stay, meal, and attraction—not only the ones with deadlines.
  53. - A route comparison when two viable options exist.
  54. - A budget that updates when the itinerary changes.
  55. - EV charging details and border logistics when relevant.
  56. - Responsive styling, print colors, and a built-in share action.
  57. The itinerary data remains available offline. Network-dependent maps and links degrade gracefully.
  58. See a finished trip before installing:
  59. [Southwest loop, 7 days](https://roadtripskill.dev/api/sample?name=sw) · [Sunnyvale → Lake Tahoe, 3 days](https://roadtripskill.dev/api/sample?name=tahoe) · [Seattle → Vancouver EV, 4 days](https://roadtripskill.dev/api/sample?name=pnw) · [Chicago loop, 5 days](https://roadtripskill.dev/api/sample?name=chicago)
  60. Or use the free browser version at **[roadtripskill.dev](https://roadtripskill.dev)**.
  61. ## Change your mind without rebuilding everything
  62. Road trips evolve. Edit the plan in ordinary language:
  63. ```text
  64. Make Day 4 shorter.
  65. Remove Monterey and reconnect the route.
  66. Stay two nights in Banff.
  67. Rewrite the Lake Tahoe stay around a quieter hotel.
  68. Add a mid-route charging stop.
  69. Refresh the weather and budget.
  70. ```
  71. The planning layer can update affected days and then refresh derived sections such as mileage, weather, fuel cost, EV corridor, booking countdown, lodging links, border information, and route comparison.
  72. ## Designed to show its work
  73. “Checked” does not mean “guaranteed.” It means the itinerary has been run through explicit feasibility checks and its remaining uncertainty is visible.
  74. - **Official and free sources first.** Routing, parks, weather, charging, border, and lodging helpers prefer official or open sources and fall back to structured web research.
  75. - **Source-aware weather.** A short-range forecast is not presented as the same thing as a historical climate average.
  76. - **Reliability grading.** Numbers are marked `verified`, `reference`, or `estimate` so you know what to trust and what to recheck.
  77. - **Best-effort backfill.** Hard numbers such as daily route distance, energy cost, EV corridor, booking dates, lodging links, border notes, and route comparisons are refreshed by deterministic tools when possible.
  78. - **Clear limits.** Every itinerary reminds you to confirm critical details with official sources before departure.
  79. North America is the deepest-supported region. For China-domestic itineraries, localized output includes CNY budgets and Ctrip lodging links where supported.
  80. ## Install
  81. ### Claude Code
  82. ```text
  83. /plugin marketplace add Waybox-AI/roadtrip-skill
  84. /plugin install roadtrip-navigator@roadtrip-skill
  85. ```
  86. Then ask for a road trip in ordinary language. The skill activates automatically; `/roadtrip` is available when you want to invoke it explicitly.
  87. ### Codex, Cursor, and other SKILL.md-compatible agents
  88. ```bash
  89. npx skills add Waybox-AI/roadtrip-skill
  90. ```
  91. See [INSTALL.md](INSTALL.md) for per-agent and manual installation notes.
  92. ### MCP server
  93. The routing, weather, park, charging, border, lodging, place-validation, and rendering tools are also available as a 14-tool MCP server for Codex, Gemini CLI, Claude Code, and other MCP hosts.
  94. ```bash
  95. # OpenAI Codex CLI
  96. codex mcp add roadtrip -- uvx --from git+https://github.com/Waybox-AI/roadtrip-skill roadtrip-mcp
  97. # Google Gemini CLI
  98. gemini mcp add roadtrip uvx --from git+https://github.com/Waybox-AI/roadtrip-skill roadtrip-mcp
  99. # Claude Code
  100. claude mcp add roadtrip -- uvx --from git+https://github.com/Waybox-AI/roadtrip-skill roadtrip-mcp
  101. ```
  102. The skill carries the planning discipline; the MCP server carries the typed execution tools. See [mcp_server/README.md](mcp_server/README.md).
  103. ## How it works
  104. ```text
  105. request or existing itinerary
  106. │
  107. ▼
  108. scripts/helper.py ── mode, required inputs, region hints
  109. │
  110. ▼
  111. SKILL.md workflow ── plan or verify ── research and feasibility checks
  112. │
  113. ▼
  114. tripData.json ── structured itinerary and reliability metadata
  115. │
  116. ▼
  117. assets/generate.py + assets/template.html
  118. │
  119. ▼
  120. trip.html ── map, timeline, bookings, budget, warnings, share and print
  121. ```
  122. Planning data and presentation stay separate: edit the JSON, render again, and keep the final page deterministic.
  123. ## What it deliberately does not do
  124. RoadTrip Navigator does not promise:
  125. - Live fuel or electricity prices.
  126. - Live charger occupancy.
  127. - Live campground, hotel, or ticket availability.
  128. - Minute-by-minute traffic.
  129. - Booking or payment on your behalf.
  130. - Turn-by-turn navigation.
  131. It also avoids whole-route GPX/KML export. Batch waypoint imports can route travelers onto seasonally closed roads or start from the wrong origin, so each stop gets its own navigation link instead.
  132. Use the itinerary to prepare and to spot problems. Confirm critical closures, reservations, vehicle requirements, and same-day conditions with official sources before driving.
  133. ## Project layout
  134. ```text
  135. .claude-plugin/ Claude Code plugin and marketplace manifests
  136. SKILL.md Plan/check modes and the seven-step workflow
  137. reference.md tripData schema, reliability grades, drive limits, tool routing
  138. scripts/ Input parsing, planning, editing, route comparison, and backfills
  139. tools/ Routing, weather, parks, EV, fuel, lodging, places, borders, customs
  140. assets/ HTML generator, template, and sample trips
  141. mcp_server/ The same helpers and renderer exposed as 14 typed MCP tools
  142. tests/ Offline-first behavior and rendering tests
  143. ```
  144. If you are learning to build agent skills, start with [SKILL.md](SKILL.md), then read [AGENTS.md](AGENTS.md) and [reference.md](reference.md).
  145. ## Contributing
  146. Issues and pull requests are welcome. Useful contributions include regional closure knowledge, reservation rules, new official data clients, sample trips, and reports of itineraries that failed a real-world check.
  147. Found a bad closure date, booking window, route, or charging assumption? [Open an issue](https://github.com/Waybox-AI/roadtrip-skill/issues). Those reports improve the checks for everyone.
  148. ## Contributors
  149. <a href="https://github.com/Waybox-AI/roadtrip-skill/graphs/contributors"><img src="https://contrib.rocks/image?repo=Waybox-AI/roadtrip-skill" /></a>
  150. <a href="https://github.com/ziminpan"><img src="assets/contributors/ziminpan.svg" width="64" height="64" alt="ziminpan" /></a>
  151. <a href="https://github.com/cazermess"><img src="assets/contributors/cazermess.svg" width="64" height="64" alt="cazermess" /></a>
  152. ## ⭐ Star History
  153. If RoadTrip Navigator helps you plan your next road trip, give us a star! ⭐
  154. <div align="center">
  155. <a href="https://www.star-history.com/?type=date&amp;repos=Waybox-AI%2Froadtrip-skill">
  156. <picture>
  157. <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=Waybox-AI/roadtrip-skill&amp;type=Date&amp;theme=dark" />
  158. <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=Waybox-AI/roadtrip-skill&amp;type=Date" />
  159. <img alt="Star History Chart for Waybox-AI/roadtrip-skill" src="https://api.star-history.com/svg?repos=Waybox-AI/roadtrip-skill&amp;type=Date" />
  160. </picture>
  161. </a>
  162. </div>
  163. ## License
  164. [MIT](LICENSE) © yang-hong
  165. ---
  166. <div align="center">
  167. <sub>Built by <a href="https://waybox.ai">Waybox</a>, maker of OMO, an in-car AI companion. RoadTrip Navigator checks the trip before departure; OMO rides along.</sub>
  168. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.