← Back to Skills Marketplace
xiejinsong

early-bird-flight

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
64
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install early-bird-flight
Description
Book early bird flights with dawn departure and early morning deals. 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: early-bird-flight

Overview

Early Bird Flights.

When to Activate

User query contains:

  • English: "early bird flight", "dawn flight", "early morning flight", "6am flight", "first flight", "book a flight"
  • Chinese: "早班机", "清晨航班", "早鸟航班", "第一班飞机", "6点航班"

Do NOT activate for: general morning → morning-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: 3 (recommended)
--dep-hour-start No Departure hour filter start
--dep-hour-end No Departure hour filter 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: "early bird flight", "早班机"

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

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 3

Output Rules

  1. Conclusion first — lead with best option
  2. Early bird tip — flights before 7am are typically cheapest
  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
"early bird" / "早班机" --dep-hour-start 5 --dep-hour-end 8 --sort-type 3
"cheapest morning" / "最便宜早班" --dep-hour-start 5 --dep-hour-end 9 --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 appears to be a wrapper around an external CLI (flyai) and forces the agent to install `@fly-ai/flyai-cli` from npm if the CLI is missing. That means running unreviewed code on your system and potentially creating or using credentials that the skill doesn't declare. Before installing or invoking it: (1) Verify the npm package and its source repository (inspect its code, maintainer, and popularity) rather than blindly running `npm i -g` — prefer installing in a sandbox/container. (2) Ask the author how authentication is handled (does flyai require API keys or login?), and whether any tokens will be stored locally. (3) Avoid running global npm installs as root; run in an isolated environment. (4) If you cannot verify the flyai package or prefer not to allow runtime installs, choose a skill that documents an explicit, auditable install mechanism and authentication flow.
Capability Analysis
Type: OpenClaw Skill Name: early-bird-flight 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 shell commands based on user-provided parameters. While these actions are plausibly necessary for the stated flight-booking functionality, the automated installation of third-party software and the use of shell execution for CLI tools represent significant security risks (RCE and supply chain vulnerability) without a clear verification mechanism for the external package. These instructions are primarily found in SKILL.md and references/fallbacks.md.
Capability Assessment
Purpose & Capability
The skill claims to perform flight/hotel/train/attraction booking via a CLI called 'flyai', and the SKILL.md consistently instructs using that CLI — this is coherent. However, the skill does not declare an install spec or any credentials even though the CLI appears to be the primary integration point, which is an omission worth noting.
Instruction Scope
Instructions stay on-topic: they tell the agent to collect travel parameters, run specific flyai CLI commands, and format results. The SKILL.md does not instruct reading unrelated files, environment variables, or transmitting data to unexpected external endpoints.
Install Mechanism
No formal install spec is included, but the runtime instructions require running `npm i -g @fly-ai/flyai-cli` if the CLI is missing. Installing a third-party npm package globally at runtime can execute arbitrary code on the host; the package and its source are not referenced or audited in the skill metadata. This is a moderate-to-high risk operational pattern.
Credentials
The skill declares no required environment variables or primary credential, yet it depends entirely on an external CLI (flyai) that in real deployments commonly requires API keys, logins, or persisted tokens. The absence of declared credentials or instructions about authentication/storage is an incoherence — the skill may implicitly require credentials but does not ask for or document them.
Persistence & Privilege
The skill does not request persistent platform privileges (always: false) and does not modify other skills. However, its recommended global npm install creates system-wide state which increases risk; running the installer as root or outside a sandbox would be unwise.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install early-bird-flight
  3. After installation, invoke the skill by name or use /early-bird-flight
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
early-bird-flight v3.2.0 changelog: - Updated SKILL.md with stricter CLI execution rules and a more detailed workflow. - Clarified required and optional CLI parameters, including enforced use of only listed parameter flags. - Added detailed activation triggers and disambiguation for user queries. - Specified mandatory environment checks and installation steps for flyai-cli. - Expanded references to scenario playbooks and output templates for consistent results. - Emphasized output validation and rules for booking link inclusion.
Metadata
Slug early-bird-flight
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is early-bird-flight?

Book early bird flights with dawn departure and early morning deals. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, iti... It is an AI Agent Skill for Claude Code / OpenClaw, with 64 downloads so far.

How do I install early-bird-flight?

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

Is early-bird-flight free?

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

Which platforms does early-bird-flight support?

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

Who created early-bird-flight?

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

💬 Comments