Marco Polo: a travel planning skill
Marco Polo
A skill that builds an itinerary from real places, hours and bookings and delivers a handbook with a map and food guide
- 139 ★ on the repository
- Last commit
Extended access
Why this level
- Research needs a Xiaohongshu login through a Chrome extension and Amap keys that the agent uses on your behalf
- Hours, prices and bookings can go stale, so check them against official sources
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/marco-poloDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Research needs a Xiaohongshu login through a Chrome extension and Amap keys that the agent uses on your behalf
- Hours, prices and bookings can go stale, so check them against official sources
This is third-party code. Review the repository files before installing.
What it does
Marco Polo is an open skill that builds a trip you can follow from your preferences. You choose a stay and sights, and the skill connects real places, transport, opening hours and bookings, then delivers one handbook with an interactive map, a food guide and a city guide. Routes start with coordinates. Amap supplies points of interest, coordinates and entrances for attractions, accommodation and transport hubs, and distances and times between stops come from transport queries. Stops are grouped around the stay to avoid backtracking. Opening hours, bookings, meals and travel time are planned together: food streets at mealtimes and night views after dark. Xiaohongshu adds experiences and recommendations, official sources verify hours, tickets and reservations, and FlyAI searches flights, trains and hotels on request. A reservation checklist says what to book and when. The choice stays with you: the skill shows options with reasons and tradeoffs, and swapping a place or hotel recalculates the plan and costs.
Who it is for. Travellers heading to Chinese cities who want a ready itinerary with a map, food and bookings in place of dozens of browser tabs.
Good fit when
- A multi-day trip to Nanjing needs a route built around the chosen hotel
- Stops have to be grouped so you do not travel back and forth
- A reservation checklist should say what to book in advance and for when
- You want to compare options and then swap a hotel or place without rebuilding the whole plan
- A handbook with a map, food and a city guide should open in a browser on the road
Not a fit when
- You travel outside China: the skill relies on Amap, Xiaohongshu and FlyAI, and the demo shows Chinese cities
- You have no Amap keys and no Xiaohongshu login: they are required for routes and research
- You want booking directly in the agent: the skill prepares a reservation checklist and does not place bookings
- You need an English-language guide: the demo materials are in Chinese
Example request
Plan a three-day trip to Nanjing. Choose the hotel together with me, group stops around it and prepare a reservation checklist and a handbook with a map.Limitations
Dependent skills are required: both Amap skills (`amap-lbs-skill` and `amap-jsapi-skill`), the Xiaohongshu bundle and the optional `flyai`. Amap needs your own Web Service and JSAPI keys, and Xiaohongshu needs Python 3.11, uv, Chrome and a signed-in account.
The skill does not guarantee that hours and prices are current: official sources verify them, and unverified facts are marked. On the public demo version the map runs on OpenFreeMap. If only the main skill is installed without dependencies, the agent reports which capabilities are missing. The last commit in the repository was made on October 9, 2026.
How to disable. Delete the `marco-polo` folder and the connected dependent skills from the skills directory, for example `~/.agents/skills/`. Remove the Amap keys and the Xiaohongshu login in their consoles and settings.
FAQ
How do I install Marco Polo?
Download the Skill ZIP from releases and unpack it into the skills directory, for example `~/.agents/skills/marco-polo/`. Install both Amap skills and the Xiaohongshu bundle next to it, and optionally `flyai`. Cloning the repository gives the full set with the demo site.
Which keys are needed?
Your own Amap keys: Web Service and Web JSAPI, created in the Amap console. Xiaohongshu needs a login through a Chrome extension. A FlyAI key is only for flight and hotel searches.
What is in the handbook?
An interactive map by day, a reservation checklist, a budget, a food guide with dishes and restaurants and a city guide with attraction cards. All of it opens from one entry page.
Does the skill change bookings and hotels by itself?
No. It shows options with reasons and tradeoffs and the choice stays with you. After you swap a place or hotel, the skill recalculates the affected parts of the plan and costs.
Does the skill work outside China?
It relies on Amap and Xiaohongshu, so it targets Chinese cities. The demo in the repository is built on Nanjing. For other countries the data of these services is not enough.
Discussion
No questions or reviews yet.
Related
SkillsA skill that guides an agent through web search and source checks and builds a trip book as one HTML file
travel-plan-viz: trip plan as an HTML page
travel-plan-viz
A skill that builds a trip plan into one HTML file with a map, a day-by-day schedule and reminders of booking deadlines
A JourniOne skill for trip planning: a day-by-day route, hotels, flights and a web journal of the trip
A skill that builds a personal trip handbook: a questionnaire and approved plan become an offline mobile HTML page.
A skill and dataset for a first trip to China: city matching, areas, itineraries, preparation and emergency help, all sourced
Search tours, hotels, flights, trains and excursions via Aviasales, Travelata, Level.Travel, Tutu.ru, Tripster and Sputnik8
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Marco Polo: a travel planning skill (this card) | no | 139 | |
| jianhao-travel-planner | no | 441 | a trip planner for individual requests, without a handbook with a map, food and city guide |
| travel-plan-viz: trip plan as an HTML page | no | 415 | visualises a ready itinerary, while Marco Polo builds it from coordinates |
README in short
The README explains what the skill offers: routes on real coordinates, a day plan with hours and bookings, a handbook for the trip and guided choice. Then come a quick start, dependent skills with links, Amap and Xiaohongshu setup, a step-by-step diagram and the repository layout with the `build_site.py` script.