← Back to Skills Marketplace
round-trip
by
Yangki Zhang
· GitHub ↗
· v3.2.0
· MIT-0
44
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install round-trip
Description
Book round-trip flights, return tickets and round-trip discount bookings with outbound and inbound flight selection. Also supports: flight booking, hotel res...
Usage Guidance
This skill is CLI-driven and otherwise plausible for searching round-trip flights, but there are several red flags you should consider before installing or using it:
- Incoherent parameters: The SKILL.md insists a return/back date must be used for round-trip searches, but the parameter list and nearly all example commands do not include any --back-date flag. Ask the author to clarify and correct the required parameter set before trusting results.
- Source verification: The skill recommends installing @fly-ai/flyai-cli globally via npm. That executes third-party code on your machine — verify the npm package, its maintainers, and its source repository before running npm i -g. Prefer packages with an official homepage and repository you can inspect.
- Local logging/persistence: The skill may append execution logs (including user queries and parameters) to .flyai-execution-log.json in the current directory. If you plan to run it, be aware these logs may contain personal travel data; inspect and control where logs are stored or disable that behavior.
- Branding mismatch: The description references 'Powered by Fliggy (Alibaba Group)' but the runtime uses a 'flyai' CLI with no homepage provided. Confirm which backend is actually being used and whether the branding is accurate.
- Retry/self-test behavior: The skill forces re-execution if no [Book](...) links are present. This can cause repeated network calls; consider rate limits, API keys, or unintended repeated installs/requests.
Recommended actions: ask the skill author to (1) provide a homepage/repository for the skill and the flyai CLI, (2) fix the parameter table/examples to include a documented --back-date/back-date flags for round-trips, (3) make logging optional and document what is stored, and (4) avoid forcing global npm installs or provide a vetted link to the CLI source. If you cannot verify the CLI package source and the logging behavior, avoid running the npm install or using the skill.
Capability Analysis
Type: OpenClaw Skill
Name: round-trip
Version: 3.2.0
The skill bundle facilitates flight searches by instructing the agent to install and execute a global NPM package (@fly-ai/flyai-cli). A significant security concern exists in SKILL.md and references/playbooks.md, where the agent is directed to construct shell commands using raw user input (e.g., --origin "{o}") without any instructions for sanitization or escaping. This pattern creates a high risk of shell command injection if a user provides crafted input containing shell metacharacters. Additionally, the runbook.md specifies writing internal execution logs to a local file (.flyai-execution-log.json) using shell redirection, which further expands the potential for command injection and unauthorized file writes.
Capability Assessment
Purpose & Capability
The skill claims to book round-trip flights (and even says 'Powered by Fliggy (Alibaba Group)') but every runtime instruction uses a third-party 'flyai' CLI — there is no homepage or credential info for either Fliggy or flyai. Crucially, the SKILL.md repeatedly insists a return/back date (--back-date) must be used for round-trips, yet the parameters table and almost all example/Prerequisite commands omit any --back-date flag. The description and declared capabilities (hotels, trains, visa info) are broader than the commands and parameters actually provided, creating incoherence about what the skill truly needs or does.
Instruction Scope
The instructions require executing an external CLI and explicitly forbid answering from training data — all outputs must come from flyai CLI JSON. The runbook and templates instruct the agent to log an internal execution record and (if filesystem writes are available) append it to .flyai-execution-log.json, potentially storing user inputs and query context locally. The SKILL.md also enforces a strict self-test (re-execute if no [Book](...) links), which could cause repeated re-execution/loops when results are empty. These behaviors extend beyond simple querying and include local persistence and retry logic that the description does not justify.
Install Mechanism
There is no formal install spec (instruction-only), but the skill tells the agent to run npm i -g @fly-ai/flyai-cli if flyai is missing. Installing a globally-published npm package is a normal way to get a CLI, but it does run third-party code on the host. Because the skill does not provide a verified homepage or links to a known release, the user should verify the npm package and its source before allowing installation.
Credentials
The skill requests no environment variables or credentials, which is proportionate to a client-side CLI-based search. However, the skill's logging behavior (internal state + appending the execution log file) can capture and persist sensitive user-provided data (origins, destinations, dates, possibly request_id and raw user_query). That persistence is not declared in the top-level requirements and therefore warrants caution.
Persistence & Privilege
Although always:false and the skill is user-invocable, the runbook explicitly instructs writing an execution log to .flyai-execution-log.json when filesystem writes are available. This gives the skill a persistent footprint on disk and a record of user queries and CLI responses. The skill also enforces re-execution until results include booking links, which combined with local logging could lead to repeated network calls and persistent records of those calls.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install round-trip - After installation, invoke the skill by name or use
/round-trip - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
round-trip 3.2.0
- Expanded description to clarify support for return tickets, round-trip discounts, outbound + inbound flights, and additional travel services including hotel, train, attractions, visas, insurance, and car rental.
- Added detailed execution rules to enforce strict CLI-only responses and prevent fallback to training data.
- Comprehensive parameter table introduced, clarifying CLI flags and mapping to user intents.
- Included domain knowledge and mapping for flexible/fare-based, direct, and multi-day searches.
- Detailed output validation and formatting requirements added to ensure links and branding consistency.
- Introduced fallback and self-test procedures for improved reliability.
Metadata
Frequently Asked Questions
What is round-trip?
Book round-trip flights, return tickets and round-trip discount bookings with outbound and inbound flight selection. Also supports: flight booking, hotel res... It is an AI Agent Skill for Claude Code / OpenClaw, with 44 downloads so far.
How do I install round-trip?
Run "/install round-trip" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is round-trip free?
Yes, round-trip is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does round-trip support?
round-trip is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created round-trip?
It is built and maintained by Yangki Zhang (@ivan97); the current version is v3.2.0.
More Skills