weather-query_skill

Overview

This skill provides real-time weather conditions, forecasts, and air quality information for locations in China. It uses shell scripts to query a weather API and returns results in text, markdown, or JSON formats. The skill is optimized for concise responses and for switching output detail based on user needs.

How this skill works

The skill runs small shell scripts that query a weather API for a specified Chinese location and returns current conditions, hourly/daily forecasts, life indices, and alerts. By choosing an encoding parameter you control output detail: markdown for readable summaries, text for brief results, and json for complete raw payloads. The skill validates locations and falls back to broader city names when district-level queries fail.

When to use it

• User asks for current weather or immediate conditions in a Chinese city or district
• User requests hourly or multi-day forecasts for planning activities
• User needs air quality, wind, humidity, sunrise/sunset times, or life indices
• User wants a brief summary or a full raw data payload (for debugging or integration)
• User is planning outdoor events and needs suggestions based on weather

Best practices

• Use Chinese characters for location names to improve accuracy (e.g., 北京, 上海)
• Default to markdown output for readable, structured responses unless user requests brief or raw data
• Use text encoding for concise answers when minimizing tokens is important
• Use json encoding only when the user explicitly requests full raw data
• Validate the location and fall back to city-level names if a district query fails
• Include actionable context: umbrella for rain, hydration for heat, layers for cold, mask for poor AQI

Example use cases

• Get current weather and AQI for 北京 to advise on commute and outdoor plans
• Fetch a 3-day forecast for 杭州 to decide whether to schedule a weekend excursion
• Provide a brief, one-line weather summary for 广州 when the user asks for a quick update
• Return full JSON forecast for 深圳 to feed into another application or visualization
• Suggest clothing and safety tips for a user traveling to 海淀区 based on current conditions