← Back to Skills Marketplace
xiejinsong

cycling-trip

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
75
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install cycling-trip
Description
Book flights for cycling trips and bike tours. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary planning, visa...
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: cycling-trip

Overview

Cycling Trip Flights.

When to Activate

User query contains:

  • English: "cycling flight", "bike tour flight", "bicycle trip", "cycling vacation", "plan a trip"
  • Chinese: "骑行航班", "自行车旅行机票", "骑行出行", "单车之旅", "出行规划"

Do NOT activate for: general sports → sports-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)
--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: "cycling 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. Cycling tip — Taiwan, Hainan, and Qinghai Lake are famous cycling routes
  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
"cycling" / "骑行出行" --sort-type 2
"bike tour 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
This skill looks coherent for a CLI-driven flight search helper, but before installing/running anything: 1) Verify the npm package '@fly-ai/flyai-cli' on the npm registry (publisher, repository URL, recent versions, and reviews) to confirm it is the legitimate vendor you expect (especially because the SKILL.md mentions 'Fliggy' which may not match the package author). 2) Prefer installing/testing the CLI in a controlled environment (container, VM, or non-root user) rather than running a global npm install on a critical host — global installs can run install scripts. 3) Be aware the skill only returns booking links (it doesn't perform payments); never provide payment credentials to the agent. 4) If you cannot validate the CLI publisher/repository, treat this as higher-risk and avoid installing it system-wide.
Capability Analysis
Type: OpenClaw Skill Name: cycling-trip Version: 3.2.0 The skill bundle instructs the AI agent to automatically perform a global installation of an external NPM package (`@fly-ai/flyai-cli`) if the tool is missing (SKILL.md, references/fallbacks.md). While this is presented as a prerequisite for flight booking functionality, the automated installation of global software is a high-risk supply-chain behavior that could lead to arbitrary code execution. No clear evidence of malicious intent or data exfiltration was identified, but the reliance on unverified third-party package installation warrants a suspicious classification.
Capability Assessment
Purpose & Capability
The skill claims to book flights and other travel items and its runtime relies entirely on a 'flyai' CLI to perform searches and supply booking links — this is coherent. Minor mismatch: description references 'Fliggy (Alibaba Group)' while the CLI/package referenced is '@fly-ai/flyai-cli' (different names); this could be benign branding imprecision or indicate the package is not the vendor implied in the description.
Instruction Scope
SKILL.md confines runtime actions to installing/verifying and invoking the flyai CLI, collecting user parameters, formatting CLI JSON output, and ensuring each result includes a [Book]({detailUrl}) link. It does not instruct reading unrelated files, accessing unrelated env vars, or exfiltrating data beyond CLI calls and formatted output.
Install Mechanism
There is no registry install spec; instead the runtime instructions tell the agent to run 'npm i -g @fly-ai/flyai-cli' if the CLI is missing. Installing a global npm package executes third-party code and install scripts (moderate risk). The package appears to come from the public npm ecosystem (traceable) rather than an arbitrary download URL, but the skill's package publisher should be verified before installing globally.
Credentials
The skill requests no environment variables, credentials, or config paths. That aligns with its stated behavior (it only searches and provides booking links). It does not ask for payment credentials or user accounts; note that actual ticket purchase would typically require authentication outside this skill's scope.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent privileges. It does not attempt to modify other skills or system-wide configs in the provided instructions.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install cycling-trip
  3. After installation, invoke the skill by name or use /cycling-trip
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Updated skill name and display name to highlight cycling trip flight and bike tour booking. - Expanded the description to include hotel, train, attractions, itinerary, visa, insurance, car rental, and more, all powered by Fliggy. - Added stricter CLI execution rules: now always ensure every result contains a direct booking link and prohibits knowledge-based answers. - Improved parameter mapping, output formatting, and error handling processes. - Enhanced compatibility list for supported agents and clarified scenario triggers.
Metadata
Slug cycling-trip
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is cycling-trip?

Book flights for cycling trips and bike tours. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary planning, visa... It is an AI Agent Skill for Claude Code / OpenClaw, with 75 downloads so far.

How do I install cycling-trip?

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

Is cycling-trip free?

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

Which platforms does cycling-trip support?

cycling-trip is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created cycling-trip?

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

💬 Comments