LaunchKit · 2026
Back to Skills

hk-bus-eta

Real-time Hong Kong bus arrival predictions for KMB, LWB, and Citybus. 香港九巴、城巴及龍運實時到站時間查詢。

1
102 downloads
by @tomfong

Setup & Installation

openclaw skills install @tomfong/hk-bus-eta

Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:

npx clawhub install hk-bus-eta

Version History

v1.0.2Mar 14, 2026 - Version note by skill developer:

v1.0.2 is a safety-hardened, ClawHub-scan-friendly update with query robustness and parallel performance improvements. - Safer output policy: allows minimal formatting for clarity and compliance; no fabricated ETAs; always uses real script output or fixed fallback. - Explicit command and network allowlists; write access limited to skill-local cache/data only; secrets strictly forbidden. - Multi-route queries now require per-route fallback labeling if no results found. - Performance maintained: parallel API fetch, cache-first stop lookup, and guidance for quick responses. - Query retry logic clarified; max two retries for latency stability. - No functional changes to user-facing queries or ETA features.

What This Skill Does

Looks up real-time bus arrival times for Hong Kong routes operated by KMB, Citybus (CTB), and Long Win Bus (LWB). Supports fuzzy stop name matching, bilingual output in Traditional Chinese and English, and parallel queries across multiple routes simultaneously.

Queries government ETA APIs directly with fuzzy stop matching and parallel multi-route fetching, returning real-time results without opening a transit app or reading a timetable.

When to use it

  • Checking next KMB bus arrival before leaving home
  • Getting airport bus ETA at HKIA terminal stops
  • Querying two routes at once at a busy interchange
  • Finding a stop using a partial or alternate name
  • Checking last-bus status late at night

Example Workflow

Here's how your AI assistant might use this skill in practice.

INPUT

User asks: When does the next A29 arrive at the airport?

AGENT
  1. 1Identifies route A29 and stop keyword 'Airport'
  2. 2Runs: python3 scripts/eta.py A29 Airport en
  3. 3Applies fast-path exact match on stop name before falling back to fuzzy
  4. 4Filters output to boarding-direction ETAs only, suppressing terminus arrivals
  5. 5Returns formatted result with arrival times, minutes remaining, and Google Maps link
OUTPUT

A29 → Tseung Kwan O | Stop: HKIA T1 | 14:05 (3 min) [KMB] | 14:12 (10 min) [KMB] | 14:21 (19 min) [KMB]