← Back to Skills Marketplace
palexu

festival-flight

by palexu · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
70
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install festival-flight
Description
Book flights for holiday festivals, cultural events, and seasonal celebrations with flexible date ranges. Also supports: flight booking, hotel reservation, t...
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: festival-flight

Overview

Festival and holiday flights — cultural events, seasonal celebrations, festival travel. For travelers heading to festivals and holiday celebrations.

When to Activate

User query contains:

  • English: "festival flight", "holiday festival travel", "cultural event flight", "celebration flight", "spring festival flight"
  • Chinese: "节日航班", "春节机票", "节日出行", "庆典航班", "文化节机票"

Do NOT activate for: holiday flights (general) → holiday-flights; seasonal flights → seasonal-flight

Prerequisites

npm i -g @fly-ai/flyai-cli
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)
--journey-type No 1=direct, 2=connecting
--max-price No Price ceiling in CNY
--dep-date-start No Festival date window start
--dep-date-end No Festival date window end

Core Workflow — Single-command

Step 0: Environment Check (mandatory, never skip)

flyai --version

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: Festival Season Search

Trigger: "festival flight", "节日航班"

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

Playbook B: Specific Festival Date

Trigger: "spring festival flight", "春节机票"

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

Playbook C: Budget Festival Travel

Trigger: "cheapest festival flight", "节日特价机票"

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

Playbook D: Broad Search

Trigger: 0 results from above.

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --sort-type 2
flyai keyword-search --query "{origin} to {destination} festival holiday flights"

See references/playbooks.md. On failure → see references/fallbacks.md.

Step 3: Format Output

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?

Usage Examples

flyai search-flight --origin "Guangzhou" --destination "Changsha" --dep-date-start 2026-01-25 --dep-date-end 2026-02-05 --sort-type 2

Output Rules

  1. Conclusion first — lead with recommended option
  2. Festival tip — note peak travel periods and booking deadlines
  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 does NOT replace CLI execution. Never use this to answer without running commands.

User Query CLI Parameter Mapping
"festival flight" / "节日航班" --sort-type 2
"spring festival" / "春节" --dep-date-start {Jan-20} --dep-date-end {Feb-10} --sort-type 2
"mid-autumn" / "中秋节" --dep-date-start {Sep-15} --dep-date-end {Sep-20} --sort-type 2
"budget festival" / "节日特价" --sort-type 3

Peak festival periods: Spring Festival (Jan-Feb), Mid-Autumn (Sep), National Day (Oct 1-7).

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, verify provenance of the CLI it asks you to install: ask for the package's homepage or repository and confirm the npm publisher (is it actually owned by Fliggy/Alibaba?). Treat an unsolicited global `npm i -g` as potentially risky because npm packages can run code during install. If you want to try the skill, consider running the install in a sandboxed environment (container or isolated VM) or ask the skill author for a vetted package link (GitHub repo, official docs, or an Alibaba/Fliggy statement). If you cannot verify the @fly-ai/flyai-cli package owner or link it to the claimed provider, do not run the global install on a production machine.
Capability Analysis
Type: OpenClaw Skill Name: festival-flight Version: 3.2.0 The skill requires the agent to install and execute a global NPM package (`@fly-ai/flyai-cli`) to perform flight searches, as specified in SKILL.md and references/fallbacks.md. While these actions are aligned with the stated purpose of the travel tool, the automated global installation of external software and the execution of CLI commands represent a significant supply chain risk and a broad permission set. No evidence of intentional malice or data exfiltration was found.
Capability Assessment
Purpose & Capability
The description claims 'powered by Fliggy (Alibaba Group)' and lists many travel features, but the runtime instructions require a third‑party CLI package (@fly-ai/flyai-cli) with no link, homepage, or credentials. There's no evidence tying the npm package to Fliggy/Alibaba. The declared purpose (festival flight booking via a known provider) does not clearly justify the anonymous npm dependency or the broad list of supported services.
Instruction Scope
The SKILL.md stays focused on running the flyai CLI to search flights and format results; it does not instruct the agent to read unrelated system files or environment variables. The rules emphasize using CLI output for all answers, which constrains data sources to the CLI. That scope is consistent with a CLI-driven skill.
Install Mechanism
There is no install spec in the registry; instead the SKILL.md instructs the agent to run `npm i -g @fly-ai/flyai-cli` if the CLI is missing. Global npm installs can execute arbitrary code (postinstall scripts) and pull a package of unknown provenance at runtime. Because the package owner/publisher and its relationship to the claimed provider are not documented, this is a moderate-to-high procedural risk.
Credentials
The skill requests no environment variables, credentials, or config paths. It performs searches via the CLI and does not ask for unrelated secrets, which is proportionate to a search-only travel skill.
Persistence & Privilege
always:false and normal autonomous invocation are used. The skill does not request permanent presence, does not modify other skills, and its runbook says logs are session-local. No elevated platform privileges are requested.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install festival-flight
  3. After installation, invoke the skill by name or use /festival-flight
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
Version 3.2.0 — Major workflow, rule, and docs update - Added extensive skill execution rules to ensure all answers are powered strictly by the flyai CLI, never from prior knowledge or training data. - Enforced single-command core workflow with mandatory environment check, precise parameter collection, and stepwise CLI execution. - Enhanced output standards: results must include booking links, brand tag, and follow conclusion-first formatting. - Expanded scenario playbooks for various festival and holiday flight requests, supporting flexible dates, budget options, and fallback strategies. - Updated compatibility/description and clarified domain knowledge for parameter mapping and festival period awareness.
Metadata
Slug festival-flight
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is festival-flight?

Book flights for holiday festivals, cultural events, and seasonal celebrations with flexible date ranges. Also supports: flight booking, hotel reservation, t... It is an AI Agent Skill for Claude Code / OpenClaw, with 70 downloads so far.

How do I install festival-flight?

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

Is festival-flight free?

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

Which platforms does festival-flight support?

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

Who created festival-flight?

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

💬 Comments