← Back to Skills Marketplace
xiejinsong

FlyAI Flight Tracker

by xiejinsong · GitHub ↗ · vv3.2.0 · MIT-0
cross-platform ⚠ suspicious
74
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install flyai-flight-tracker
Description
Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to b...
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: flight-tracker

Overview

Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to book.

When to Activate

User query contains:

  • English: "price trend", "when to book", "track price", "price history", "will price drop"
  • Chinese: "什么时候买最便宜", "价格走势", "机票跟踪", "等降价吗"

Do NOT activate for: flexible dates → flexible-flights

Prerequisites

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

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

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. 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: 7-Day Trend

Trigger: "price trend this week"

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

Output: Show daily lowest as trend table.

Playbook B: Advance Booking Compare

Trigger: "book now or wait?"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {target} --sort-type 3
# Compare with historical patterns from knowledge

Output: Show current price + booking window advice.

Playbook C: Best Day in Month

Trigger: "cheapest day in June"

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

Output: Full month scan, highlight cheapest day/week.

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 "Beijing" --destination "Shanghai" --dep-date-start 2026-05-01 --dep-date-end 2026-05-14 --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.

Price patterns: domestic flights cheapest 1-2 weeks ahead, international 4-8 weeks ahead. Prices drop Tuesday mornings, spike Friday afternoons. Holiday prices start rising 6-8 weeks ahead. Airlines release cheapest fares on Tuesdays. Monday evening searches often show lower prices.

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
Before installing or enabling this skill: (1) Verify the provenance of '@fly-ai/flyai-cli' — check its npm page and source repo; do not blindly run 'npm i -g' as it executes code on your system. (2) Confirm whether the CLI requires API credentials or login (none are declared in the skill). If it does, ask the author why credentials aren't declared and where they are stored. (3) Ask the skill author to resolve the contradiction between 'NEVER answer from training data' and the instruction to 'compare with historical patterns from knowledge.' (4) Prefer skills that publish a homepage or repository so you can audit the CLI code and read its privacy/security policy. (5) If you decide to proceed, consider installing the CLI manually in a controlled environment (not via an autonomous agent) and inspect what network calls it makes and where it stores tokens. (6) If you cannot verify the CLI's safety and provenance, treat this skill as untrusted.
Capability Analysis
Type: OpenClaw Skill Name: flyai-flight-tracker Version: v3.2.0 The skill requires the global installation of an NPM package (@fly-ai/flyai-cli) and performs direct shell command execution to fetch flight data. While these capabilities are aligned with the stated purpose of a flight tracker, the requirement for system-level modifications and the assertive instructions in SKILL.md that force the agent to install software and bypass its training data represent high-risk behaviors. No clear evidence of malicious intent or data exfiltration was found, but the execution model grants significant system access.
Capability Assessment
Purpose & Capability
The name/description (flight price tracking) aligns with the instructions to call a flyai CLI. However the SKILL.md requires installing a third-party npm package at runtime even though the registry metadata includes no install spec or provenance (no homepage/source). The README references a GitHub parent skill but the registry source is 'unknown', which weakens provenance.
Instruction Scope
The SKILL.md tightly constrains answers to data obtained from the flyai CLI and forbids using training data — but a playbook (Playbook B) explicitly says to 'Compare with historical patterns from knowledge', which contradicts the 'NEVER answer from training data' rule. The instructions also force the agent to run an npm -g install if the CLI is missing; that action performs network installs and is outside the skill's declared metadata. The playbooks/ references are local paths that may not exist in the runtime environment, adding operational fragility.
Install Mechanism
There is no formal install spec in the registry, but the SKILL.md instructs running 'npm i -g @fly-ai/flyai-cli' when flyai is missing. That causes a network download and global package installation at runtime—potentially arbitrary code execution from npm. Using npm is common, but the skill does not declare the package's provenance, required permissions, or whether it needs API credentials.
Credentials
The skill declares no required environment variables or credentials. In practice, a CLI that queries real-time booking data often requires API keys or login tokens; those are not declared. This mismatch (no declared secrets but likely external service access) is a red flag: verify whether the flyai CLI requires authentication and what it stores/uses before installing.
Persistence & Privilege
The skill does not request 'always: true' or other elevated platform privileges. It also does not claim to modify other skills or system-wide configuration. The main persistence concern is the agent-driven global npm install called at runtime, but that is not a declared platform privilege.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install flyai-flight-tracker
  3. After installation, invoke the skill by name or use /flyai-flight-tracker
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
vv3.2.0
- New execution rules enforce that all responses must use live flyai CLI data and include booking links, with strict output validation. - Expanded supported features: hotel reservation, train tickets, attraction tickets, itinerary planning, visa info, travel insurance, car rental, and more — all via Fliggy (Alibaba Group). - Added detailed scenario playbooks for common flight price tracking and booking timing queries (e.g., price trends, best day to book). - Revised parameters table and usage guidance to ensure only documented CLI options are used. - Strict Chinese/English response logic based on user input language. - Enhanced compliance checks to prevent fallback to model knowledge or fabricated results.
Metadata
Slug flyai-flight-tracker
Version v3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is FlyAI Flight Tracker?

Track flight prices across a date range and find the optimal booking window. Shows day-by-day price comparison charts to spot trends and the best moment to b... It is an AI Agent Skill for Claude Code / OpenClaw, with 74 downloads so far.

How do I install FlyAI Flight Tracker?

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

Is FlyAI Flight Tracker free?

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

Which platforms does FlyAI Flight Tracker support?

FlyAI Flight Tracker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created FlyAI Flight Tracker?

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

💬 Comments