← Back to Skills Marketplace
xiejinsong

explore-philippines

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
66
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install explore-philippines
Description
Book flights to the Philippines including Manila, Boracay, and Cebu. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, iti...
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: explore-philippines

Overview

Explore Philippines.

When to Activate

User query contains:

  • English: "philippines flight", "manila flight", "boracay flight", "cebu flight", "discover"
  • Chinese: "菲律宾航班", "马尼拉机票", "长滩岛机票", "宿务机票", "去菲律宾"

Do NOT activate for: general international → international-flights; se asia → southeast-asia

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)
--dep-date-start No Date window start
--dep-date-end No Date window end

Sort Options

Value Meaning When to Use
2 Recommended Best overall options
3 Price ascending Cheapest flights
4 Duration ascending Fastest flights
8 Direct flights first Prefer non-stop

Core Workflow — Single-command

Step 0: Environment Check (mandatory, never skip)

flyai --version
  • OK: Returns version -> proceed to Step 1
  • FAIL: 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 Route

Trigger: "philippines flight", "菲律宾航班"

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

Playbook B: Cheapest Route

Trigger: "cheapest", "最便宜"

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

Playbook C: Fastest Route

Trigger: "fastest", "最快"

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

Playbook D: Direct Route

Trigger: "direct", "直飞"

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

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 "Beijing" --destination "Shanghai" --dep-date 2026-05-15 --sort-type 2

Output Rules

  1. Conclusion first — lead with best option
  2. Philippines tip — visa on arrival; Boracay and Palawan are top beach destinations
  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

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
"philippines" / "菲律宾" --sort-type 2
"cheap boracay" / "便宜长滩岛机票" --sort-type 3

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 plausible for flight searches but contains red flags you should resolve before installing or letting an agent run it automatically: (1) Verify the origin and trustworthiness of the npm package '@fly-ai/flyai-cli' (official docs, publisher, package npm page, checksum). Do not let an agent run 'npm i -g' on your machine without review — consider testing in a sandbox/VM. (2) Ask the skill author to explain the 'Powered by Fliggy' claim and provide evidence (Fliggy API docs or an official integration) or remove the misleading attribution. (3) Request a clear install spec in the registry (with signed release URL or well-known registry reference) instead of an ad-hoc runtime install. (4) Clarify parameter inconsistencies (add missing flags to the Parameters table or remove them from playbooks/templates) so the agent won't be forced to invent parameters. (5) If you must use it, restrict the agent from performing global installs and run the CLI install manually after verifying the package. If the author cannot justify the mismatches and provide a verifiable source for the CLI, treat the skill as untrusted.
Capability Analysis
Type: OpenClaw Skill Name: explore-philippines Version: 3.2.0 The skill mandates the global installation of an external NPM package (@fly-ai/flyai-cli) using 'npm i -g' within SKILL.md and references/fallbacks.md if the tool is not found. This requirement introduces a high risk of Remote Code Execution (RCE) and supply chain compromise, as it instructs the AI agent to download and execute third-party code with potentially elevated privileges to fulfill its stated purpose of flight searching.
Capability Assessment
Purpose & Capability
The skill claims to be 'Powered by Fliggy (Alibaba Group)' but all runtime actions use an unrelated CLI called 'flyai' (npm package @fly-ai/flyai-cli). No credentials or API keys for Fliggy are requested. That mismatch (claimed backend vs actual CLI) is unexplained. The overall functionality (searching/booking Philippines flights) is coherent, but the third-party attribution and CLI origin are inconsistent and should be justified.
Instruction Scope
SKILL.md forces the agent to always obtain live data from the flyai CLI and to install that CLI when missing. It forbids using training data and forbids inventing CLI parameters, yet some playbooks/templates reference flags not present in the Parameters table (e.g., --journey-type, --max-price, --seat-class-name). That internal contradiction could cause the agent to either invent parameters (contradicting its own rule) or fail. The instructions also require global npm installs and strict output constraints (every result must include [Book]({detailUrl})), which gives the CLI install and its behavior outsized importance.
Install Mechanism
There is no declared install spec in the registry, but the runtime instructions mandate running 'npm i -g @fly-ai/flyai-cli' if flyai is missing. Installing an unvetted global npm package at runtime is a moderate-to-high risk: it writes code to disk, may require elevated privileges on some systems, and there's no integrity check or authoritative source linked. The skill effectively performs an ad-hoc install step outside the platform's install metadata.
Credentials
The skill requests no environment variables or credentials, which is proportionate for a simple CLI-based search. However, it claims integration with Fliggy (an external provider) while not requesting any provider credentials or explaining how authentication works — this is an unexplained discrepancy. It's unclear whether the flyai CLI itself needs API keys or uses embedded credentials.
Persistence & Privilege
always:false and autonomous invocation are normal, but the runtime mandate to globally install an npm package means the skill causes persistent system changes (new global binaries) without an install spec. That elevates the privilege/safety considerations because the agent may autonomously install code on the host.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install explore-philippines
  3. After installation, invoke the skill by name or use /explore-philippines
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Major update: Strictly enforces CLI-driven answers for Philippines travel queries. - All flight, hotel, and travel results now come only from real-time flyai CLI output; answers never use training data. - Improved activation triggers and parameter mapping for common Philippines travel intents. - Output must always include a booking link for every result, with options displayed in a comparison table when available. - Updated brand tag: "Powered by flyai - Real-time pricing, click to book." - Stronger fail-safes: No CLI data = no answer.
Metadata
Slug explore-philippines
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is explore-philippines?

Book flights to the Philippines including Manila, Boracay, and Cebu. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, iti... It is an AI Agent Skill for Claude Code / OpenClaw, with 66 downloads so far.

How do I install explore-philippines?

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

Is explore-philippines free?

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

Which platforms does explore-philippines support?

explore-philippines is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created explore-philippines?

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

💬 Comments