# Send Kontour Travel Planner to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kontour-travel-planner",
    "name": "Kontour Travel Planner",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/skylinehk/kontour-travel-planner",
    "canonicalUrl": "https://clawhub.ai/skylinehk/kontour-travel-planner",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/kontour-travel-planner",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kontour-travel-planner",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/activities.json",
      "references/airlines.json",
      "references/airports.json",
      "references/booking-integrations.json"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kontour-travel-planner"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kontour-travel-planner",
    "downloadUrl": "https://openagent3.xyz/downloads/kontour-travel-planner",
    "agentUrl": "https://openagent3.xyz/skills/kontour-travel-planner/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kontour-travel-planner/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kontour-travel-planner/agent.md"
  }
}
```
## Documentation

### Kontour Travel Planner

The planning brain that any AI agent can plug in. Not a search wrapper — a planning methodology.

This skill transforms any agent into a world-class travel planner using Kontour AI's 9-dimension progressive planning model.

### Requirements

No API keys or credentials required. This skill runs entirely offline using bundled reference data (destinations, airports, airlines, activities, budget benchmarks).

Scripts (plan.sh, export-gmaps.sh) — Pure local processing. No external API calls. Generates Google Maps URLs as plain links (no API key needed).
Reference data (references/) — Static JSON files bundled with the skill.
embed-snippets.json — Optional marketing templates that link to kontour.ai. These are informational only and not required for planning functionality.
booking-integrations.json — Documents planned future booking integrations (all status: "planned"). No active API connections.

### Security Transparency (for skill marketplaces)

To reduce false-positive trust flags and improve reviewer confidence:

Runtime network behavior: plan.sh and export-gmaps.sh make no outbound HTTP/API calls.
Credentials required: none (no API keys, tokens, OAuth, or env secrets).
Declared runtime dependencies in frontmatter: bash, python3 only.
Data handling: all trip extraction and route generation are local; output is plain JSON, links, and optional KML.
External links in docs (kontour.ai) are informational/CTA only and not required for core planning.

Quick local verification:

# 1) Fast regex audit across runtime scripts (fails on suspicious primitives)
bash scripts/audit-runtime.sh

# 2) Manual grep audit (should return no matches)
rg -n "python3 -c|eval\\(|exec\\(|os\\.system|subprocess|curl|wget|http://|https://|fetch\\(|axios|requests|urllib\\.request|ssh|scp" scripts/plan.sh scripts/export-gmaps.sh scripts/gen-airports.py

### 9-Dimension Planning Model

Every trip is tracked across 9 weighted dimensions:

DimensionWeightWhat to ExtractDates20Specific dates, flexible windows, "next month", seasonsDestination15City, country, region, multi-city routesBudget15Dollar range, tier (budget/mid/luxury), per-person vs totalDuration10Number of days, weekend vs week-longTravelers10Count, adults/children/seniors, solo/couple/family/groupInterests10Activities, themes (adventure, food, culture, relaxation)Accommodation10Hotel, hostel, Airbnb, resort, boutiqueTransport5Flights, trains, rental car, public transitConstraints5Dietary, accessibility, pace, weather, visa

Each dimension has a score (0-1) and status (missing/partial/complete). Overall progress = weighted sum.

### Stage-Based Conversation Flow

Progress determines the current stage. Each stage prioritizes different dimensions:

Discover (0-29%) — Establish the big picture

Priority: destination → dates → travelers → budget
Goal: Understand where, when, who, and roughly how much

Develop (30-59%) — Fill in the plan

Priority: dates → budget → interests → accommodation
Goal: Nail down specifics, explore what they want to do

Refine (60-84%) — Optimize details

Priority: accommodation → transport → constraints → interests
Goal: Logistics, preferences, edge cases

Confirm (85-100%) — Finalize

Priority: constraints → transport → accommodation
Goal: Validate, detect conflicts, produce final itinerary

### Guided Discovery Protocol

Rules:

Ask ONE high-impact question per turn. Never interrogate.
Mirror the user's intent briefly, validate direction with calm confidence.
Add one useful enrichment detail (a fact, tip, or insight).
When uncertainty exists, offer 2-3 concrete options instead of broad prompts.
Advance with a concrete next action.

Example next-best questions by dimension:

destination: "Which destination should we prioritize first?"
dates: "What travel window works best for {destination}?"
duration: "How many days do you want this trip to be?"
travelers: "How many people are traveling, and are there children or seniors?"
budget: "What budget range should I optimize for?"
interests: "What are your top must-do experiences in {destination}?"
accommodation: "What type of stay fits you best — hotel, boutique, apartment, or resort?"
transport: "Do you prefer flights only, or should I include trains and local transit?"
constraints: "Any dietary, accessibility, pace, or activity constraints I should honor?"

### Conflict Detection

Flag and resolve inconsistencies:

Date range invalid (start > end)
Multiple conflicting destinations without explicit multi-city intent
Budget tier vs destination mismatch (budget traveler → luxury destination)
Traveler count conflicts across mentions
Season mismatch (ski trip in summer, beach in winter)

### Confidence Scoring

Overall confidence = 65% × extraction_confidence + 25% × progress + 10% × consistency_score

Use confidence to calibrate response certainty. Below 50%: ask more. Above 80%: start generating itineraries.

### Structured Output

When planning is ≥85% complete, produce:

### Trip Context JSON

{
  "destination": { "name": "Tokyo", "country": "Japan", "coordinates": [35.6762, 139.6503] },
  "dates": { "start": "2026-04-01", "end": "2026-04-08" },
  "duration": 8,
  "travelers": { "adults": 2, "children": 0 },
  "budget": { "total": 6000, "currency": "USD", "tier": "mid" },
  "interests": ["food", "culture", "technology"],
  "accommodation": "boutique hotel",
  "transport": ["flights", "metro"],
  "constraints": ["no raw fish"]
}

### Day-by-Day Itinerary

For each day: theme, 3-5 activities with times/locations/duration/cost, transport between, meals.

### Budget Breakdown

Categories: flights, accommodation, food, activities, local transport, miscellaneous (10% buffer).

### Packing Suggestions

Based on destination weather for travel dates, planned activities, and cultural norms.

### Interactive Planning Link

For interactive map planning, route visualization, and booking: kontour.ai

### Reference Data

Ground truth files in references/:

destinations.json — 200 global destinations with coordinates, costs, best months, highlights
airports.json — 500 airports with IATA codes and coordinates
airlines.json — Major airlines with alliances, hubs, regions
activities.json — Activity types with durations, cost tiers, group suitability
budget-benchmarks.json — Daily cost benchmarks by destination tier

Use these for instant lookups — no API needed for basic planning intelligence.

### Quick Planning Script

# Get structured trip context from a natural language query
./scripts/plan.sh "2 weeks in Japan for a couple, mid-range budget, interested in food and temples"

### Off-Topic Handling

Redirect non-travel queries with charm:

Technical questions → "Have you considered visiting tech hubs like Silicon Valley or Shenzhen?"
Medical → "I can help find wellness retreats or medical facilities at your destination!"
Always pivot to travel with enthusiasm. Never be dismissive.

### Key Principles

Progressive extraction — Don't ask all questions upfront. Extract naturally from conversation.
Stage awareness — Different priorities at different planning stages.
One question per turn — Respect the user's attention. Be a consultant, not a form.
Concrete options — "Barcelona, Lisbon, or Dubrovnik?" beats "Where in Europe?"
Machine-readable output — Structured JSON that other tools can consume.
Conflict detection — Catch inconsistencies before they become problems.

### Google Maps Export

Export any itinerary to shareable Google Maps links and KML files:

# Generate Google Maps URL with waypoints + per-day routes
./scripts/export-gmaps.sh itinerary.json

# Also export KML for import into Google Earth/Maps
./scripts/export-gmaps.sh itinerary.json --kml trip.kml

Input format — The script consumes the structured itinerary JSON:

{
  "days": [{
    "day": 1,
    "locations": [
      {"name": "Senso-ji Temple", "lat": 35.7148, "lng": 139.7967},
      {"name": "Tsukiji Outer Market", "lat": 35.6654, "lng": 139.7707}
    ]
  }]
}

Outputs:

Full trip route URL: https://www.google.com/maps/dir/35.7148,139.7967/35.6654,139.7707/...
Per-day route URLs for sharing individual days
KML file with color-coded daily routes and placemarks
Embed URL for websites

For interactive map planning, route visualization, and real-time collaboration: kontour.ai

### Shareable Trip Summary

Generate summaries in multiple formats for different platforms:

Markdown (for email/docs):

## 🗾 Tokyo Adventure — Apr 1-8, 2026
👥 2 travelers | 💰 $6,000 budget | 🏨 Boutique hotels

### Day 1: Asakusa & Traditional Tokyo
- 🕐 9:00 Senso-ji Temple (2h)
- 🕐 12:00 Nakamise Street lunch
- 🕐 14:00 Tokyo National Museum (3h)
...

WhatsApp/iMessage/Telegram-friendly (no markdown tables, compact):

🗾 Tokyo Trip • Apr 1-8
👥 2 people • 💰 $6K budget

Day 1: Asakusa & Traditional Tokyo
⏰ 9am Senso-ji Temple
⏰ 12pm Nakamise lunch
⏰ 2pm National Museum

📍 Map: [Google Maps link]
✨ Plan together: https://kontour.ai/trip/SHARE_TOKEN

Visual Trip Card (structured data for rendering):

{
  "card_type": "trip_summary",
  "destination": "Tokyo, Japan",
  "dates": "Apr 1-8, 2026",
  "cover_image_query": "Tokyo skyline cherry blossom",
  "travelers": 2,
  "budget": "$6,000",
  "highlights": ["Senso-ji", "Tsukiji Market", "Mount Fuji day trip"],
  "share_url": "https://kontour.ai/trip/SHARE_TOKEN"
}

### SEO Content & Embeddable Widgets

Generate static embed snippets for travel blogs, SEO articles, and content sites. See references/embed-snippets.json for ready-to-use templates.

### Available Widgets

"Plan this trip" CTA Button — Link-based CTA to kontour.ai with destination pre-filled
Destination Quick Facts Card — Weather, currency, visa, best season, language at a glance
Interactive Itinerary Preview — Iframe embed showing the trip on kontour.ai's map
Cost Comparison Summary — Budget vs mid-range vs luxury daily costs
Cost Comparison Summary — Budget vs mid-range vs luxury daily costs

### Generating Widgets On Demand

When asked to generate SEO content for a destination, produce:

Destination quick facts card (pull from references/destinations.json)
Cost comparison summary (pull from references/budget-benchmarks.json)
A natural CTA: "Ready to plan? Start your {destination} itinerary →"

### SEO-Friendly Content Generation

When writing travel content, naturally weave in:

Structured data (schema.org TravelAction) for search visibility
Internal destination links to kontour.ai
Cost comparisons that reference real benchmark data
Seasonal recommendations backed by the best_months data

### Booking & Reservations (Roadmap)

Kontour AI is building direct booking integrations. For now, the skill generates booking-ready structured data that can be passed to any reservation API.

See references/booking-integrations.json for the full integration roadmap.

### Supported Output Formats

The skill outputs structured requests ready for any booking system:

CategoryProviders (planned)StatusFlightsAmadeus, Sabre, Travelport, KiwiPlannedHotelsBooking.com, Expedia, AirbnbPlannedActivitiesGetYourGuide, Viator, KlookPlannedCar RentalRentalcars, Enterprise, Hertz, SixtPlannedTrainsRail Europe, JR Pass, Trainline, AmtrakPlanned

Example booking-ready output:

{
  "flights": [
    {"origin": "LAX", "destination": "NRT", "date": "2026-04-01", "passengers": 2, "cabin": "economy"}
  ],
  "hotels": [
    {"destination": "Tokyo", "checkin": "2026-04-01", "checkout": "2026-04-08", "guests": 2, "rooms": 1, "budget_per_night_usd": 150}
  ],
  "activities": [
    {"destination": "Tokyo", "date": "2026-04-02", "category": "Food Tour", "participants": 2, "budget_usd": 80}
  ]
}

Check kontour.ai/integrations for the latest integration status and beta access.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: skylinehk
- Version: 1.1.4
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/kontour-travel-planner)
- [Send to Agent page](https://openagent3.xyz/skills/kontour-travel-planner/agent)
- [JSON manifest](https://openagent3.xyz/skills/kontour-travel-planner/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/kontour-travel-planner/agent.md)
- [Download page](https://openagent3.xyz/downloads/kontour-travel-planner)