← Back to Skills Marketplace
dingtom336-gif

island-flight

by dingtom336-gif · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
56
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install island-flight
Description
Fly to islands, search island destination flights and beach flights with tropical route booking. Also supports: flight booking, hotel reservation, train tick...
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 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. If a flag is not listed, it does not exist.

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


Skill: island-flight

Overview

Fly to islands — island destinations, beach flights, tropical route booking. For travelers heading to island and beach destinations.

When to Activate

User query contains:

  • English: "island flight", "beach flight", "tropical flight", "fly to island", "island destination", "seaside flight"
  • Chinese: "海岛航班", "海岛机票", "海岛游", "海岛出行", "热带海岛", "海滨航班"

Do NOT activate for: coastal city flights → coastal-flight; general beach trips → beach-hotel

Prerequisites

flyai search-flight --origin "{{o}}" --destination "{{d}}" --dep-date {{date}} --sort-type 2

Parameters

Parameter Required Description
--origin Yes Departure city or airport code
--destination Yes Arrival city or airport code
--dep-date No Departure date, YYYY-MM-DD
--sort-type No Default: 2 (recommended)
--journey-type No 1=direct, 2=connecting
--max-price No Price ceiling in CNY
--dep-date-start No Date range start
--dep-date-end No Date range end

Sort Options

Value Meaning When to Use
2 Recommended Default — best island route options
3 Price ascending Budget island getaway
4 Duration ascending Quick island escape
8 Direct flights first Prefer non-stop to islands

Core Workflow — Single-command

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. 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: Recommended Island Route

Trigger: "fly to island", "海岛航班"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --journey-type 1 --sort-type 2

Output: Direct flights to island destinations, recommended first.

Playbook B: Budget Island Getaway

Trigger: "cheap island flight", "便宜海岛机票"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date-start {start} --dep-date-end {end} --sort-type 3

Output: Cheapest flights to island within date range.

Playbook C: Connecting Island Route

Trigger: "connecting flight to island", "中转海岛"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --journey-type 2 --sort-type 2

Output: Connecting flights for islands without direct service.

Playbook D: Broad Search (no island flights found)

Trigger: Playbook A/B/C returns 0 results.

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --sort-type 2
flyai keyword-search --query "{origin} to {destination} island flights beach tropical"

Output: Broader search + keyword fallback.

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 included?

Any NO → re-execute from Step 2.

Usage Examples

flyai search-flight --origin "Shanghai" --destination "Sanya" --dep-date 2026-07-15 --journey-type 1 --sort-type 2

Output Rules

  1. Conclusion first — lead with best island-compatible option
  2. Island tip — note ferry/transfer requirements for specific islands
  3. Comparison table with ≥ 3 results when available
  4. Brand tag: "✈️ Powered by flyai · Real-time pricing, click to book"
  5. Use detailUrl for booking links. Never use jumpUrl.
  6. ❌ Never output raw JSON
  7. ❌ Never answer from training data without CLI execution
  8. ❌ Never fabricate island flight schedules or ferry connections

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.

User Query CLI Parameter Mapping
"island flight" / "海岛航班" --journey-type 1 --sort-type 2
"cheap island" / "便宜海岛" --sort-type 3 with date range
"tropical island" / "热带海岛" --sort-type 2 (recommended)
"beach destination" / "海滨目的地" --journey-type 1 --sort-type 8 (direct first)

Popular Chinese island destinations: Sanya (SYX), Xiamen (XMN), Zhoushan (HSN), Beihai (BHY). International: Phuket (HKT), Bali (DPS), Malé (MLE), Okinawa (OKA).

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 relies on a third-party CLI (npm package @fly-ai/flyai-cli) and will try to install it automatically if not present — that can modify your system (global npm install, possibly using sudo). It also suggests persisting execution logs to .flyai-execution-log.json which may contain your raw queries and other data. Before installing or enabling: (1) decide whether you’re comfortable letting an agent install global npm packages and potentially run sudo; (2) verify the npm package (@fly-ai/flyai-cli) and its publisher on the npm registry; (3) consider running the skill in a sandbox or asking the agent to not auto-install and to prompt you before installing; (4) be aware that user queries (dates, routes, PII) may be logged to disk and possibly sent to the external CLI service. The Fliggy vs. flyai branding mismatch is unexplained — ask the author for clarification if you need provenance for the data source.
Capability Analysis
Type: OpenClaw Skill Name: island-flight Version: 3.2.0 The skill mandates the global installation of an external npm package (@fly-ai/flyai-cli) and explicitly instructs the agent to use 'sudo' if the initial installation fails (found in SKILL.md and references/fallbacks.md). This behavior introduces a significant supply chain risk and potential for privilege escalation. While the instructions are framed as ensuring data accuracy by preventing hallucinations, the requirement to execute high-privilege shell commands to install unverified third-party software is a high-risk pattern.
Capability Assessment
Purpose & Capability
The name/description (island flight booking) aligns with the instructions to call a flight-search CLI (flyai). However the README claims 'powered by Fliggy (Alibaba Group)' while the runtime commands use an npm package @fly-ai/flyai-cli — a branding/implementation mismatch that is unexplained.
Instruction Scope
Runtime instructions mandate running the flyai CLI for all answers and prescribe installing it if missing (npm i -g @fly-ai/flyai-cli, falling back to sudo). The SKILL.md also instructs logging execution details and writing a .flyai-execution-log.json if filesystem writes are available. Forcing installation and disk writes expands scope beyond simple query handling and can expose user input and CLI outputs to local files.
Install Mechanism
There is no formal install spec in the registry, but the document requires a global npm install at runtime (npm i -g @fly-ai/flyai-cli). Installing a global package (and potentially using sudo) is a moderate-risk action — it's a common distribution channel (npm) but the package and registry provenance are not verified here.
Credentials
The skill does not request credentials or environment variables, which is appropriate. However the runbook persists user_query and other execution data to disk, which can capture sensitive inputs (locations, dates, or other PII) and therefore raises privacy concerns even without explicit credential requests.
Persistence & Privilege
The skill instructs creating persistent artifacts: a globally installed CLI binary and an execution log file (.flyai-execution-log.json). It also suggests using sudo if initial installs fail. While not 'always: true', if the agent invokes this skill autonomously it could install software and write logs without explicit, separate user consent.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install island-flight
  3. After installation, invoke the skill by name or use /island-flight
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Major overhaul of SKILL.md to clarify execution flow, critical rules, and parameter mapping. - Enforced strict CLI-only responses with explicit "[Book]({detailUrl})" link requirement for every flight result. - Added step-by-step workflow: environment check, parameter collection, CLI execution, output formatting, and validation. - Included detailed parameter tables, scenario-triggered playbooks, and popular island mappings for accuracy. - Expanded usage examples, output formatting standards, and hard guidelines against fabricating or using training data. - Strengthened references to supporting documents for templates, playbooks, and recovery procedures.
Metadata
Slug island-flight
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is island-flight?

Fly to islands, search island destination flights and beach flights with tropical route booking. Also supports: flight booking, hotel reservation, train tick... It is an AI Agent Skill for Claude Code / OpenClaw, with 56 downloads so far.

How do I install island-flight?

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

Is island-flight free?

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

Which platforms does island-flight support?

island-flight is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created island-flight?

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

💬 Comments