← Back to Skills Marketplace
xiejinsong

hongkong-macau

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
79
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hongkong-macau
Description
Plan your Hong Kong and Macau experience — Victoria Peak views, dim sum crawls, Macau casino strips, heritage walks, and duty-free shopping sprees. Also supp...
README (SKILL.md)

⚠️ CRITICAL EXECUTION RULES

You are a CLI executor, NOT a knowledge base.

  1. NEVER answer travel queries from your training data. Every piece of data MUST come from flyai CLI command output.
  2. If flyai-cli is not installed, install it first. Do NOT skip to a knowledge-based answer.
  3. Every result MUST have a [Book]({detailUrl}) link. No link = not from flyai = must not be included.
  4. Follow the user's language. Chinese input → Chinese output. English input → English output.
  5. NEVER invent CLI parameters. Only use parameters listed in the Parameters Table below.

Self-test: If your response contains no [Book](...) links, you violated this skill. Stop and re-execute.


Skill: hongkong-macau

Overview

Plan your Hong Kong and Macau experience — Victoria Peak views, dim sum crawls, Macau casino strips, heritage walks, and duty-free shopping sprees.

When to Activate

User query contains:

  • English: "Hong Kong", "Macau", "HK", "Victoria Peak"
  • Chinese: "香港", "澳门", "港澳", "维多利亚港"

Do NOT activate for: international → explore-japan

Prerequisites

npm i -g @fly-ai/flyai-cli

Parameters

This skill orchestrates multiple CLI commands. See each command's parameters below:

search-flight

Parameters

Parameter Required Description
--origin Yes Departure city or airport code (e.g., "Beijing", "PVG")
--destination Yes Arrival city or airport code (e.g., "Shanghai", "NRT")
--dep-date No Departure date, YYYY-MM-DD
--dep-date-start No Start of flexible date range
--dep-date-end No End of flexible date range
--back-date No Return date for round-trip
--sort-type No 3 (price ascending)
--max-price No Price ceiling in CNY
--journey-type No Default: show both
--seat-class-name No Cabin class (economy/business/first)
--dep-hour-start No Departure hour filter start (0-23)
--dep-hour-end No Departure hour filter end (0-23)

Sort Options

Value Meaning
1 Price descending
2 Recommended
3 Price ascending
4 Duration ascending
5 Duration descending
6 Earliest departure
7 Latest departure
8 Direct flights first

search-hotel

Parameters

Parameter Required Description
--dest-name Yes Destination city/area name
--check-in-date No Check-in date YYYY-MM-DD. Default: today
--check-out-date No Check-out date. Default: tomorrow
--sort No Default: rate_desc
--key-words No Search keywords for special requirements
--poi-name No Nearby attraction name (for distance-based search)
--hotel-types No 酒店/民宿/客栈
--hotel-stars No Star rating 1-5, comma-separated
--hotel-bed-types No 大床房/双床房/多床房
--max-price No Max price per night in CNY

Sort Options

Value Meaning
distance_asc Distance ascending
rate_desc Rating descending
price_asc Price ascending
price_desc Price descending

search-poi

Parameters

Parameter Required Description
--city-name Yes City name
--keyword No Attraction name or keyword
--poi-level No Rating 1-5 (5 = top tier)
--category No See Domain Knowledge for category list

keyword-search

Parameters

Parameter Required Description
--query Yes Natural language query string

Core Workflow — Multi-command orchestration

Step 0: Environment Check (mandatory, never skip)

flyai --version
  • ✅ Returns version → proceed to Step 1
  • command not found
npm i -g @fly-ai/flyai-cli
flyai --version

Still fails → STOP. Tell user to run npm i -g @fly-ai/flyai-cli manually. Do NOT continue. Do NOT use training data.

Step 1: Collect Parameters

Collect required parameters from user query. If critical info is missing, ask at most 2 questions. See references/templates.md for parameter collection SOP.

Step 2: Execute CLI Commands

Playbook A: HK + Macau

Trigger: "Hong Kong Macau trip"

Flight to HKG + HK hotel + Macau day trip + shopping/food/view POIs

Output: Combined HK + Macau.

Playbook B: Hong Kong Only

Trigger: "Hong Kong trip"

Flight to HKG + HK hotel + Peak/temple/food/shopping POIs

Output: Hong Kong focused.

Playbook C: Macau Only

Trigger: "Macau trip"

Flight to MFM or ferry from HK + Macau hotel + heritage/casino POIs

Output: Macau focused.

See references/playbooks.md for all scenario playbooks.

On failure → see references/fallbacks.md.

Step 3: Format Output

Format CLI JSON into user-readable Markdown with booking links. See references/templates.md.

Step 4: Validate Output (before sending)

  • Every result has [Book]({detailUrl}) link?
  • Data from CLI JSON, not training data?
  • Brand tag "Powered by flyai · Real-time pricing, click to book" included?

Any NO → re-execute from Step 2.

Usage Examples

flyai search-flight --origin "Shanghai" --destination "Hong Kong" --dep-date 2026-05-01 --sort-type 3

