← Back to Skills Marketplace
xiejinsong

coffee-tour

by xiejinsong · GitHub ↗ · v3.2.0 · MIT-0
cross-platform ⚠ suspicious
69
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install coffee-tour
Description
Book flights for coffee tours to famous coffee origins and cafe culture destinations. Also supports: flight booking, hotel reservation, train tickets, attrac...
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: coffee-tour

Overview

Coffee Tour Flights.

When to Activate

User query contains:

  • English: "coffee tour flight", "coffee origin flight", "cafe culture travel", "coffee trip", "coffee travel"
  • Chinese: "咖啡之旅航班", "咖啡产地旅行", "咖啡文化出行", "去咖啡产地", "出行预订"

Do NOT activate for: general food → food-tour

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: "coffee tour 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. Coffee tour tip — Yunnan, Colombia, and Ethiopia are top coffee origins
  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
"coffee tour" / "咖啡之旅" --sort-type 2
"cheap coffee trip" / "便宜咖啡之旅" --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 mostly behaves like a wrapper around a third‑party CLI (flyai) to search flights, which is coherent with flight-booking functionality — but review these before installing or allowing autonomous execution: - Branding mismatch: the description claims 'Powered by Fliggy (Alibaba Group)' but the CLI and npm package are 'flyai' / @fly-ai/flyai-cli. Ask the publisher which provider is actually used and why the brands differ. - Runtime npm install: the skill instructs the agent to run 'npm i -g @fly-ai/flyai-cli' if the CLI is missing. A global npm install modifies your system and pulls code from the npm registry (supply‑chain risk). Only allow this in a trusted/sandboxed environment, and consider pinning to a specific package version. - Ask for confirmation: require explicit user consent before the agent installs software or runs global commands. Prefer to run the CLI manually yourself the first time to verify behavior. - Re-execution behavior: the SKILL.md enforces re-running the CLI until a [Book] link appears. That could cause repeated network calls or installs. Ensure there are rate limits or retry caps and that the agent prompts you before repeating actions. - Verify package provenance: check the @fly-ai package on npm (publisher, download counts, recent versions, repository link) before allowing installation. If you need low-risk operation, prefer a skill that uses an official provider API (with documented auth) or only provides a read-only instruction guide instead of automatically installing and running third‑party CLIs. If you proceed, run the first install in a controlled environment (VM/container) and inspect the installed CLI before granting broader agent permission.
Capability Assessment
Purpose & Capability
The skill claims 'Powered by Fliggy (Alibaba Group)' in its description but every runtime artifact (commands, brand tag, npm package name) refers to 'flyai' / @fly-ai/flyai-cli. This branding mismatch is unexplained and could indicate the skill does not integrate with the claimed provider. Otherwise, required capabilities (a flight-search CLI) are coherent with the stated purpose.
Instruction Scope
SKILL.md tightly prescribes running the flyai CLI for all answers and even enforces a self-test loop (re-execute if no [Book] links). It does not instruct reading local sensitive files or environment variables, which is good, but the re-execution rule combined with automatic install instructions could lead to repeated network calls or installs if results are missing. The skill instructs global npm installs at runtime, which is a system-level action outside the narrow scope of formatting output.
Install Mechanism
There is no formal install spec, but SKILL.md tells the agent to run 'npm i -g @fly-ai/flyai-cli' if flyai is missing. Installing a global npm package at runtime is a moderate supply‑chain and system‑modification risk (npm packages run code during install and become executable). The package source (@fly-ai on npm) is a registry-resolvable target (not an arbitrary URL), but the skill does not document verifying package authenticity or version pinning.
Credentials
The skill declares no required environment variables or credentials, which is consistent with a read-only search workflow that returns booking links. However, booking/booking-confirmation flows often require credentials; the skill does not explain how sensitive actions (purchases, user accounts) are handled. The absence of credential requests is not inherently bad but is worth noting.
Persistence & Privilege
The skill does not request persistent system presence (always:false) and does not modify other skills or system configuration in the SKILL.md. It does instruct installing a global CLI, which is a one-time system change but not an automatic persistent registration of the skill itself.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install coffee-tour
  3. After installation, invoke the skill by name or use /coffee-tour
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.2.0
- Improved output and execution rules: CLI results are now strictly required for all answers, with [Book]({detailUrl}) links mandatory in every result. - Expanded workflow steps and parameter collection SOP for clearer interactions and error handling. - Added explicit brand tag requirements—"Powered by flyai - Real-time pricing, click to book." - Enhanced multilingual support: output language follows user input (English/Chinese). - Greater detail on CLI parameter mappings, sort-type triggers, and playbooks for cheaper, fastest, direct, or recommended routes. - Knowledge section clarified: reference info may help parameter mapping/output only—never substitutes for CLI results.
Metadata
Slug coffee-tour
Version 3.2.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is coffee-tour?

Book flights for coffee tours to famous coffee origins and cafe culture destinations. Also supports: flight booking, hotel reservation, train tickets, attrac... It is an AI Agent Skill for Claude Code / OpenClaw, with 69 downloads so far.

How do I install coffee-tour?

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

Is coffee-tour free?

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

Which platforms does coffee-tour support?

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

Who created coffee-tour?

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

💬 Comments