← Back to Skills Marketplace
bufferstreamer

lunar-new-year-flight

by bufferstreamer · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
71
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install lunar-new-year-flight
Description
Book Lunar New Year flights for Spring Festival reunion and Chinese New Year travel. Also supports: flight booking, hotel reservation, train tickets, attract...
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: lunar-new-year-flight

Overview

Lunar New Year Flights.

When to Activate

User query contains:

  • English: "lunar new year flight", "chinese new year flight", "spring festival flight", "cny flight", "book a flight"
  • Chinese: "春运机票", "春节航班", "年夜饭航班", "回乡过年机票", "除夕航班"

Do NOT activate for: general holiday → holiday-flights; golden week → golden-week

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: "lunar new year 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. Spring Festival tip — book 60+ days ahead; outbound peak: day -7 to -1
  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
"lunar new year" / "春运" --sort-type 2
"cheap cny flight" / "便宜春运机票" --sort-type 3
"spring festival direct" / "春节直飞" --journey-type 1 --sort-type 2

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: - Brand mismatch: the description mentions Fliggy (Alibaba) but the runtime uses a CLI called "flyai" (@fly-ai/flyai-cli). Ask the publisher which service is actually being queried and why the branding differs. - npm install risk: the skill tells the agent to run npm i -g @fly-ai/flyai-cli at runtime. Only proceed if you trust the @fly-ai package. Inspect the package on the npm registry (maintainer, README, code) before installing, and avoid installing globally on a production or privileged host (use a sandbox or container). - Authentication ambiguity: the skill never documents how the CLI authenticates to booking providers. Confirm whether the CLI requires login, API keys, or stores tokens locally; don’t provide credentials until you understand where they are stored and who controls them. - Execution behavior: the skill enforces strict rules (must use CLI, must include [Book](detailUrl) links, must re-execute on failure) — this can force repeated installs/executions. Consider limiting retries or running the CLI manually once to validate output. - If you lack a way to safely inspect the npm package, consider not installing this skill. If you proceed, run the CLI in an isolated environment (VM, container) first to confirm behavior and to verify that search results and booking links are legitimate and do not redirect to unexpected endpoints.
Capability Analysis
Type: OpenClaw Skill Name: lunar-new-year-flight Version: 3.2.0 The skill mandates the automatic global installation of an external npm package (@fly-ai/flyai-cli) via 'npm i -g' if the command is not found, as seen in SKILL.md and references/fallbacks.md. While this behavior is functionally linked to the flight-searching purpose, requiring an AI agent to perform global software installations and execute shell commands poses a significant security risk for supply-chain attacks or unauthorized system modification.
Capability Assessment
Purpose & Capability
The skill's stated description says it's "powered by Fliggy (Alibaba Group)" and promises Fliggy-brand flight/hotel functionality, yet every runtime instruction uses a third-party CLI named "flyai" (npm package @fly-ai/flyai-cli) and repeatedly brands outputs "Powered by flyai." This brand mismatch is unexplained and inconsistent with the stated source. Otherwise, requiring a CLI to query live flight data is plausible for a booking skill.
Instruction Scope
SKILL.md tightly constrains behavior: it forbids using training data and mandates all answers come from the flyai CLI; it instructs installing the CLI (npm i -g @fly-ai/flyai-cli) if missing and to abort if install still fails. This is reasonable for a CLI-backed skill, but the instructions do not address authentication (how the CLI gets access to booking APIs) and include a strict self-test that forces re-execution if booking links are absent — raising the risk of repeated install/execute loops or degraded UX. The skill does not instruct reading unrelated files or exfiltrating secrets, but it gives the agent broad procedural freedom to install and run global commands.
Install Mechanism
There is no declared install spec in metadata, but the runtime instructions explicitly instruct installing a global npm package (npm i -g @fly-ai/flyai-cli) from the public npm registry. Installing a public npm package is a typical way to get a CLI, but doing so at runtime and globally modifies the host environment and relies on an external package whose provenance isn't documented. This is moderate risk compared to a vetted release host; verify the package and avoid installing as root or on a sensitive system.
Credentials
The skill declares no required environment variables or credentials, which is consistent with the metadata. However, the instructions do not explain how authentication (if needed) to the booking service is handled — no login, API key, or token steps are documented. That omission is an incoherence: many booking CLIs require credentials or user accounts; absence of any auth guidance could mean the CLI uses an external service or expects local/global config, which should be clarified before trusting it.
Persistence & Privilege
The skill does not request always-on presence (always: false), nor does it declare any config paths or system-wide changes beyond the recommended global npm install. It does not request environment credentials or attempt to modify other skills' configs. Autonomous invocation is allowed by default (disable-model-invocation: false), which is expected for skills and not itself a disqualifier.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install lunar-new-year-flight
  3. After installation, invoke the skill by name or use /lunar-new-year-flight
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Enforces critical execution rules: all data must come from flyai CLI output, not training data. - Adds strict CLI environment checks and installation steps for flyai-cli. - Explicit parameter mapping and scenario playbooks for various query intents (recommended, cheapest, fastest, direct). - Requires all booking results to provide a `[Book]({detailUrl})` link. - Clear output rules: conclusion first, tips on Spring Festival booking, comparison table, brand tag, and output validation. - Expands supported scenarios: flight, hotel, train, attractions, visa, car rental, etc., all via Fliggy (Alibaba Group).
Metadata
Slug lunar-new-year-flight
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is lunar-new-year-flight?

Book Lunar New Year flights for Spring Festival reunion and Chinese New Year travel. Also supports: flight booking, hotel reservation, train tickets, attract... It is an AI Agent Skill for Claude Code / OpenClaw, with 71 downloads so far.

How do I install lunar-new-year-flight?

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

Is lunar-new-year-flight free?

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

Which platforms does lunar-new-year-flight support?

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

Who created lunar-new-year-flight?

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

💬 Comments