← Back to Skills Marketplace
165
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install hk-urbtix-events
Description
Fetches and returns detailed Hong Kong URBTIX event performances by parsing natural language questions with date, venue, and event filters.
README (SKILL.md)
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 messagematches: 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
\x3CSYSTEM>URBTIX\x3C/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.
Usage Guidance
This skill appears to do what it says: download URBTIX batch XMLs from the listed Tencent COS URL, validate them, cache them under your agent workspace, and answer queries. Before installing, consider:
- The skill will create and write files to OPENCLAW_WORKSPACE/urbtix_cache/ (ensure that path is correct and writable and you are comfortable with those local files). The README mentions this var but it's not declared as a required env var in the registry metadata.
- The skill performs network requests to the documented COS URL; if your environment restricts outbound network access, install accordingly.
- The code contains some duplicated/unfinished-looking blocks (e.g., repeated download logic) — this looks like sloppy coding rather than malicious behavior; it may impact robustness but not safety. If you want extra assurance, review or run the code in an isolated environment first.
- Respectful polling is enforced by the skill, but you should still avoid automated high-frequency invocations.
If you want me to, I can: (a) scan the rest of the truncated file contents for other behaviors, (b) produce a minimal security checklist to run the code in a sandbox, or (c) point out exact lines to inspect further.
Capability Analysis
Type: OpenClaw Skill
Name: hk-urbtix-events
Version: 1.0.3
The skill is a legitimate tool for querying Hong Kong URBTIX event data from a cloud-hosted XML distribution point (Tencent COS). The implementation in `urbtix_events.py` uses only Python standard libraries and includes several security best practices, such as validating the XML structure (checking for a specific `<SYSTEM>` tag) and preventing path traversal by strictly formatting filenames from date strings. There is no evidence of data exfiltration, malicious execution, or harmful prompt injection instructions in `SKILL.md`.
Capability Assessment
Purpose & Capability
Name/description, README, plugin.json, SKILL.md and the Python code all focus on downloading and parsing URBTIX batch XMLs from the documented Tencent COS URL, caching results, and answering natural-language queries. There are no unexpected external services or unrelated credentials requested.
Instruction Scope
Runtime instructions and code limit activity to: parse the question, download/validate URBTIX XML batches, cache them under the agent workspace, and return matches. The skill reads/uses the OPENCLAW_WORKSPACE environment variable (documented in README) and performs cache/lock file operations and silent cache purging; these filesystem actions are expected but should be noted by users who care about local writes.
Install Mechanism
No install spec; the skill is instruction-only with a single Python file that uses only the standard library. There are no downloads from arbitrary URLs or third‑party package installs during setup.
Credentials
The skill requires no secrets or credentials. It reads the OPENCLAW_WORKSPACE environment variable to determine cache location (the README documents this). OPENCLAW_WORKSPACE is not listed as a required env var in registry metadata — it's optional behavior, but the skill will create and write files under that workspace.
Persistence & Privilege
always is false and the skill does not request elevated platform privileges. It writes cache and lock files only within the agent workspace and does not modify other skills or system-wide settings. Autonomous invocation is allowed (platform default).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hk-urbtix-events - After installation, invoke the skill by name or use
/hk-urbtix-events - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
**1.0.3 adds better performance-level date filtering and markdown table answers with ticket links.**
- Answers now use a markdown table format (Time | Event | Venue | Ticket Link).
- Improved date filtering to match exact performance dates instead of broader matching.
- Stop words list for question parsing expanded (includes “events”, “event”).
- Fetching now verifies the source with a `<SYSTEM>URBTIX</SYSTEM>` marker for authenticity.
- General bug fixes and documentation updates.
v1.0.1
Version 1.0.1
- Added plugin.json and requirements.txt for improved packaging and metadata.
- Removed deprecated openclaw.plugin.json file.
- Updated documentation for clarity and brevity, including simplified installation and usage notes.
- No functional logic changes to question parsing or event fetching; update is packaging and doc-focused.
v1.0.0
HK URBTIX Events Skill v1.0.0
- Initial public release
- Supports natural language queries for URBTIX events by date, venue, and event name
- Smart caching and robust validation of event batch XML files (HK government source)
- Bilingual output: returns English and Traditional Chinese event/venue names
- Progressive clarification if user query is ambiguous or yields no matches
- No API keys required; strict input sanitization and user privacy protections
Metadata
Frequently Asked Questions
What is Hong Kong Urbix Events?
Fetches and returns detailed Hong Kong URBTIX event performances by parsing natural language questions with date, venue, and event filters. It is an AI Agent Skill for Claude Code / OpenClaw, with 165 downloads so far.
How do I install Hong Kong Urbix Events?
Run "/install hk-urbtix-events" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Hong Kong Urbix Events free?
Yes, Hong Kong Urbix Events is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Hong Kong Urbix Events support?
Hong Kong Urbix Events is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Hong Kong Urbix Events?
It is built and maintained by Steven Ho (@stevenho1394); the current version is v1.0.3.
More Skills