# Hk Urbtix Events

> HK URBTIX Events Skill

- Skill: `stevenho1394/hk-urbtix-events` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add stevenho1394/hk-urbtix-events`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stevenho1394/hk-urbtix-events/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: StevenHo1394 (https://skillmd.com/u/stevenho1394)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/stevenho1394/hk-urbtix-events

---

# HK URBTIX Events Skill

Fetches upcoming event data from URBTIX (Hong Kong) and detects changes, filtering out noise.

## Tools

### `queryEvents`

Answers natural language questions about URBTIX events by parsing the query, fetching the appropriate batch XML, and returning matching performances. Handles date parsing (HK time), venue/name extraction, and validation.

**Parameters:**
- `question` (required): Natural language question about events, e.g., "When is Medea showing?", "Where is 美狄亞 on April 8?", "What performances are on 2026-04-10?"
- `force_refresh` (optional): If true, ignore cached XML and re-download. Default: false.

**Returns:** A dictionary with:
- `answer`: Human-readable answer in **markdown table format** (Time | Event | Venue | Ticket Link) or clarification message
- `matches`: List of matching events (each with event_name_en, event_name_tc, venue, venue_tc, date, time, reference_link)
- `clarification_needed`: If unable to match, what additional info is needed

See README.md for full details.

## Installation

Place the skill directory under your OpenClaw workspace `skills/` and add `"hk-urbtix-events"` to the desired agent's `skills` array.

## Notes

- Fetches from the official URBTIX cloud distribution endpoint (Tencent COS). The XML includes a `<SYSTEM>URBTIX</SYSTEM>` marker that is verified upon download to ensure authenticity.
- Respectful polling: Do not call more than once per hour without `force_refresh`.
- Caches daily batches in `$OPENCLAW_WORKSPACE/urbtix_cache/` to reduce load.
- No external dependencies (Python standard library only).

## Version

1.0.3 — Improved date filtering (performance-level), markdown table output format with ticket links, expanded stop words (events/event), bug fixes.