Skip to content
Back to search

trip-map-skill

SkillWorks with Claude CodeGitHub

Claude skill that turns a start and an end point into an interactive 3D satellite trip map: real route, stops with photos, day plan, fuel, food and stays.

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/ashmitmittal--trip-map-skill/badge.svg)](/listings/ashmitmittal--trip-map-skill)

HTML

<a href="/listings/ashmitmittal--trip-map-skill"><img src="/api/listings/ashmitmittal--trip-map-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.

You need [Claude Code](https://claude.com/claude-code), Python 3.9 or newer, and an internet connection. Google Chrome is optional; with it the skill can look at photo contact sheets and screenshot the finished page.

git clone https://github.com/ashmitmittal/trip-map-skill.git
mkdir -p ~/.claude/skills
cp -r trip-map-skill/trip-map ~/.claude/skills/

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.

README.md · README · 76 lines
  1. # trip-map
  2. A Claude skill that turns "I'm going from A to B" into an interactive 3D satellite trip map, as one HTML file you can open, click through and share.
  3. Google Maps gives you a line and an arrival time. This gives you the trip: where to stop and why, how the days split, where the fuel runs out, where to eat and sleep, and a fly-through of the whole road.
  4. ![Overview: route, stops and altitude strip](docs/overview.png)
  5. ![A stop close up, with its photo card](docs/stop.png)
  6. ## What the page has
  7. - Satellite map with 3D terrain and the real road route
  8. - Hand-picked stops with photos, a reason to stop and one practical tip each
  9. - Day-by-day plan with realistic driving or riding times
  10. - Altitude profile linked to the map
  11. - Fuel, Food and Stay buttons that list real petrol pumps, eateries and stays along the road, and the longest gap between pumps
  12. - Play Trip: a fly-through of the route at 1×, 2× or 4×
  13. - Everything in a single HTML file, no account and no API key
  14. ## Install
  15. You need [Claude Code](https://claude.com/claude-code), Python 3.9 or newer, and an internet connection. Google Chrome is optional; with it the skill can look at photo contact sheets and screenshot the finished page.
  16. ```bash
  17. git clone https://github.com/ashmitmittal/trip-map-skill.git
  18. mkdir -p ~/.claude/skills
  19. cp -r trip-map-skill/trip-map ~/.claude/skills/
  20. ```
  21. ## Use
  22. Start Claude Code and ask for a trip in plain words:
  23. ```
  24. Make me a trip map from Delhi to Leh by bike.
  25. ```
  26. ```
  27. I'm driving from Noida to Gurugram this Saturday. Map it with a few good places to stop.
  28. ```
  29. Claude researches the route, picks the stops, builds the page and opens it. A short city drive takes around 15 minutes; a long multi-day trip takes longer, mostly waiting on free public map and photo services.
  30. ## How it works
  31. The work is split in two:
  32. - **The engine** (`trip-map/scripts/tripmap.py` and `trip-map/assets/template.html`) does the mechanical part: finds the road, measures distance and altitude, collects pumps, stays and eateries from OpenStreetMap, fetches photo candidates and builds the page. It is plain Python with no packages to install.
  33. - **Claude** supplies the judgement in one file, `trip.json`: which stops are worth making, how to split the days, what to warn about, which photos are good, and the short text on each card.
  34. `trip-map/references/trip-format.md` documents every field of `trip.json`, and `trip-map/examples/delhi-leh.json` is a full 23-stop example.
  35. ## Status
  36. Built and tested on macOS with Claude Code, on two routes: Delhi to Leh (963 km over mountain passes) and Noida to Gurugram (48 km city drive). It has not been tested on Windows, on Linux or in the Claude apps.
  37. ## Check before you travel
  38. The stops, tips and warnings are written by an AI model from web research, and the pumps, stays and eateries come from OpenStreetMap, which can be incomplete or out of date. Treat the page as a plan to verify, especially for fuel range, road closures, permits and altitude.
  39. ## Data and credits
  40. The skill and the pages it builds rely on free public services. Their terms and fair-use limits apply to you when you use it:
  41. - Map rendering: [MapLibre GL JS](https://maplibre.org/)
  42. - Satellite imagery: Esri World Imagery (Esri, Maxar, Earthstar Geographics). The page loads these tiles without a key. Esri's terms apply; for commercial or heavy use, get your own ArcGIS key or point the template at another imagery source.
  43. - Terrain: Mapzen Terrain Tiles on AWS Open Data
  44. - Roads, place names, pumps, stays and eateries: © [OpenStreetMap](https://www.openstreetmap.org/copyright) contributors, through OpenFreeMap, the OSRM demo server, Nominatim and Overpass
  45. - Photos and background notes: Wikimedia Commons and Wikipedia. Each photo keeps its own licence and credit on the page.
  46. The engine sends requests slowly and caches every answer so it stays within these services' limits. Please keep it that way if you change it.
  47. ## Licence
  48. MIT. See [LICENSE](LICENSE).

Ratings and comments

Sign in to rate this skill.

Sign in

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