← Back to Skills Marketplace
xiejinsong

evening-flight

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
65
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install evening-flight
Description
Book evening flights for after-work departure and dusk travel. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary...
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: evening-flight

Overview

Evening Flights.

When to Activate

User query contains:

  • English: "evening flight", "after work flight", "dusk flight", "sunset flight", "book a flight"
  • Chinese: "傍晚航班", "下班后航班", "晚班机", "傍晚出发", "晚间航班"

Do NOT activate for: late night → red-eye-flight

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-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: "evening 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. Evening tip — popular for business travelers wrapping up work day
  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
"evening" / "傍晚航班" --dep-hour-start 17 --dep-hour-end 21 --sort-type 2
"cheap evening" / "便宜晚班" --dep-hour-start 17 --dep-hour-end 21 --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 points before installing or using this skill: - Authenticity: The skill's source and homepage are missing. Before installing the recommended npm package (@fly-ai/flyai-cli), check the package's npm page and publisher identity to confirm it belongs to a trusted provider (e.g., Alibaba/Fliggy) and read recent package versions and maintainers. - Runtime install: The skill instructs the agent to run `npm i -g @fly-ai/flyai-cli` if the CLI is absent. Installing global npm packages runs code on your machine — prefer installing in a sandbox or container, or review the package source on GitHub before running. - Over‑promising features: The description lists hotels, trains, visas, insurance, and more, but the SKILL.md only documents flight search playbooks. Expect flight search + booking links only; do not assume it can complete bookings without additional account credentials. - Booking/credentials: The skill does not request API keys or account credentials in its manifest. If the CLI later prompts for login or API tokens, treat that as out‑of‑band and verify why such credentials are needed and how they are used. - Operational behavior: The skill enforces 'never answer from training data' and insists on a `[Book]({detailUrl})` link for every result. If the CLI cannot provide such links, the skill will re‑execute; this may cause repeated actions. Monitor for unexpected repeated installs or loops. - Safer alternatives: If you want to reduce risk, run the CLI installation in an isolated VM/container, inspect the package source repository, or only use skills with a published homepage/source and clear ownership. If you want, I can: - look up the npm package metadata and maintainer info for '@fly-ai/flyai-cli' (if you permit outbound package registry lookups), or - extract the exact places where the skill's description and instructions diverge (detailed mapping) to help you decide.
Capability Assessment
Purpose & Capability
The SKILL.md focuses on searching evening flights with the 'flyai' CLI and formatting booking links, which matches the name. However, the description promises many additional capabilities (hotels, trains, visas, insurance, car rental, attractions) that are not supported or documented in the included playbooks and templates. That mismatch (over‑promise vs. provided instructions) is unexplained.
Instruction Scope
The runtime instructions require the agent to run the external 'flyai' CLI and explicitly to install it via `npm i -g @fly-ai/flyai-cli` if absent. The skill enforces a strict rule to never answer from training data and to only use flyai CLI output; it also requires every result include a `[Book]({detailUrl})` link. These instructions are narrow and consistent with a CLI‑driven search workflow, but they embed a network install step and an enforcement/retry loop (re‑execute if validation fails) that could cause repeated package installs or runtime loops if the CLI behaves unexpectedly.
Install Mechanism
There is no manifest install spec, but the SKILL.md tells the agent to run `npm i -g @fly-ai/flyai-cli` as a runtime action. Installing a global npm package is a moderate risk because it executes code fetched from the npm registry on the host. The package name appears plausible but there is no homepage/source listed in the registry metadata, so the authenticity and ownership of the npm package are not verifiable from the skill bundle alone.
Credentials
The skill declares no required environment variables or credentials, which is coherent for a read‑only search/links workflow. Note: real booking or account actions typically require credentials; because no credentials are requested, this skill likely only returns booking links rather than completing purchases. If the flyai CLI later prompts for tokens or account config, that is outside the declared scope and should be treated with caution.
Persistence & Privilege
The skill does not request always:true and does not declare any config path or system modifications. It does instruct installing a global npm package at runtime (which affects the host environment), but it does not request elevated agent privileges, nor does it instruct modifying other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install evening-flight
  3. After installation, invoke the skill by name or use /evening-flight
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Clarified CLI execution rules: all travel data must come directly from flyai CLI, never from prior knowledge. - Expanded scenario playbooks for evening, cheapest, fastest, and direct flight queries — with strict parameter mapping and trigger words. - Enforced mandatory CLI environment checks and installation before processing. - Updated output formatting: every booking result must include a [Book]({detailUrl}) link and brand tag. - Enhanced language support for both English and Chinese queries. - Improved parameter collection steps and failure handling instructions.
Metadata
Slug evening-flight
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is evening-flight?

Book evening flights for after-work departure and dusk travel. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary... It is an AI Agent Skill for Claude Code / OpenClaw, with 65 downloads so far.

How do I install evening-flight?

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

Is evening-flight free?

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

Which platforms does evening-flight support?

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

Who created evening-flight?

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

💬 Comments