What it does
Migo · 旅行领航 —— 把旅行行程生成为单文件、可离线、手机优先的 HTML(交互地图+每日时间轴+出发前提醒)。Claude Code / Codex 通用 Skill(travel-plan-viz)。
- Connects Instruction files the AI reads
- Account or key Not confirmed (README mentions a key or .env file)
- Category Coding
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/zexuanw958-svg-travel-plan-viz)Use together with
MCP servers that connect the AI to services for the same work
Fallow
Codebase intelligence for TypeScript and JavaScript, exposed as structured MCP analysis tools.
Desktop Commander
MCP server for terminal commands, file operations, and process management
Similar Skills
Same kind of work, ordered like the Skills list
| This one travel-plan-viz | rea | andrej-karpathy-skills | graphify | MoneyPrinterTurbo | |
|---|---|---|---|---|---|
| Maker | zexuanw958-svg | morluto | multica-ai | Graphify-Labs | harry0703 |
| Skills | 1 | 1 | 1 | 1 | 1 |
| GitHub stars | 414 | 470,165 | 234,528 | 150,695 | 144,727 |
| Last code change | Nov 19, 2026 | Nov 20, 2026 | Apr 20, 2026 | Nov 20, 2026 | Nov 19, 2026 |
| License | MIT | MIT | – | Apache-2.0 | MIT |
1 skills (instruction sets) by zexuanw958-svg that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Claude CodeCodex
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account zexuanw958-svg (person) is only 8 months old: take extra care
- Use and upkeep
★ 414 stars, few users so far · code last changed Nov 19, 2026
- Any scripts?
3 scripts that can run on a computer: assets/map.js, assets/reminders.js, assets/validate.js
- Uses the internet?
No internet calls found in the scripts
- Changes machine-wide settings?
No hooks or writes to machine settings found
Checked automatically from the repo files at commit 07d0155 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Files are byte-for-byte the same as on GitHub at commit 07d0155 · View on GitHub ↗
3 scripts
Once uploaded it runs on Claude’s systems, not on your computer. No need to unzip
Look inside before downloading
All 9 files · 48 KB
SKILL.md6 KBassets/map.js6 KBassets/page-contract.md11 KBassets/reminders.js2 KBassets/validate.js6 KBreferences/design-guidelines.md2 KBreferences/porting-to-other-agents.md4 KBreferences/research-guide.md9 KBLICENSE1 KB
Download travel-plan-viz.zip
Checking the commands · copy buttons appear once they pass
Open Skills on claude.ai and upload
+Create skillUpload a skillpick travel-plan-viz.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /travel-plan-viz or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
Restart Claude Code, then type /travel-plan-viz or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the travel-plan-viz folder at ~/.agents/skills/travel-plan-viz
~ is your home folder ($HOME)
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
Restart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick travel-plan-viz
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
Checking the commands · copy buttons appear once they pass
In Cursor’s Agent chat, type / and pick travel-plan-viz
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
3,143 characters · Open the full file on GitHub
---
name: travel-plan-viz
description: 把旅行行程做成美观、离线可读、手机优先的单文件 HTML(交互地图+每日时间轴+出发前订票提醒)。两种用法——只给目的地和天数让它帮你规划,或丢一份现成计划让它直接出页面。触发:旅行计划可视化、做旅行攻略网页、行程 HTML、travel plan visualization。
---
# 旅行计划可视化
把一趟旅行变成单文件 HTML 页面:交互地图、每日时间轴、出发前订票提醒。机械逻辑用自带引擎(`assets/map.js`、`assets/reminders.js`),美学交给设计步骤(`frontend-design` / `huashu-design`,或内置准则兜底)。
## 第一步:判断模式
- 用户**只给了目的地+天数**(如"香港 4 天 3 晚")→ 模式 A(从零规划)。
- 用户**已提供行程**(文字或旧 HTML 文件)→ 模式 B(解析已有计划)。
## 模式 A:从零规划
1. 读 `references/research-guide.md`,联网调研目的地。
2. 在对话里用 markdown 提出详实逐日计划(早/中/晚、景点、交通、住宿)。
3. 与用户来回迭代,直到用户明确确认。
4. 进入"调研补全 + 生成"。
## 模式 B:已有计划
1. 解析用户给的行程。**若是本 skill 生成的旧 HTML**:直接解析其中 `<script id="trip-data" type="application/json">` 的完整 `trip` JSON(数据与呈现分离,别去反解析渲染后的 DOM——必丢字段);旧版页面没有这块时才从 DOM/文本提取。
2. **顺手提建议(Agent 增值,但别硬来)**:把用户的计划对照"完善行程"的维度(行前须知/天气应对、提前订票项、点到点交通、节奏与缓冲、当地必吃、片区住宿是否合理等)快速体检,在**对话里**给**最多 3–4 条**具体、可选的优化建议。原则:
- 只挑**真实存在的缺口**;计划本就完整就直说"挺完整",**不要硬凑、不要说教、不要替用户重排行程**。
- 一句点出问题 + 一句给方向即可,简洁;建议默认口头给,保持 HTML 成品干净(用户想把建议也放进页面再加)。
- 这是我们区别于"纯提示词转 HTML"的地方——发挥 Agent 的判断力,但点到为止。
3. 进入"调研补全 + 生成"(生成不被建议阻塞;采纳哪些由用户定)。
## 调研补全 + 生成
1. **先判断第三方 skill 适配**(详见 `references/research-guide.md`「第三方 skill 适配」节):若当前 Agent 可调用用户**已装**的官方旅行 skill / MCP(飞猪、高德、腾讯地图、滴滴等),**优先用它们拿对应数据**——高德地理编码拿精确坐标(**注意:高德/腾讯返回 GCJ-02 坐标,写入 `trip` 前必须用 `map.js` 的 `gcj02ToWgs84` 转成 WGS-84**,否则在 OSM 地图上偏移几百米)、路线规划增强点到点交通、天气查询、生成专属地图/导航/叫车的行动链接;飞猪拿实时航班/酒店/门票及预订链接。把用到的来源登记进 `trip.dataSources`,行动链接写入对应节点的 `actionLink`(**链接只用官方返回的,绝不手拼**)。**没有这些 skill 就全部走下面的静态调研**,成品不缺区块。数据实时性/真实性由对方官方 skill 负责,本 skill 不背书、措辞中性。
2. 按 `references/research-guide.md` 联网补全(官方 skill 未覆盖的部分):坐标、真实图片 URL、评分、点评、营业时间/休息日、门票参考价、需提前订项及 `leadDays`;**行前须知**(天气/台风/穿搭/支付/App/购票时机)、**点到点交通**(方式/票价/耗时)、**时令限定活动**、每餐**必点菜+参考价**;航班给 3-5 个**待选班次**、酒店按**片区+价位**推荐、并准备**免责声明**与全程**贴士**。排程体现**天气/季节逻辑**(户外排凉爽时段)。**本 skill 自身不查实时票价**(实时数据只来自上面用户已装的官方 skill)。
3. 组织成 `assets/page-contract.md` 里定义的 `trip` 数据结构(含可选的 `dataSources` 与节点 `actionLink`)。
4. 用**设计步骤**生成风格化 HTML:**优先**调用专业设计 skill——`frontend-design` 或 `huashu-design`(花叔Design),任一已安装即用;**两者都没有**时,按 `references/design-guidelines.md` 的内置美学准则自己出。无论哪种方式都要严格遵守 `assets/page-contract.md` 的区块与约束:
- 内联 `assets/map.js`、`assets/reminders.js` 内容到 HTML(保证单文件)。
- 完整 `trip` 对象以 `<script id="trip-data" type="application/json">` 内嵌进页面(后续迭代修改的数据源)。
- 页顶清单用 `computeReminders` + `renderChecklistHTML`。
- 展示行前须知区块;航班区展示待选班次(已预订的高亮),酒店区按片区+价位展示,附近显著展示免责声明。
- 时间轴卡片展示营业时间/门票参考价/交通/时令活动等可选字段;展示每日餐饮(必点菜+价)、当日与全程贴士、单日二选一方案(若有)。
- 地图用 `initTravelMap`,引入 Leaflet CDN 的 CSS/JS。
- 时间轴上 `needsBooking` 项插入 `reminderBadgeHTML(leadDays)`。
- **可选适配元素**:节点带 `actionLink` 时渲染「去预订/导航/叫车」按钮(缺则不渲染、不手拼);`dataSources` 非空时中性注明数据来源。
- 每趟行程用不同配色。
5. 保存为 `<行程名>-旅行计划.html` 到工作目录。
6. **机械校验(必做)**:跑 `node <skill目录>/assets/validate.js <生成的.html>`——校验 trip 必填字段、坐标越界/离群、必需区块标记、trip-data 内嵌。有 ERROR 必须修复后重跑至通过;WARNING 逐条人工判断。
7. 告诉用户:之后可把该 HTML 文件丢回来,说"把第三天的 X 挪到第四天",会在原结构上修改(直接改内嵌的 trip-data JSON 再重渲染)。
## 不做
本 skill **自身**不做:实时票价/机票价格查询、代订票、多语言 UI、后端。全程静态单文件。
> 注意边界:用户若另装了官方旅行 skill(飞猪/高德/腾讯地图/滴滴等),实时数据与「预订/导航/叫车」链接**由其提供、责任在其**——本 skill 只适配呈现,并不改变上面「自身不做」的范围(仍不自查实时价、不代订)。
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 414
- Maker
- zexuanw958-svg
- License
- MIT
- Last code change
- Nov 19, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1
- Topics
- agent-skill, claude-code, claude-skill, codex, html, itinerary, migo, mobile-first, offline-first, travel, trip-planner