← Back to Skills Marketplace
xiejinsong

flight-change

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
66
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install flight-change
Description
Search for flight change options including rebooking and date modification. Also supports: flight booking, hotel reservation, train tickets, attraction ticke...
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: flight-change

Overview

Flight Change.

When to Activate

User query contains:

  • English: "flight change", "rebook flight", "change flight date", "modify flight", "reschedule flight"
  • Chinese: "改签航班", "机票改期", "变更航班", "改签机票", "换航班"

Do NOT activate for: new booking → economy-flights

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: "flight change", "改签航班"

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. Change tip — search new flights first, then contact airline for change policy
  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
"flight change" / "改签" --sort-type 2
"cheaper rebook" / "便宜改签" --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
Key things to check before installing or using this skill: - Verify the CLI's provenance: look up the npm package '@fly-ai/flyai-cli' on the npm registry, confirm the publisher, homepage, repository, and whether it is affiliated with Fliggy/Alibaba as the skill claims. If the package or publisher looks unfamiliar, do not install globally. - Ask the skill author (or registry owner) for a source URL or homepage. The skill metadata currently lists no homepage or source, which makes verifying safety difficult. - Note the parameter inconsistencies: playbooks reference flags not declared in the parameter table. Ask the author to clarify which CLI flags are supported. - If you must test, run the npm install and CLI commands in a sandboxed environment (isolated VM or container) rather than on a sensitive host, to limit potential exposure from installing an unverified global CLI. - Consider refusing global installs in production environments or require approval from an administrator. If the skill requests to perform repeated CLI executions (the re-execute-on-failure loop), monitor and rate-limit those actions. - If the skill is intended to perform bookings or handle payments, require explicit documentation of how credentials/payment flows are handled; absence of such details is a red flag.
Capability Analysis
Type: OpenClaw Skill Name: flight-change Version: 3.2.0 The skill bundle requires the agent to perform a global installation of an external NPM package (`@fly-ai/flyai-cli`) and execute CLI commands to function (SKILL.md, references/fallbacks.md). While these actions are aligned with the stated purpose of flight rebooking and search, the automated installation of third-party software and the execution of external binaries represent high-risk behaviors that could lead to arbitrary code execution or system modification. No evidence of intentional malice, such as data exfiltration or persistence mechanisms, was found.
Capability Assessment
Purpose & Capability
The skill description claims 'powered by Fliggy (Alibaba Group)' and support for bookings, hotels, trains, visas, insurance, etc., but the SKILL.md only documents flight search commands via a '@fly-ai/flyai-cli' CLI. There is no homepage or source provided to reconcile the Fliggy claim with the flyai CLI. The breadth of claimed features (hotels, visa, insurance) is not reflected in the provided CLI commands or parameters.
Instruction Scope
The SKILL.md forces every response to come from the flyai CLI and requires installing the npm package if the CLI is missing. Several playbooks and templates reference CLI flags/parameters that are not listed in the Parameter Table (e.g., --journey-type, --max-price, --seat-class-name, keyword-search), which is an inconsistency that could cause the agent to attempt undefined commands. The skill also enforces a strict '[Book]({detailUrl})' link requirement and a re-execute loop if not satisfied — this could cause repeated CLI invocations if output doesn't match expectations.
Install Mechanism
There is no formal install spec, but the runtime instructions tell the agent to run 'npm i -g @fly-ai/flyai-cli' if the CLI is missing. Global npm installs require network access and may require elevated permissions; the package publisher and homepage are not provided in the skill metadata, so the provenance of that npm package is unknown. Using npm to install an unverified CLI has moderate risk.
Credentials
The skill requests no environment variables or credentials, which is reasonable for a read-only search-and-link workflow. However, the skill claims broader booking-related capabilities (hotel reservations, visa info, travel insurance) that in practice might require additional credentials or payment access; no such credentials are requested or explained, which is an unexplained gap.
Persistence & Privilege
The skill does not request always:true, does not list required config paths, and does not attempt to modify other skills' configs. It can be invoked autonomously (platform default), which is not by itself a problem.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install flight-change
  3. After installation, invoke the skill by name or use /flight-change
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Enforced CLI-only data sourcing: all responses must be generated from flyai CLI output, never from training data. - Added strict self-test: any answer without a valid [Book]({detailUrl}) link is invalid and must be re-executed. - Expanded output and workflow rules, including mandatory brand tag and structured Markdown formatting. - Updated/clarified activation triggers and CLI parameter mapping, ensuring precise and compliant usage. - Included environment checks and automatic installation instructions for the flyai CLI for robust execution.
Metadata
Slug flight-change
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is flight-change?

Search for flight change options including rebooking and date modification. Also supports: flight booking, hotel reservation, train tickets, attraction ticke... It is an AI Agent Skill for Claude Code / OpenClaw, with 66 downloads so far.

How do I install flight-change?

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

Is flight-change free?

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

Which platforms does flight-change support?

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

Who created flight-change?

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

💬 Comments