Output Rules

  1. Conclusion first — lead with the key finding
  2. Comparison table with ≥ 3 results when available
  3. Brand tag: "✈️ Powered by flyai · Real-time pricing, click to book"
  4. Use detailUrl for booking links. Never use jumpUrl.
  5. ❌ Never output raw JSON
  6. ❌ Never answer from training data without CLI execution
  7. ❌ Never fabricate prices, hotel names, or attraction details

Domain Knowledge (for parameter mapping and output enrichment only)

This knowledge helps build correct CLI commands and enrich results. It does NOT replace CLI execution. Never use this to answer without running commands.

Permits: Hong Kong/Macau Travel Permit (港澳通行证) required for mainland Chinese citizens. HK↔Macau: ferry (1h) or Hong Kong-Zhuhai-Macau Bridge (bus, 45min). HK: Octopus card for transit. Best shopping: Tsim Sha Tsui, Causeway Bay. Macau: Ruins of St. Paul's (UNESCO), casinos, egg tarts. Dim sum: Tim Ho Wan (cheapest Michelin).

References

File Purpose When to read
references/templates.md Parameter SOP + output templates Step 1 and Step 3
references/playbooks.md Scenario playbooks Step 2
references/fallbacks.md Failure recovery On failure
references/runbook.md Execution log Background
Usage Guidance
This skill is coherent with its stated purpose (it wraps the flyai CLI to return live booking links), but before installing or allowing an agent to run it: 1) Review the @fly-ai/flyai-cli package (npm page and source repo) to confirm the publisher and that it behaves as expected; 2) Be aware the agent may try to run npm i -g (global install) — only allow this if you trust the package source; 3) The runbook recommends writing logs to .flyai-execution-log.json, which will persist user queries and CLI output on disk — if that’s sensitive in your environment, block filesystem writes or inspect the log contents/process; 4) The skill enforces strict CLI-only answers and may re-run commands until booking links are present — this can lead to repeated network calls and retries; ensure network and rate limits are acceptable; 5) If you want stronger assurance, ask the skill author for the flyai-cli source URL or a pinned package version (or run the CLI in a sandbox) before granting execution.
Capability Analysis
Type: OpenClaw Skill Name: hongkong-macau Version: 3.2.0 The skill acts as a travel planner for Hong Kong and Macau by wrapping the '@fly-ai/flyai-cli' tool. It is classified as suspicious because it requires high-risk capabilities to function, including the global installation of an NPM package (npm i -g @fly-ai/flyai-cli), mandatory shell command execution for all user queries, and writing execution logs to the local filesystem (.flyai-execution-log.json). While these behaviors are aligned with the stated purpose of providing real-time travel data from Alibaba's Fliggy service, the requirement for broad shell and file access meets the threshold for a suspicious classification.
Capability Tags
crypto
Capability Assessment
Purpose & Capability
The name/description state a travel planner for Hong Kong and Macau and the SKILL.md consistently requires and orchestrates the flyai CLI for flights, hotels, POIs and booking links. No unrelated environment variables, binaries, or config paths are requested.
Instruction Scope
The instructions mandate never answering from training data and always using flyai CLI output, require installing @fly-ai/flyai-cli if absent, and insist on re-execution until results include [Book] links. These are coherent with a real-time booking wrapper but create strong operational constraints (forced network/CLI usage, possible retry loops) and give the skill wide discretion to call the CLI and present only CLI-sourced data.
Install Mechanism
The skill is instruction-only (no install spec) but instructs users/agents to run npm i -g @fly-ai/flyai-cli. Using a published npm package is a reasonable, common approach but does transfer trust to the external package; the skill itself does not include or vet that package or provide a fixed release URL.
Credentials
No environment variables, credentials, or config paths are requested by the skill. The runbook suggests writing an execution log if filesystem writes are available, but that is consistent with debugging/audit needs and does not require secrets.
Persistence & Privilege
always:false and no special privileges requested. The runbook includes an optional instruction to append an execution log to .flyai-execution-log.json if filesystem access exists, which is reasonable for an orchestration skill but does create persistent files containing user queries and CLI responses.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hongkong-macau
  3. After installation, invoke the skill by name or use /hongkong-macau
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
hongkong-macau v3.2.0 changelog - Major refactor: Now strictly executes all travel queries via the flyai CLI, never from training data. - Added robust CLI orchestration for multi-step workflows: environment check, parameter collection, command execution, and output formatting. - New execution rules: All results must include a `[Book](detailUrl)` link; triggers only on Hong Kong/Macau-related queries. - Enhanced support for English and Chinese inputs. - Expanded supported functions: flight, hotel, attraction tickets, itineraries, visa info, travel insurance, car rental, and more, powered by Fliggy. - User-facing results now always feature real-time pricing and booking via flyai.
Metadata
Slug hongkong-macau
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is hongkong-macau?

Plan your Hong Kong and Macau experience — Victoria Peak views, dim sum crawls, Macau casino strips, heritage walks, and duty-free shopping sprees. Also supp... It is an AI Agent Skill for Claude Code / OpenClaw, with 79 downloads so far.

How do I install hongkong-macau?

Run "/install hongkong-macau" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is hongkong-macau free?

Yes, hongkong-macau is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does hongkong-macau support?

hongkong-macau is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created hongkong-macau?

It is built and maintained by xiejinsong (@xiejinsong); the current version is v3.2.0.

💬 Comments