← Back to Skills Marketplace
mic007p

Hong Kong Weather

by MIC007P · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
67
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hk-weather
Description
Hong Kong weather information from the Hong Kong Observatory (HKO) official open data API. Use when: user asks about Hong Kong weather, temperature, rainfall...
README (SKILL.md)

Hong Kong Weather (v1.0.0)

Get real-time weather, warnings, and forecasts from the Hong Kong Observatory (HKO) official open data API. Zero dependencies, zero API keys.

Output Policy (Safe & ClawHub-friendly)

  • Prefer script output as reply basis.
  • Allow minimal formatting cleanup for readability.
  • Never fabricate weather data. If API fails, show exact error.
  • Keep output concise. No lengthy explanations.

Safety & Scope (for Security Scan)

  • Allowed commands only:
    • python3 scripts/hk_weather.py current [tc|en]
    • python3 scripts/hk_weather.py warning [tc|en]
    • python3 scripts/hk_weather.py forecast [tc|en]
    • python3 scripts/hk_weather.py all [tc|en]
  • Network scope (allowlist):
    • https://data.weather.gov.hk/*
  • Write scope (skill-local only):
    • scripts/__pycache__/
  • No secrets. No credentials. No config files.

Language Handling

  • Chinese query → tc: When user asks in Chinese/Cantonese, use python3 scripts/hk_weather.py current tc
  • English/non-Chinese query → en: When user asks in English, use python3 scripts/hk_weather.py current en
  • Default to tc if language is unclear (Hong Kong primary language)

Usage

Current Weather

Real-time temperature, humidity, rainfall, UV index, and conditions.

# Chinese output (default for HK)
python3 scripts/hk_weather.py current tc

# English output
python3 scripts/hk_weather.py current en

Weather Warnings

Check active warnings (typhoon, rainstorm, thunderstorm, etc.).

python3 scripts/hk_weather.py warning tc
python3 scripts/hk_weather.py warning en

9-Day Forecast

Extended forecast with temperature range, humidity, and rain probability.

python3 scripts/hk_weather.py forecast tc
python3 scripts/hk_weather.py forecast en

All-in-One

Combined current + warnings + forecast (first 3 days).

python3 scripts/hk_weather.py all tc
python3 scripts/hk_weather.py all en

Examples

"今天香港天氣點?"

python3 scripts/hk_weather.py current tc

"What's the weather in Hong Kong?"

python3 scripts/hk_weather.py current en

"有冇暴雨警告?"

python3 scripts/hk_weather.py warning tc

"Forecast for the week"

python3 scripts/hk_weather.py forecast en

"香港天氣點?有冇警告?未來幾日預報?"

python3 scripts/hk_weather.py all tc

Notes

  • Data source: Hong Kong Observatory Open Data API (data.weather.gov.hk)
  • No API key required
  • Response time: typically 2-5 seconds
  • When no warnings are active, the warning command returns "No active weather warnings" / "現時無生效天氣警告"
Usage Guidance
This skill appears coherent and limited to fetching HKO open-data over HTTPS. Before installing, confirm you are comfortable with the agent making outbound requests to https://data.weather.gov.hk and that python3 is available. The included script is readable (no obfuscated code) and writes only normal bytecode caches under scripts/__pycache__ when executed. Note that the agent can invoke skills autonomously by default, but this one has a narrow network scope and requests no secrets, so the autonomy risk is low.
Capability Analysis
Type: OpenClaw Skill Name: hk-weather Version: 1.0.0 The skill is a straightforward utility for fetching Hong Kong weather data from the official Hong Kong Observatory (HKO) API. The Python script (scripts/hk_weather.py) uses standard libraries to perform read-only API requests to data.weather.gov.hk and contains no suspicious logic, obfuscation, or unauthorized file/network access. The SKILL.md instructions are strictly aligned with the stated purpose and do not attempt to manipulate the agent into unsafe behaviors.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description, declared requirement (python3), allowed network domain (data.weather.gov.hk), and included script all align: the skill only fetches HKO open-data endpoints and formats results.
Instruction Scope
SKILL.md restricts the commands the agent should run to the provided python script and language flag. The instructions only reference the HKO API and local script; they do not ask to read arbitrary files, environment variables, or send data to other endpoints.
Install Mechanism
No install spec (instruction-only) and a single included Python script. This has minimal install risk; running it will only create normal __pycache__ artifacts under scripts/ as noted.
Credentials
The skill requires no environment variables or credentials and the code does not access secrets or external tokens. Requested resources are proportional to a read-only weather client.
Persistence & Privilege
always is false and the skill does not modify other skills or system-wide settings. It only writes its own __pycache__ and does not persist credentials or change agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hk-weather
  3. After installation, invoke the skill by name or use /hk-weather
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of hk-weather skill providing real-time Hong Kong weather data from the official Hong Kong Observatory open data API. - Supports current weather, weather warnings (typhoon, rainstorm, thunderstorm), and 9-day forecasts. - Output available in Traditional Chinese or English based on user query language. - No dependencies or API keys required; safe, read-only API usage. - Designed for concise, factual responses and reliable error handling if API fails.
Metadata
Slug hk-weather
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Hong Kong Weather?

Hong Kong weather information from the Hong Kong Observatory (HKO) official open data API. Use when: user asks about Hong Kong weather, temperature, rainfall... It is an AI Agent Skill for Claude Code / OpenClaw, with 67 downloads so far.

How do I install Hong Kong Weather?

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

Is Hong Kong Weather free?

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

Which platforms does Hong Kong Weather support?

Hong Kong Weather is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Hong Kong Weather?

It is built and maintained by MIC007P (@mic007p); the current version is v1.0.0.

💬 Comments