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...

Security Scan

The skill's code, runtime instructions, and requirements match its stated purpose (querying HKO open data) and do not request secrets or unrelated privileges.

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.

Assessment

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.

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" / "現時無生效天氣警告"