travel-handbook
Builds the maps, charts, photos, and checks of a two-language trip handbook from one YAML trip configuration. Use this skill when a guide written before a journey needs a route map, climate or daylight charts, a trip calendar, or licensed photos, or when its language versions drift apart, even if nobody says handbook. USE FOR: route maps with locator inset and elevation profile, GPX for hiking apps, per-night temperatures at altitude, daylight and twilight, trip calendars, Plan B regions maps, Wikimedia Commons photos with licences and credits, overlapping map labels, Open-Meteo or Commons rate limits, name.md and name.<lang>.md twins, heading anchors and reference links. DO NOT USE FOR: planning or changing the itinerary (use travel-planning), signed-in forum reading (use authenticated-web-extraction), a diary built after the trip from the travellers' own photos, Word or PDF export (use pandoc-docx-export).
- Compatibility
- Requires uv, which fetches Python 3.11 or later and each script's dependencies from its inline header (matplotlib, Pillow, requests, astral, ruamel.yaml, tzdata). Needs network access to OpenTopoMap, Nominatim, the Open-Meteo archive and elevation APIs, and Wikimedia Commons.
Pinned to revision db1e7796b6f3, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/travel-handbook/SKILL.md
- skills/travel-handbook/assets/trip.example.yaml
- skills/travel-handbook/notes-evals.md
- skills/travel-handbook/references/trip-config.md
- skills/travel-handbook/scripts/build_charts.py
- skills/travel-handbook/scripts/build_map.py
- skills/travel-handbook/scripts/check_docs.py
- skills/travel-handbook/scripts/fetch_photos.py
- skills/travel-handbook/scripts/trip.py
Every link opens the file at its source, pinned to the revision this page describes.