← Back to Skills Marketplace
xiejinsong

gap-year-travel

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
69
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install gap-year-travel
Description
Book flights for gap year travel and year-off adventures. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary plan...
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: gap-year-travel

Overview

Gap Year Travel Flights.

When to Activate

User query contains:

  • English: "gap year flight", "year off flight", "long term travel", "backpacker long trip", "year travel"
  • Chinese: "间隔年航班", "休学年机票", "长期旅行", "背包客长途出行", "出行预订"

Do NOT activate for: budget → budget-backpacker; sabbatical → sabbatical-travel

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: 3 (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: "gap year flight", "间隔年航班"

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

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 3

Output Rules

  1. Conclusion first — lead with best option
  2. Gap year tip — Southeast Asia and South America are budget-friendly long-stay regions
  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
"gap year" / "间隔年" --sort-type 3
"multi-stop gap year" / "多站间隔年" --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 is coherent with its stated purpose: it runs a third-party CLI (flyai) to fetch real-time fares and requires that every result include a booking link. Before installing or allowing execution, consider: 1) Verify the npm package @fly-ai/flyai-cli on the npm registry (author, version, README, popularity, and recent publish history). 2) Install the CLI in a controlled environment (container or VM) if you don't trust global installs. 3) Ensure you trust the network endpoints the CLI contacts (it will fetch live pricing/booking URLs). 4) The skill does not request your credentials, but if booking later requires entering payment or account info, confirm the booking destination is legitimate. 5) If you prefer not to allow runtime installs, ask the skill owner for an explicit install spec or a vetted binary/source before enabling. If you want additional assurance, provide the flyai CLI package name/version or a link to its homepage and I can re-assess with that info.
Capability Analysis
Type: OpenClaw Skill Name: gap-year-travel Version: 3.2.0 The skill bundle requires the global installation of an external npm package (`@fly-ai/flyai-cli`) using `npm i -g` if the command is not found, which poses a significant risk of Remote Code Execution (RCE) and supply chain compromise. While the instructions in SKILL.md and references/fallbacks.md are aligned with the stated purpose of flight searching, the mandatory high-privilege installation of unverified third-party software is a high-risk behavior. No explicit evidence of malicious intent or data exfiltration was found within the provided logic.
Capability Assessment
Purpose & Capability
Name/description (flight/hotel/train booking) match the runtime instructions: all runtime steps call a 'flyai' CLI (search-flight, keyword-search) and format results for booking. No requests for unrelated cloud credentials, system paths, or surprising capabilities.
Instruction Scope
SKILL.md is prescriptive: collect origin/destination, run flyai CLI, format CLI JSON into markdown with [Book](detailUrl) links, and re-execute if validation fails. It does not instruct reading arbitrary local files or exfiltrating unrelated data. The strict rule 'never answer from training data' is unusual but consistent with relying solely on CLI output.
Install Mechanism
The skill is instruction-only (no install spec in registry) but mandates installing a third-party CLI at runtime via `npm i -g @fly-ai/flyai-cli` if flyai is missing. Installing a global npm package is a moderate-risk action because it downloads and runs remote code; this is proportional to a CLI-based skill but worth verifying the package and source before allowing the install.
Credentials
No environment variables, credentials, or config paths are requested. The skill does not ask for unrelated secrets or system config. It does require network access to run the CLI and access booking detailUrl links (expected for purpose).
Persistence & Privilege
always:false and no special privileges are requested. The skill does not request persistent presence, modify other skills, or access other skills' configs. Autonomous invocation is allowed by default (normal) but not combined with other red flags here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install gap-year-travel
  3. After installation, invoke the skill by name or use /gap-year-travel
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Enforced strict execution rules: all travel data must come directly from the flyai CLI, never from training data. - Added mandatory environment check and CLI installation step before any command execution. - Implemented structured parameter collection, with user prompts limited to two clarifying questions. - Introduced detailed playbooks for recommended, cheapest, fastest, and direct route searches. - Output must now begin with a conclusion, include a gap year tip, present a comparison table (if possible), and use a booking link for each result. - Enhanced brand tagging: all outputs are labeled as powered by flyai, emphasizing real-time pricing and authentic booking sources.
Metadata
Slug gap-year-travel
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is gap-year-travel?

Book flights for gap year travel and year-off adventures. Also supports: flight booking, hotel reservation, train tickets, attraction tickets, itinerary plan... It is an AI Agent Skill for Claude Code / OpenClaw, with 69 downloads so far.

How do I install gap-year-travel?

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

Is gap-year-travel free?

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

Which platforms does gap-year-travel support?

gap-year-travel is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created gap-year-travel?

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

💬 Comments