travel-skill

Generate city travel itineraries, food recommendations, and routes using rule-based filtering and external APIs.

12|2|Updated Apr 16, 2026
One-click install
npx skills add https://github.com/Leon-KTlan/travel-skill --skill travel-skill-leon-ktlan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: travel-skill
Source: https://github.com/Leon-KTlan/travel-skill
Command: npx skills add https://github.com/Leon-KTlan/travel-skill --skill travel-skill-leon-ktlan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Generic AI travel advice often returns unordered lists of attractions, stale opening hours, and vague directions. This Skill turns natural-language travel requests into executable plans by parsing city, duration, crowd preference, budget, and travel type, then routing the request to recommendation rules, weather lookups, Amap route planning, or web search for the latest ticket and reservation policies. ## Core Features & Use Cases - Scenario-Based Recommendations: Filters attractions and restaurants by crowd level (S/A/B/C/D), duration (half-day/full-day/evening), budget, and travel type (couple, friends, family, solo), then outputs an executable play-plus-eat route instead of a raw list. - Tool-Augmented Queries: Calls QWeather for current conditions and 3-day forecasts with travel advice, Amap for geocoding and walking/driving/transit routes, and DuckDuckGo for the latest opening hours and booking policies. - Version Snapshots: Built-in snapshot and rollback tooling lets you version SKILL.md, references, and scripts before major edits. - Use Case: Ask "Plan a half-day in Hangzhou for a couple, avoid crowds, include dinner" and receive a structured route with a quiet West Lake walking segment, a tea-house stop, and a local restaurant with price and queue notes. ## Quick Start Ask the AI to plan a half-day couple-friendly itinerary in Hangzhou with low crowds and a local dinner included.

Frequently Asked Questions about travel-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a city travel itinerary from natural language?

Provide a query mentioning the city, duration, and preferences, such as a half-day in Hangzhou for a couple avoiding crowds. The helper script parses city, intent, crowd preference, budget, and travel type, then returns a structured profile and response outline for the itinerary.

What APIs does this travel planner use for weather and routes?

Weather queries use the QWeather API for current conditions and 3-day forecasts, while route planning uses the Amap (Gaode) API for geocoding, POI search, and walking, driving, or transit directions. Both require AMAP_KEY and WEATHER_KEY environment variables.

How does the skill decide between recommendation, weather, route, and search?

A keyword-based router inspects the query: weather terms trigger the weather client, origin-destination patterns trigger Amap routing, words like latest, opening hours, or ticket policy trigger web search, and everything else falls back to rule-based recommendation.

Does it support real-time crowd levels or queue times?

No. Crowd levels are static S/A/B/C/D ratings assigned in the data model, not live measurements. The documentation explicitly excludes real-time crowd density, exact queue minutes, and dynamic price monitoring from the current scope.

Which cities are supported by the travel recommendation rules?

The parser recognizes about fifteen Chinese cities including Shanghai, Hangzhou, Chengdu, Chongqing, Guangzhou, Shenzhen, Changsha, Beijing, Nanjing, Suzhou, Wuhan, and Xi'an. The MVP guidance recommends curating 15-20 attractions and 20-30 restaurants per city.

Why does the weather or route query return an error?

The most common cause is a missing AMAP_KEY or WEATHER_KEY environment variable, which the clients report explicitly. Route queries also fail if the origin or destination cannot be geocoded, so provide clear place names and optionally the city.