geekjourneyx/travel-guidebook
Developer toolsThis page was translated automatically. Technical details may differ from the original. View the original
AI agent skill that generates beautifully typeset travel guidebook PDFs — from research to print, powered by parallel agents and Amap MCP.
Overview
An AI Agent Skill inputs a single sentence about travel needs and outputs a beautifully crafted travel guide PDF. It's not template filling, not stuffing information—it's a travel guide with **: parchment background, serif titles, inline SVG decorations, functional color information system, daily notes section. After installation, speak directly in Copilot CLI / Claude Code: Skill automatically identifies trigger words (such as waybooks, travel guides, itinerary planning, etc.) and initiates a complete 6-stage workflow. When images are loaded with loading="lazy", Playwright print mode will not trigger lazy loading. Solution: Make sure html2pdf.mjs includes image waiting logic, or change the image to loading="eager". The QPS cap for free keys is relatively low. Skill has a built-in de-escalation policy: if the API fails, it automatically rolls back to the LLM knowledge base data. It is recommended to avoid initiating more than 3 AutoNavi API requests simultaneously. Yes, it can. Skill automatically detects whether Amap MCP is available at Stage 0, and reverts to LLM knowledge mode when unavailable. Roadbook quality slightly declines (lacks real-time POI coordinates and images), but core functionality is complete. Modify the CSS variable in references/layout-css.md. Color scheme, font, font size, and spacing are all controlled via CSS custom properties.
Overview (machine translated)
A one-stop travel travel guide engine from research to book compilation
What is this?
An AI Agent Skill inputs a single sentence about travel needs and outputs a beautifully crafted travel guide PDF.
Not template filling, not stuffing information—but a travel guide with literary warmth:
Parchment paper background color, serif titles, inline SVG decorations, functional color information system, daily notes area.
Core Features
Workflow
Installation
Pre-dependencies
Install Skill
Amap MCP (Optional, Recommended)
After configuration, real-time POI data, walking routes, and bus plans can be obtained.
Apply for a Web Service API Key (free) on the Amap Open Platform.
Get started quickly
After installation, speak directly in Copilot CLI / Claude Code:
Skill automatically recognizes trigger words (such as travel guides, travel guides, itinerary planning, etc.),
Launch a complete 6-stage workflow.
Output example
Included in the roadbook
Design the system
Project Structure
Technology Stack
| Tier | Technology | Purpose |
|---|---|---|
| Agent Framework | Copilot CLI / Claude Code | Skill runtime environment |
| Parallel Research | explore agents × 4 | Transportation/Food/Attractions/Culture |
| Spatial Data | Amap MCP (Amap) | POI / Route / Weather |
| HTML Writing | general-purpose agent | Independent Context Writing |
| Layout Engine | CSS @page + break rules | A4 Precise pagination |
| Icon System | Tabler Icons (CDN) | 1800+ linear icons |
| Font | Google Fonts (CDN) | Chinese serif + sans serif + equal width |
| PDF Export | Playwright + Chromium | Print-grade rendering |
Frequently Asked Questions
Images not displayed in PDFs?
When images use loading="lazy", Playwright print mode does not trigger lazy loading.
Solution: Make sure html2pdf.mjs contains image waiting logic, or change the image to loading="eager".
Is Amap API reporting QPS restrictions?
The QPS upper limit for free keys is relatively low. Skill has a built-in de-escalation strategy: if the API fails, it automatically rolls back to the LLM knowledge base data.
It is recommended to avoid initiating more than three Amap API requests simultaneously.
Can you use it without Amap’s MCP?
Yes, you can.
This page was translated automatically. Technical details may differ from the original.
Recommended Tools
Try a different keyword or remove a filter.
Install
npx skillfish add geekjourneyx/travel-guidebook