🗺️ schedule-planner-cxf

All-in-one Travel Planning Skill for Claude Code
Plan trips, compare transport options, search hotels, book tickets, and generate itinerary pages with QR payment codes.

✨ Features

| Feature | Description | |---------|-------------| | Multi-Transport Comparison | Compare flight vs train vs driving (time, cost, comfort) | | Multi-Date Price Comparison | Compare prices across ±3 days to find the best deal | | Flight Search & Booking | Search lowest fares, view details, create orders | | Hotel Search & Booking | Search by city/location, compare value, book rooms | | Train Ticket Booking | Search and book train tickets | | Route & Weather | Get driving directions and destination weather via AMap | | Itinerary Page | Generate a beautiful HTML trip summary with QR payment codes | | Smart Recommendations | AI-powered suggestions based on budget, time, and preferences |

🚀 Installation

# Install from npm (auto-installs the skill for Claude Code)
npm install -g schedule-planner-cxf

# Or install locally
npm install schedule-planner-cxf

After installation, the skill is automatically available in Claude Code.
Just ask: "Plan a trip from Beijing to Shanghai for 3 days" or "Find me a hotel in Hangzhou"

📋 Prerequisites

The skill relies on external services for live data:

| Service | Purpose | How to Get | |---------|---------|------------| | AMap (高德地图) | Route planning, weather, POI search | AMap Console — API Key | | Tuniu (途牛) | Flight/hotel/train booking | Install tuniu-cli via npm |

Set your API keys as environment variables:

export AMAP_API_KEY=your_amap_api_key
export TUNIU_API_KEY=your_tuniu_api_key

🎯 Usage Examples

Plan a Business Trip

"I need to go to Shanghai for a business meeting next week, 3 days"

The skill will:

1. Detect it's a business trip scenario
2. Ask for departure city and preferences
3. Compare transport options (flight vs train)
4. Search hotels near your meeting location
5. Present options with recommendations
6. Book on your confirmation
7. Generate an itinerary page with QR code for payment

Plan a Vacation

"Planning a family trip to Sanya, 5 days, 2 adults and 1 child"

The skill will:

1. Detect vacation scenario with family
2. Recommend family-friendly hotels and activities
3. Suggest multi-area accommodation for longer trips
4. Provide detailed attraction introductions
5. Handle the full booking flow

🏗️ Project Structure (npm package)

schedule-planner-cxf/
├── package.json        # npm package config
├── index.js            # Skill installer
├── cli.js              # CLI entry (npx)
├── SKILL.md            # Claude Code skill definition (instructions for AI)
└── README.md           # This file

When installed, SKILL.md is copied to ~/.claude/skills/schedule-planner-cxf/ and automatically loaded by Claude Code.

📝 Version History

| Version | Date | Changes | |---------|------|---------| | 1.0.9 | 2026-06-10 | English version with proper npm metadata | | 1.0.8 | 2026-06-09 | Latest features and fixes | | 1.0.0 | 2026-04-17 | Initial release |

👤 Author

cryptocxf — GitHub

📄 License

MIT