← Back to Skills Marketplace
dingtom336-gif

afternoon-flight

by dingtom336-gif · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
63
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install afternoon-flight
Description
Book afternoon flights with midday and PM departure options. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary p...
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: afternoon-flight

Overview

Afternoon Flights.

When to Activate

User query contains:

  • English: "afternoon flight", "pm flight", "midday flight", "lunch time flight", "book a flight"
  • Chinese: "下午航班", "午间航班", "午后航班", "下午出发", "订机票"

Do NOT activate for: morning → early-bird-flight or 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: 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: "afternoon 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. Afternoon tip — 12-17h departures offer balanced schedule
  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
"afternoon" / "下午航班" --dep-hour-start 12 --dep-hour-end 17 --sort-type 2
"cheap afternoon" / "便宜下午航班" --dep-hour-start 12 --dep-hour-end 17 --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 instruction-only and instructs the agent to install and use a third-party CLI (@fly-ai/flyai-cli) to run flight searches and produce booking links. Before installing or enabling it, consider: (1) Verify the npm package publisher and authenticity of @fly-ai/flyai-cli (scoped npm packages can be published by anyone); (2) be aware that 'npm i -g' modifies the host (requires admin/sudo on many systems); (3) the skill does not declare how booking authentication is handled — you may need a Fliggy/third-party account or API keys that are not mentioned; (4) the descriptive text claims hotel/train/attraction support but the instructions only implement flight searches — ask the maintainer for clarification if you need those other features; (5) if you do not want agents to install software automatically, do not grant the agent permission to perform installs or run it in an environment where global npm installs are blocked. If you decide to proceed, test in a sandbox (or non-production environment), and verify booking links and CLI behavior manually before providing any account credentials.
Capability Analysis
Type: OpenClaw Skill Name: afternoon-flight Version: 3.2.0 The skill bundle instructions in SKILL.md and references/fallbacks.md direct the AI agent to automatically perform a global installation of an external NPM package (@fly-ai/flyai-cli) if the command is missing. While this is intended to ensure the flight-booking tool functions correctly, the practice of auto-installing software with global privileges represents a significant security risk and a potential vector for supply chain attacks or remote code execution (RCE). No explicit evidence of malicious intent, such as data exfiltration or backdoors, was found, but the automated installation of unverified third-party code is a high-risk behavior.
Capability Assessment
Purpose & Capability
The skill's declared purpose is booking 'afternoon' flights and the SKILL.md consistently instructs using the flyai CLI to perform searches and produce booking links — this is coherent. However, the top-level description claims support for hotels, trains, attractions, visa info, insurance, car rental and more, yet the runtime instructions and playbooks only cover flight search CLI commands. That mismatch (expanded marketing description vs. strictly flight-focused instructions) is unexplained and could mislead users.
Instruction Scope
The instructions are tightly scoped to running the flyai CLI, mapping user queries to CLI flags, formatting CLI JSON into user-friendly output, and enforcing that results come from the CLI (every result must include a [Book](detailUrl) link). The skill does not instruct reading arbitrary files or exfiltrating environment data. Note: it mandates installing and running a global npm package if flyai is not present, which is a runtime side-effect (see install_mechanism).
Install Mechanism
Although the registry entry contains no formal install spec, the runtime rules instruct the agent to run 'npm i -g @fly-ai/flyai-cli' when the CLI is missing. Installing an npm package globally at runtime requires network access and will write to the host system (moderate risk). The package name uses an @scope which is plausible but the skill provides no checksum, vendor homepage, or verification guidance. This is a legitimate install step for a CLI-based skill, but it increases risk compared to an instruction-only skill that uses preinstalled trusted binaries.
Credentials
The skill declares no required environment variables or credentials, but it states it is 'powered by Fliggy (Alibaba Group)' and relies entirely on the flyai CLI to fetch results and booking links. The SKILL.md does not explain how authentication is handled (e.g., whether the CLI needs Fliggy credentials, OAuth flows, API keys, or user login). That omission is important: either the CLI uses local user credentials, an interactive login, or environment variables — none are declared. The absence of credential guidance is disproportionate given the booking capability.
Persistence & Privilege
The skill does not request always: true and is user-invocable only. However, runtime behavior includes installing a global npm package, which writes persistent system-wide files and may persist a program that will be invoked in future sessions. The skill does not claim to modify other skills or system-wide agent settings beyond installing the CLI; still, users should expect the install side-effect.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install afternoon-flight
  3. After installation, invoke the skill by name or use /afternoon-flight
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
afternoon-flight 3.2.0 changelog: - Expanded description to highlight additional supported services (hotel, train, attractions, etc.). - Added strict CLI-only execution rules: never answer from knowledge, always use flyai CLI. - Clarified activation keywords for both English and Chinese queries. - Improved parameter and playbook documentation, including new mapping tables for advanced scenarios. - Output formatting rules updated: lead with best option, comparison table, enforce branded booking links.
Metadata
Slug afternoon-flight
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is afternoon-flight?

Book afternoon flights with midday and PM departure options. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary p... It is an AI Agent Skill for Claude Code / OpenClaw, with 63 downloads so far.

How do I install afternoon-flight?

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

Is afternoon-flight free?

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

Which platforms does afternoon-flight support?

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

Who created afternoon-flight?

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

💬 Comments