RoadTrip Navigator turns a road trip prompt or draft itinerary into a checked plan with route, weather, lodging, fuel or charging, and border details. It keeps the trip data separate from the rendered page, so you can edit the JSON and regenerate the final `trip.html` file.
Builders who want an agent to plan or verify a road trip before they drive.
You can catch unrealistic driving days, missing bookings, and route problems before the trip starts.
Works in two modes: create a route from a prompt, or stress-test an itinerary the user already wrote.
Checks driving time, daylight, gate hours, seasonal closures, weather, fuel or EV range, borders, and reservations.
Builds and updates `tripData.json` with reliability labels and backfilled route details.
Renders one offline-friendly `trip.html` file with map links, timeline, budget, warnings, and booking views.
Exposes routing, weather, parks, charging, border, lodging, place-validation, and rendering helpers through the MCP server.
/plugin marketplace add Waybox-AI/roadtrip-skill /plugin install roadtrip-navigator@roadtrip-skill
npx skills add Waybox-AI/roadtrip-skill
# 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
A road trip plan, checked before you drive.
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.
English · 简体中文
Plan a 7-day Southwest national-parks loop from Las Vegas—2 adults, gas SUV, September.
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.
Here is my itinerary. Tell me what is unrealistic, risky, or missing—and fix it without changing the parts that already work.
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:
⚠ Day 3 is about 5.5 hours of driving with a child in the car.
Suggested fix: overnight in Forks and move the coast stops to Day 4.
⚠ Arrival is after sunset and after the park gate closes.
Suggested fix: leave 90 minutes earlier or move the hike to tomorrow.
⚠ This mountain pass is normally closed for your travel date.
Suggested fix: use the winter route and add 42 miles.
⚠ Estimated EV arrival charge is below the trip buffer.
Suggested fix: add a mid-route DC fast-charge stop.
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.
Most AI trip planners are good at inspiration. Road trips fail in the operational details.
| Reality check | Generic AI itinerary | RoadTrip Navigator |
|---|---|---|
| Daily driving | A sequence of stops | Routes each day against a realistic drive limit, overnight location, daylight, and gate hours |
| 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 |
| Weather and seasons | Generic packing advice | Separates live forecast from climatology, surfaces weather advisories, and flags seasonal closures or reroutes |
| Reservations | “Book early” | Builds dated booking tasks on the appropriate system and organizes hotels, restaurants, and attractions |
| 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 |
| 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 |
| Prices and confidence | Precise-looking guesses | Labels figures as verified, reference, or estimate; shows prices only when they can be supported |
The final deliverable is a single trip.html file built from an editable tripData.json.
Open it on a phone. Send it to the passenger seat. Print it. Share it. Re-render it after an edit.
It contains:
The itinerary data remains available offline. Network-dependent maps and links degrade gracefully.
See a finished trip before installing:
Southwest loop, 7 days · Sunnyvale → Lake Tahoe, 3 days · Seattle → Vancouver EV, 4 days · Chicago loop, 5 days
Or use the free browser version at roadtripskill.dev.
Road trips evolve. Edit the plan in ordinary language:
Make Day 4 shorter.
Remove Monterey and reconnect the route.
Stay two nights in Banff.
Rewrite the Lake Tahoe stay around a quieter hotel.
Add a mid-route charging stop.
Refresh the weather and budget.
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.
“Checked” does not mean “guaranteed.” It means the itinerary has been run through explicit feasibility checks and its remaining uncertainty is visible.
verified, reference, or estimate so you know what to trust and what to recheck.North America is the deepest-supported region. For China-domestic itineraries, localized output includes CNY budgets and Ctrip lodging links where supported.
/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.
npx skills add Waybox-AI/roadtrip-skill
See INSTALL.md for per-agent and manual installation notes.
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.
request or existing itinerary
│
▼
scripts/helper.py ── mode, required inputs, region hints
│
▼
SKILL.md workflow ── plan or verify ── research and feasibility checks
│
▼
tripData.json ── structured itinerary and reliability metadata
│
▼
assets/generate.py + assets/template.html
│
▼
trip.html ── map, timeline, bookings, budget, warnings, share and print
Planning data and presentation stay separate: edit the JSON, render again, and keep the final page deterministic.
RoadTrip Navigator does not promise:
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.
Use the itinerary to prepare and to spot problems. Confirm critical closures, reservations, vehicle requirements, and same-day conditions with official sources before driving.
.claude-plugin/ Claude Code plugin and marketplace manifests
SKILL.md Plan/check modes and the seven-step workflow
reference.md tripData schema, reliability grades, drive limits, tool routing
scripts/ Input parsing, planning, editing, route comparison, and backfills
tools/ Routing, weather, parks, EV, fuel, lodging, places, borders, customs
assets/ HTML generator, template, and sample trips
mcp_server/ The same helpers and renderer exposed as 14 typed MCP tools
tests/ Offline-first behavior and rendering tests
If you are learning to build agent skills, start with SKILL.md, then read AGENTS.md and reference.md.
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.
Found a bad closure date, booking window, route, or charging assumption? Open an issue. Those reports improve the checks for everyone.
If RoadTrip Navigator helps you plan your next road trip, give us a star! ⭐
MIT © yang-hong
Sign in to join the discussion.
No comments yet. Be the first to say what this is good for.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Open-source AI job search: scan job portals, evaluate listings into a structured A-H report with a global 1-5 score, tailor your CV, track applications — runs locally in your AI coding CLI (Claude Code, Codex, OpenCode, Antigravity…)
AI agent skill that researches any topic across Reddit, X, YouTube, HN, Polymarket, and the web - then synthesizes a grounded summary
Academic Research Skills for Claude Code: research → write → review → revise → finalize
817 structured cybersecurity skills for AI agents · Mapped to 6 frameworks: MITRE ATT&CK, NIST CSF 2.0, MITRE ATLAS, D3FEND, NIST AI RMF & MITRE F3 (Fight Fraud) · agentskills.io standard · Works with Claude Code, GitHub Copilot, Codex CLI, Cursor, Gemini CLI & 20+ platforms · 29 security domains · Apache 2.0
Distilly — Distill how they think into reusable Skills for any Agent or Bot. Formerly Colleague Skill（原同事 Skill）.