← Back to Skills Marketplace
xiejinsong

group-tour

by xiejinsong · GitHub ↗ · vv3.2.3 · MIT-0
cross-platform ⚠ suspicious
133
Downloads
0
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install group-tour
Description
Find organized group tours and travel packages with professional guides, planned itineraries, meals included, and hassle-free travel for those who prefer str...
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: group-tour

Overview

Find organized group tours and travel packages with professional guides, planned itineraries, meals included, and hassle-free travel for those who prefer structure.

When to Activate

User query contains:

  • English: "group tour", "guided tour", "tour package", "organized trip"
  • Chinese: "跟团游", "旅行团", "团队游", "报团"

Do NOT activate for: self-plan → trip-planner

Prerequisites

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

Parameters

This skill orchestrates multiple CLI commands. See each command's parameters below:

search-flight

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 3 (price ascending)
--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

search-hotel

Parameters

Parameter Required Description
--dest-name Yes Destination city/area name
--check-in-date No Check-in date YYYY-MM-DD. Default: today
--check-out-date No Check-out date. Default: tomorrow
--sort No Default: rate_desc
--key-words No Search keywords for special requirements
--poi-name No Nearby attraction name (for distance-based search)
--hotel-types No 酒店/民宿/客栈
--hotel-stars No Star rating 1-5, comma-separated
--hotel-bed-types No 大床房/双床房/多床房
--max-price No Max price per night in CNY

Sort Options

Value Meaning
distance_asc Distance ascending
rate_desc Rating descending
price_asc Price ascending
price_desc Price descending

search-poi

Parameters

Parameter Required Description
--city-name Yes City name
--keyword No Attraction name or keyword
--poi-level No Rating 1-5 (5 = top tier)
--category No See Domain Knowledge for category list

keyword-search

Parameters

Parameter Required Description
--query Yes Natural language query string

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: Group Tour

Trigger: "group tour to {dest}"

flyai keyword-search --query "跟团游 {dest}"

Output: Organized tour packages.

Playbook B: Premium Group

Trigger: "luxury group tour"

flyai keyword-search --query "高端跟团游 {dest}"

Output: Premium guided tours.

Playbook C: Senior Group

Trigger: "senior tour"

flyai keyword-search --query "老年人跟团游 {dest}"

Output: Senior-friendly tours.

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 keyword-search --query "跟团游 日本"

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.

Group tour tips: read reviews carefully, check included meals and hotel star rating, confirm group size (\x3C20 is better), check shopping stop requirements (some budget tours mandate shopping stops). Premium tours: smaller groups, better hotels, no mandatory shopping. Best for: seniors, first-time international travelers, destinations with language barriers.

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 be a thin wrapper around the third-party @fly-ai/flyai-cli and is coherent with its description, but proceed cautiously. Before installing or running: (1) verify the npm package (@fly-ai/flyai-cli) is from a trusted source (check its npm page, maintainer, and GitHub repo); (2) be prepared that the skill may prompt to install a global npm package (which modifies your system), and avoid doing so on sensitive or production machines; (3) note the runbook instructs writing an execution log (.flyai-execution-log.json) that can contain user queries and other details — run in a sandbox if you do not want persistent logs containing PII; (4) because the skill makes live network calls via the CLI, expect outbound network traffic to the service used by the CLI; (5) if you need higher assurance, ask the skill author for an explicit install spec, the flyai-cli repository URL, and confirmation of what the CLI logs. If you are uncomfortable with a global npm install or automatic file writes, do not install/run this skill or run it only in an isolated environment.
Capability Analysis
Type: OpenClaw Skill Name: group-tour Version: v3.2.3 The skill mandates the global installation of an external npm package (`@fly-ai/flyai-cli`) and instructs the agent to write execution logs to the local filesystem (`.flyai-execution-log.json`). While these actions are aligned with the stated purpose of providing real-time travel data, the requirement for global software installation and automated file writes constitutes a high-privilege execution pattern that could be exploited if the external package or the logging mechanism were compromised. These instructions are primarily located in `SKILL.md` and `references/runbook.md`.
Capability Assessment
Purpose & Capability
Name/description match the runtime instructions: the skill wraps the @fly-ai/flyai-cli to fetch real-time group tour, flight, hotel and POI data. Asking to use a CLI and the parameters listed is coherent with the stated purpose.
Instruction Scope
SKILL.md restricts all answers to flyai CLI output and enforces specific command usage and output formatting (including mandatory booking links). That's consistent with the purpose, but the instructions also require writing an execution log (see runbook) and explicitly tell the agent to install a global npm package if missing — both expand the agent's scope beyond read-only query execution.
Install Mechanism
There is no formal install spec in the skill bundle; instead SKILL.md instructs the agent/user to run `npm i -g @fly-ai/flyai-cli`. Installing a global npm package is a moderate-risk action (third-party code execution and system modification) and the package origin/trustworthiness is not documented in the skill metadata.
Credentials
The skill declares no environment variables or credentials, which is appropriate. However, the runbook suggests persisting per-request logs to a local file (`.flyai-execution-log.json`) containing user_query and other details — this may store PII or sensitive travel info without being declared in requirements.
Persistence & Privilege
The skill does not request 'always' privilege, but it instructs installing a global CLI and may write persistent logs to disk. These side effects are not expressed in the skill metadata (no required config paths), so the skill can alter the environment and leave persistent artifacts without explicit declaration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install group-tour
  3. After installation, invoke the skill by name or use /group-tour
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
vv3.2.3
No changes detected in this version. - Version remains at 3.2.0. - No file updates or new features introduced. - All workflows, rules, and parameters are unchanged.
vv3.2.2
No changes detected in this release. - Version remains at 3.2.0. - No updates to features, rules, or parameters. - Functionality and usage guidance are unchanged.
vv3.2.1
No user-facing changes in this version. - Version updated to v3.2.1 with no code or documentation changes detected.
v3.2.0
group-tour v3.2.0 - Expanded skill scope: now supports flight booking, hotel reservation, train tickets, attractions, visa info, insurance, car rental, and more, all via Fliggy (Alibaba Group). - Added detailed CLI parameter tables for flights, hotels, and POIs; refined sort/filter options. - Improved output formatting rules and validation steps for consistent, bookable results. - Updated activation triggers and scenario playbooks (e.g., luxury/senior group tours). - Critical execution rules clarified: must install/use flyai-cli and never answer from knowledge/training data.
Metadata
Slug group-tour
Version v3.2.3
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 4
Frequently Asked Questions

What is group-tour?

Find organized group tours and travel packages with professional guides, planned itineraries, meals included, and hassle-free travel for those who prefer str... It is an AI Agent Skill for Claude Code / OpenClaw, with 133 downloads so far.

How do I install group-tour?

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

Is group-tour free?

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

Which platforms does group-tour support?

group-tour is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created group-tour?

It is built and maintained by xiejinsong (@xiejinsong); the current version is vv3.2.3.

💬 Comments