# Send IQAir Air Quality to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "iqair", "name": "IQAir Air Quality", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/atesluks/iqair", "canonicalUrl": "https://clawhub.ai/atesluks/iqair", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/iqair", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=iqair", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/api.md", "scripts/get_aqi.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "iqair", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-04T07:58:42.291Z", "expiresAt": "2026-05-11T07:58:42.291Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=iqair", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=iqair", "contentDisposition": "attachment; filename=\"iqair-1.0.2.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "iqair" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/iqair" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/iqair", "downloadUrl": "https://openagent3.xyz/downloads/iqair", "agentUrl": "https://openagent3.xyz/skills/iqair/agent", "manifestUrl": "https://openagent3.xyz/skills/iqair/agent.json", "briefUrl": "https://openagent3.xyz/skills/iqair/agent.md" } } ``` ## Documentation ### IQAir Air Quality Checker Get real-time air quality data from the IQAir API with formatted output including AQI score, emoji indicator, and quality level. ### Prerequisites API Key Required: User must have a free IQAir API key stored in the IQAIR_API_KEY environment variable. If the key is not set, guide the user: Visit https://dashboard.iqair.com/personal/api-keys Sign up/sign in and subscribe to the free Community plan Copy the API key Set it: export IQAIR_API_KEY="your_key_here" ### Quick Usage By city name: python scripts/get_aqi.py Riga Latvia python scripts/get_aqi.py London "United Kingdom" python scripts/get_aqi.py Budapest Hungary By coordinates (most reliable): python scripts/get_aqi.py --lat 56.9496 --lon 24.1052 Nearest city (based on IP): python scripts/get_aqi.py --nearest ### How to Respond to User Queries When a user asks about air quality: Determine the location - Extract city/country from their query Run the script - Use scripts/get_aqi.py with appropriate arguments Return formatted output - The script provides emoji, AQI value, level, and location Example interaction: User: "How good is air in Riga?" Response process: Location: Riga, Latvia Run: python scripts/get_aqi.py Riga Latvia Output: 🟢 19 - Good\\nRiga, Latvia Reply: "Air quality in Riga is currently excellent! 🟢 19 (Good)" ### Handling Location Names City/country names: Use exact names as they appear in IQAir's database Capital cities: Often the state/province matches the city name If city lookup fails, try coordinates instead Common location patterns: Riga, Latvia → Riga Latvia (state defaults to city) London, UK → London "United Kingdom" (quote if spaces) New York, USA → "New York" "United States" "New York" (city, country, state) When in doubt: Use coordinate-based lookup with --lat and --lon (more reliable). ### Output Format The script returns a concise, formatted string: 🟢 45 - Good Riga, Latvia Customize your response based on the AQI level: 0-50 (🟢 Good): "Excellent", "Perfect for outdoor activities" 51-100 (🟡 Moderate): "Acceptable", "Sensitive people should limit prolonged outdoor exertion" 101-150 (🟠 USG): "Unhealthy for sensitive groups", "Children and people with respiratory issues should reduce outdoor exertion" 151-200 (🔴 Unhealthy): "Everyone may experience health effects", "Reduce outdoor activities" 201-300 (🟣 Very Unhealthy): "Health alert", "Avoid outdoor activities" 301+ (🟤 Hazardous): "Emergency conditions", "Stay indoors" ### Technical Details For API specifications, endpoints, and error handling, see references/api.md. ### Rate Limits Free Community plan limits: 5 calls/minute 500 calls/day 10,000 calls/month Avoid making repeated calls for the same location within short time periods. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: atesluks - Version: 1.0.2 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-04T07:58:42.291Z - Expires at: 2026-05-11T07:58:42.291Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/iqair) - [Send to Agent page](https://openagent3.xyz/skills/iqair/agent) - [JSON manifest](https://openagent3.xyz/skills/iqair/agent.json) - [Markdown brief](https://openagent3.xyz/skills/iqair/agent.md) - [Download page](https://openagent3.xyz/downloads/iqair)