← Back to Skills Marketplace
148
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install hk-nearby-facilities
Description
Find nearby Hong Kong public facilities by place keyword or shared live location, starting with public toilets (公廁 / washroom / restroom / toilet) using offi...
README (SKILL.md)
HK Nearby Facilities
Use the bundled script to search Hong Kong public-facility data by place keyword.
Current scope
- Public toilets (
toilet) via FEHD official JSON endpoints. - Future-friendly structure for other facility types later.
Quick start
python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet \x3Cplace-keywords>
Examples:
python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet 大埔墟
python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet 火炭站
python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet Central --limit 5
python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet 旺角 --accessible-only
python3 /home/jim/.openclaw/workspace/skills/hk-nearby-facilities/scripts/hk_nearby_facilities.py toilet --lat 22.448628 --lng 114.164727 --limit 3
Workflow
- Identify the facility type from the request.
- For now, only
toiletis implemented.
- For now, only
- Extract the place keywords.
- Accept district names, station names, estates, landmarks, street names, or short area phrases.
- If the user shared live location or latitude+longitude, prefer using the coordinates to rank facilities by physical distance.
- Run the script.
- Prefer the closest or best-matching few entries rather than a huge list.
- Include Google Maps links when they help the user navigate.
- If the user asks for accessible / universal toilets, use the relevant flags.
- If there is no exact place match, say it is a nearby match instead of pretending it is exact.
Reporting guidance
- Keep it practical: name, address, district, and map link.
- Say when the result is approximate or nearby rather than exact.
- If the query is broad, return the top few likely matches.
- Mention accessible / universal toilet status when available and relevant.
Data source
Public toilets currently use FEHD official endpoints, including:
getMapData.php?type=toiletgetAccessibleToilets.php?type=toiletgetUniversalToilets.php?type=toilet
Limitations
- This version is keyword-based, not GPS turn-by-turn routing.
- It currently supports public toilets only.
- Oil stations / petrol stations are not included yet because a comparable official government location dataset has not been confirmed.
scripts/
scripts/hk_nearby_facilities.py— search nearby Hong Kong facilities by place keyword.
Usage Guidance
This skill appears to do what it claims: it fetches public-toilet data from FEHD and ranks matches. Before installing, consider: (1) it will make outbound HTTP requests to https://www.fehd.gov.hk and read the responses — if you need offline/privacy-only operation, do not enable it; (2) review the bundled script if you want to confirm no additional telemetry is added; (3) the SKILL.md examples use an absolute path (/home/jim/...), but the script can be run from wherever the skill is installed; (4) the skill does not request secrets or write system-wide config. If you accept network access to FEHD endpoints, installing is reasonable.
Capability Analysis
Type: OpenClaw Skill
Name: hk-nearby-facilities
Version: 0.1.0
The skill bundle is a legitimate tool for searching Hong Kong public facility data (specifically public toilets) using official government endpoints from the Food and Environmental Hygiene Department (fehd.gov.hk). The Python script (hk_nearby_facilities.py) uses standard libraries to fetch, filter, and rank location data based on keywords or coordinates, and the instructions in SKILL.md are strictly aligned with this functionality without any signs of prompt injection or malicious intent.
Capability Assessment
Purpose & Capability
Name/description match the code and instructions: the script fetches FEHD map JSON endpoints and searches/filters public-toilet records. There are no unrelated credentials, binaries, or config paths requested.
Instruction Scope
SKILL.md instructs running the bundled Python script and describes expected inputs/outputs. The runtime instructions and the script operate on FEHD endpoints and local query data only. The quick-start examples use an absolute workspace path (e.g. /home/jim/...) which is just an example and not required for functionality.
Install Mechanism
No install spec is provided (instruction-only skill with a bundled script). The script is plain Python and uses stdlib urllib/json; there are no downloads from unknown hosts or archive extraction steps.
Credentials
The skill requires no environment variables, credentials, or config paths. All external network calls are to FEHD official endpoints; generated Google Maps links are constructed locally and not sent to Google by the skill.
Persistence & Privilege
always is false and the skill has no install-time persistence or cross-skill configuration. It does not modify other skills or system settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install hk-nearby-facilities - After installation, invoke the skill by name or use
/hk-nearby-facilities - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial publish: Hong Kong nearby facilities skill with public toilet lookup and live location support.
Metadata
Frequently Asked Questions
What is HK Nearby Facilities?
Find nearby Hong Kong public facilities by place keyword or shared live location, starting with public toilets (公廁 / washroom / restroom / toilet) using offi... It is an AI Agent Skill for Claude Code / OpenClaw, with 148 downloads so far.
How do I install HK Nearby Facilities?
Run "/install hk-nearby-facilities" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is HK Nearby Facilities free?
Yes, HK Nearby Facilities is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does HK Nearby Facilities support?
HK Nearby Facilities is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created HK Nearby Facilities?
It is built and maintained by jimpang8 (@jimpang8); the current version is v0.1.0.
More Skills