← Back to Skills Marketplace
guchigangz

js-hanoi-air

by buihieu · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
102
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install js-hanoi-air
Description
High-performance Node.js implementation for monitoring Vietnamese Air Quality Indexes. Features advanced error resilience, localized city mapping, and multi-...
README (SKILL.md)

🇻🇳 Vietnam Professional AQI Engine (Node.js)

📘 Introduction & Purpose

Dự án này là một bước tiến hóa từ các script Shell/Binary truyền thống sang một hệ thống Node.js Managed Skill. Mục tiêu cốt lõi là cung cấp dữ liệu môi trường có độ trễ thấp, độ chính xác cao cho các AI Agent hoạt động tại khu vực Đông Nam Á, đặc biệt là Việt Nam.

Trong bối cảnh các đô thị lớn như Hà Nội thường xuyên đối mặt với bụi mịn PM2.5 vượt ngưỡng, công cụ này không chỉ trả về số liệu mà còn cung cấp một lớp Logic Interpretation (Giải mã logic) để người dùng cuối có thể hiểu rõ mức độ nguy hiểm đối với sức khỏe.

🏗️ Technical Architecture & Workflow

1. Data Processing Sequence

Hệ thống vận hành dựa trên luồng xử lý khép kín:

  1. Request Sanitization: Kiểm tra tính hợp lệ của tham số city.
  2. Mapping Layer: Sử dụng Dictionary nội bộ để chuyển đổi "Sài Gòn", "HCMC" thành định dạng tương thích với trạm đo toàn cầu.
  3. Upstream Connectivity: Khởi tạo kết nối TLS 1.3 đến server WAQI.
  4. JSON Schema Validation: Đảm bảo dữ liệu trả về từ trạm đo không bị lỗi hoặc thiếu trường thông tin IAQI.

2. Logic Flow Diagram (Text-based)

User Query -> Skill Controller -> City Resolver -> WAQI API -> JSON Parser -> Health Advisory -> Final Output

🛠️ Implementation Guide

Prerequisites

  • Node.js Runtime: Version 18.x or 20.x (LTS recommended).
  • Network: Outbound access to https://api.waqi.info.

Invocation Syntax

# Thực thi trực tiếp qua môi trường ClawHub
node {baseDir}/aqi-hanoi.js "Hà Nội"
Usage Guidance
This skill's behavior (query WAQI and print results) matches its description, but it includes a hard-coded WAQI API token in the code while declaring no credentials — that mismatch is suspicious. Before installing: (1) Treat the embedded token as potentially sensitive: verify its origin (is it a public demo token?) and rotate or remove it if it belongs to your organization. (2) Prefer a version that accepts the token via a documented environment variable (e.g., WAQI_TOKEN) rather than hard-coding. (3) Confirm the GitHub homepage and repository integrity (commit history, owner) and check WAQI API terms and rate limits. (4) If you cannot verify the token's provenance or the repo owner, avoid installing or run the code in an isolated environment with restricted network access. (5) If you proceed, consider replacing the hard-coded token with a user-controlled credential and monitor outbound requests to api.waqi.info.
Capability Analysis
Type: OpenClaw Skill Name: js-hanoi-air Version: 1.0.0 The skill is a straightforward Node.js implementation for fetching real-time air quality data from the World Air Quality Index (WAQI) API. The code in `aqi-hanoi.js` uses the built-in `https` module to perform requests and properly sanitizes user-provided city names using `encodeURIComponent`. While it contains a hardcoded API token, this is a common practice for simple utility skills and does not pose a risk to the user's environment or data. No malicious patterns, such as data exfiltration or unauthorized command execution, were detected.
Capability Assessment
✓ Purpose & Capability
Name/description match the code and instructions: a Node.js script that queries the WAQI API for Vietnamese cities and returns AQI and simple health interpretation. No unrelated binaries, services, or capabilities are requested.
ℹ Instruction Scope
SKILL.md limits runtime behavior to running the included Node script and outbound access to api.waqi.info. The instructions do not ask the agent to read unrelated files or send data to other endpoints. Note: the package explicitly embeds full source, so runtime behavior is visible and limited to network calls to WAQI.
✓ Install Mechanism
There is no install spec; this is instruction-plus-source only. Nothing is downloaded or written by an installer, which lowers install-time risk.
⚠ Credentials
The code contains a hard-coded WAQI_TOKEN string (506d32... ) but the skill metadata declares no required environment variables or primary credential. Embedding a credential in source and failing to declare it is disproportionate and a secret-management red flag: it could be a leaked/stale personal token or a deliberate attempt to hide a credential. The script has network egress to api.waqi.info (expected) and does not contact other endpoints.
✓ Persistence & Privilege
Skill is user-invocable, not always-enabled, and does not request elevated or persistent system privileges or modify other skills. It only executes a single one-off Node.js process.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install js-hanoi-air
  3. After installation, invoke the skill by name or use /js-hanoi-air
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of js-hanoi-air skill version 1.0.0. - Provides real-time monitoring and advanced error resilience for Vietnamese Air Quality Indexes. - Supports localized city name mapping and multi-parameter environmental data retrieval. - Includes logic for health risk interpretation based on PM2.5 and other environmental parameters. - Node.js Managed Skill design for low-latency, high-accuracy data tailored to Vietnam’s urban areas.
Metadata
Slug js-hanoi-air
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is js-hanoi-air?

High-performance Node.js implementation for monitoring Vietnamese Air Quality Indexes. Features advanced error resilience, localized city mapping, and multi-... It is an AI Agent Skill for Claude Code / OpenClaw, with 102 downloads so far.

How do I install js-hanoi-air?

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

Is js-hanoi-air free?

Yes, js-hanoi-air is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does js-hanoi-air support?

js-hanoi-air is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created js-hanoi-air?

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

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 Comments