← Back to Skills Marketplace
bufferstreamer

luggage-shipping

by bufferstreamer · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
70
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install luggage-shipping
Description
Search for flights with luggage shipping and extra baggage transport options. Also supports: flight booking, hotel reservation, train tickets, attraction tic...
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: luggage-shipping

Overview

Luggage Shipping Flights.

When to Activate

User query contains:

  • English: "luggage shipping flight", "baggage delivery flight", "extra luggage flight", "baggage transport", "luggage travel"
  • Chinese: "行李托运航班", "行李快递机票", "超额行李出行", "行李运输", "出行预订"

Do NOT activate for: cargo → cargo-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)
--max-price No Price ceiling in CNY

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: "luggage shipping 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. Luggage tip — some airlines offer prepaid baggage discounts online
  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
"luggage shipping" / "行李托运" --sort-type 2
"cheap baggage flight" / "便宜行李航班" --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 appears to do what it claims (run a CLI to find luggage-friendly flights), but there are red flags you should consider before running it: 1) It instructs you to run `npm i -g @fly-ai/flyai-cli` if the CLI is missing — installing a global npm package downloads and executes third-party code and should only be done if you trust the package and its publisher. 2) The description names 'Fliggy (Alibaba Group)' while the runtime tool is 'flyai' — verify the actual data provider and that the CLI is an official client. 3) There are no instructions about authentication or API keys; ask the author how the CLI authenticates and whether it will store credentials locally. 4) Prefer to inspect the npm package (registry page, source repo, maintainer info) before installing, or run the CLI in a sandbox/container. If you cannot verify the package/source or do not want to install global packages, do not run this skill.
Capability Analysis
Type: OpenClaw Skill Name: luggage-shipping Version: 3.2.0 The skill mandates the global installation of an external NPM package (@fly-ai/flyai-cli) and forces the agent to execute system-level CLI commands while strictly forbidding the use of its own knowledge base. This requirement for global software installation and the use of 'CRITICAL EXECUTION RULES' to override agent defaults poses a significant supply chain risk and potential for unauthorized system modification, although no explicit evidence of intentional malice (like data exfiltration) is present in the provided files. Primary files: SKILL.md and references/fallbacks.md.
Capability Assessment
Purpose & Capability
The skill claims to search flights and luggage-shipping options and its runtime instructions consistently use a 'flyai' CLI for that purpose, which is coherent. However, the description asserts 'Powered by Fliggy (Alibaba Group)' while every runtime artifact references a different name (flyai / @fly-ai/flyai-cli). There's no homepage or source repo to verify the claimed provider. Also the skill gives no guidance about authentication or API credentials for accessing the flight data, which in practice are normally required — this mismatch is unexplained.
Instruction Scope
The SKILL.md narrowly confines behavior to running a specific CLI, collecting parameters, formatting output, and re-running if validation fails. It does not instruct reading unrelated files or environment variables. That scope is appropriate for the stated purpose. The notable runtime directive is to install the CLI if missing and to insist on obtaining all data from CLI output (never from training data).
Install Mechanism
There is no formal install spec, but the instructions require running `npm i -g @fly-ai/flyai-cli` if the CLI is not present. A global npm install at runtime pulls and executes code from the npm registry (or a configured registry) and modifies the host system — this is higher risk than instruction-only behavior. The package name and origin are unverified (no homepage, no repo link), increasing risk of installing an unknown package.
Credentials
The skill declares no required environment variables or credentials, yet it expects to query real-time flight data via a CLI that likely needs network access and possibly API credentials or an account. The SKILL.md contains no authentication or credential setup steps (login, token, or environment variables). The absence of declared credentials despite making authenticated-looking calls is a proportionality/visibility problem.
Persistence & Privilege
The skill does not request permanent agent presence (always:false) and has no install manifest written to the registry. However, following its runtime instructions can change the host by globally installing an npm package. That is a local system change but not a platform-level privilege escalation. Still, it increases the blast radius of the skill when executed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install luggage-shipping
  3. After installation, invoke the skill by name or use /luggage-shipping
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
luggage-shipping v3.2.0 - Improved CLI execution rules for stricter compliance and accuracy. - Updated activation triggers and parameter mapping for English and Chinese. - Enhanced output requirements: must include booking links and brand tag, with comparison tables for results. - Clarified separation of domain knowledge use and CLI execution; training data is strictly disallowed for answers. - Added detailed playbooks for recommended, cheapest, fastest, and direct flight searches.
Metadata
Slug luggage-shipping
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is luggage-shipping?

Search for flights with luggage shipping and extra baggage transport options. Also supports: flight booking, hotel reservation, train tickets, attraction tic... It is an AI Agent Skill for Claude Code / OpenClaw, with 70 downloads so far.

How do I install luggage-shipping?

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

Is luggage-shipping free?

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

Which platforms does luggage-shipping support?

luggage-shipping is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created luggage-shipping?

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

💬 Comments