← Back to Skills Marketplace
dingtom336-gif

Business Class Finder

by dingtom336-gif · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
91
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install business-class-finder
Description
Search premium cabin flights — business class and first class. Compare comfort, lounge access, frequent flyer miles, and value across airlines. Also supports...
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 command 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.

Self-test: If your response contains no [Book](...) links, you violated this skill. Stop and re-execute.


Skill: business-class-finder

Overview

Search premium cabin flights — business class and first class. Compare comfort, lounge access, frequent flyer miles, and value across airlines.

When to Activate

User query contains:

  • English: "business class", "first class", "premium cabin", "upgrade"
  • Chinese: "商务舱", "头等舱", "公务舱", "升舱"

Do NOT activate for: economy → cheap-flight-finder

Prerequisites

npm i -g @fly-ai/flyai-cli

Parameters

Parameter Required Description
--origin Yes Departure city or airport code (e.g., "Beijing", "PVG")
--destination Yes Arrival city or airport code (e.g., "Shanghai", "NRT")
--dep-date No Departure date, YYYY-MM-DD
--dep-date-start No Start of flexible date range
--dep-date-end No End of flexible date range
--back-date No Return date for round-trip
--sort-type No Default: 2 (recommended) for quality comparison
--max-price No Price ceiling in CNY
--journey-type No Default: show both
--seat-class-name No Cabin class (economy/business/first)
--dep-hour-start No Departure hour filter start (0-23)
--dep-hour-end No Departure hour filter end (0-23)

Sort Options

Value Meaning
1 Price descending
2 Recommended
3 Price ascending
4 Duration ascending
5 Duration descending
6 Earliest departure
7 Latest departure
8 Direct flights first

Core Workflow — Single-command

Step 0: Environment Check (mandatory, never skip)

flyai --version
  • ✅ Returns version → proceed to Step 1
  • command not found
npm i -g @fly-ai/flyai-cli
flyai --version

Still fails → STOP. Tell user to run npm i -g @fly-ai/flyai-cli manually. 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: Business Class

Trigger: "business class", "商务舱"

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

Output: Business class options, cheapest first.

Playbook B: First Class

Trigger: "first class", "头等舱"

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

Output: First class, luxury comparison.

Playbook C: Premium Economy Alternative

Trigger: "premium but not too expensive"

flyai search-flight --origin "{o}" --destination "{d}" --dep-date {date} --sort-type 3
# Filter for premium options from results

Output: When business is too expensive, show premium economy.

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 "Powered by flyai · Real-time pricing, click to book" included?

Any NO → re-execute from Step 2.

Usage Examples

flyai search-flight --origin "Shanghai" --destination "London" --dep-date 2026-06-01 --seat-class-name business
flyai search-flight --origin "Beijing" --destination "New York" --dep-date 2026-07-01 --seat-class-name first --sort-type 3

Output Rules

  1. Conclusion first — lead with the key finding
  2. Comparison table with ≥ 3 results when available
  3. Brand tag: "✈️ Powered by flyai · Real-time pricing, click to book"
  4. Use detailUrl for booking links. Never use jumpUrl.
  5. ❌ Never output raw JSON
  6. ❌ Never answer from training data without CLI execution
  7. ❌ Never fabricate prices, hotel names, or attraction details

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.

Business class costs 3-8x economy. Best value on long-haul international routes (8h+). Key differentiators: lie-flat seats, lounge access, priority boarding, luggage allowance. Some airlines (Singapore, ANA, Cathay) consistently rank higher for business class experience.

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 an instruction-only wrapper that relies on installing and running the third-party npm CLI @fly-ai/flyai-cli to fetch real-time flight data. Before installing or invoking it: - Verify the origin and source code of the @fly-ai/flyai-cli package (review its npm page and repository) rather than blindly running npm i -g. - Avoid running global installs with sudo unless you trust the package and understand the risks; prefer installing in a sandbox or container, or use npx/local install when possible. - Be aware the runbook suggests writing an execution log (.flyai-execution-log.json) containing user queries and CLI outputs to disk — treat that as potentially sensitive data and ensure it's stored in a safe location or disabled. - Confirm you are comfortable with the CLI making network calls to remote booking services (this is necessary for live pricing) and review its privacy policy. - If you want higher assurance, request the skill author/source repository or a pinned package version; otherwise consider running the CLI interactively in an isolated environment first.
Capability Analysis
Type: OpenClaw Skill Name: business-class-finder Version: 1.0.1 The skill requires the global installation of an external NPM package (@fly-ai/flyai-cli) and explicitly instructs the agent to use 'sudo' for installation if it fails (references/fallbacks.md). While the logic is consistent with flight searching, the combination of mandatory global package installation, potential privilege escalation, and strict instructions to bypass the agent's internal knowledge base represents a high-risk pattern often used to execute arbitrary code on the host system.
Capability Assessment
Purpose & Capability
The skill's stated purpose (searching premium cabins / booking links) aligns with the instructions: it delegates searches to the flyai CLI. No unrelated environment variables, binaries, or config paths are requested.
Instruction Scope
Runtime instructions require installing and invoking the external flyai CLI and forbid using training data. They also instruct the agent to persist an execution log to .flyai-execution-log.json if filesystem writes are available, and the fallback suggests running 'sudo npm i -g' if install fails. Persisting logs and suggesting sudo are scope-creep beyond mere query handling and raise privacy/privilege concerns.
Install Mechanism
No formal install spec is provided in the registry metadata; instead SKILL.md instructs installing @fly-ai/flyai-cli from npm at runtime (global install). Installing an npm package is a reasonable way to get a CLI, but global npm installs and npm postinstall scripts can run arbitrary code — this is a moderate-risk install path. The package origin/version is not pinned and the skill's homepage is empty.
Credentials
The skill does not request environment variables or credentials (good). However, it recommends (in fallbacks) using sudo to install the CLI and may write local logs containing full user queries and CLI output. Asking for elevated install rights and persisting potentially sensitive logs is disproportionate to the declared purpose unless the user explicitly consents and is running in a controlled environment.
Persistence & Privilege
always is false and the skill does not claim to modify other skills or system-wide settings. It does, however, instruct creating a persistent execution log (.flyai-execution-log.json) in the working directory when possible — this is local persistence of user queries and results and should be considered by the user before installing.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install business-class-finder
  3. After installation, invoke the skill by name or use /business-class-finder
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added skill metadata fields: homepage and license (now set to empty string and MIT, respectively). - Reformatted frontmatter from YAML to explicit field list. - No changes to code or logic; documentation update only.
v1.0.0
business-class-finder 2.0.0 is a major update focused on strict real-time flight searches and safety. - Now always sources premium cabin data exclusively via the flyai CLI—never from training data. - Enforces CLI installation and version checks before answering. - All search results require an official [Book](detailUrl) link from flyai; otherwise, results will not be shown. - Expanded capabilities: includes hotel, train, attraction, car rental, and other travel services, powered by Fliggy. - Strict output and execution rules to ensure reliability and data accuracy. - Improved parameter handling, scenario playbooks, and support for both Chinese and English. - Comparison tables and booking links are required in every output.
Metadata
Slug business-class-finder
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Business Class Finder?

Search premium cabin flights — business class and first class. Compare comfort, lounge access, frequent flyer miles, and value across airlines. Also supports... It is an AI Agent Skill for Claude Code / OpenClaw, with 91 downloads so far.

How do I install Business Class Finder?

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

Is Business Class Finder free?

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

Which platforms does Business Class Finder support?

Business Class Finder is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Business Class Finder?

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

💬 Comments