← 返回 Skills 市场
165
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install hk-urbtix-events
功能描述
Fetches and returns detailed Hong Kong URBTIX event performances by parsing natural language questions with date, venue, and event filters.
使用说明 (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.
安全使用建议
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.
功能分析
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`.
能力评估
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).
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install hk-urbtix-events - 安装完成后，直接呼叫该 Skill 的名称或使用
/hk-urbtix-events触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
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
元数据
常见问题
Hong Kong Urbix Events 是什么？
Fetches and returns detailed Hong Kong URBTIX event performances by parsing natural language questions with date, venue, and event filters. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 165 次。
如何安装 Hong Kong Urbix Events？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install hk-urbtix-events」即可一键安装，无需额外配置。
Hong Kong Urbix Events 是免费的吗？
是的，Hong Kong Urbix Events 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Hong Kong Urbix Events 支持哪些平台？
Hong Kong Urbix Events 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Hong Kong Urbix Events？
由 Steven Ho（@stevenho1394）开发并维护，当前版本 v1.0.3。
推荐 Skills