Weather Forecaster Skill 🌤️

Overview

This skill provides 7-day weather forecasts for any location worldwide using free APIs (no API key required):

• Open-Meteo Geocoding API — Convert location names to coordinates
• Open-Meteo Forecast API — Get detailed 7-day weather forecasts

Workflow

Step 1: Identify the Location

Parse the user's request to extract the location name. Examples:

• "北京未来一周天气" → location = "北京" (Beijing)
• "What's the weather in Tokyo?" → location = "Tokyo"
• "墨尔本下周会下雨吗" → location = "墨尔本" (Melbourne)

Step 2: Geocode the Location

Use the Open-Meteo Geocoding API to convert the location name to latitude/longitude:

https://geocoding-api.open-meteo.com/v1/search?name={location}&count=1&language=en

For Chinese location names, also try with language=zh:

https://geocoding-api.open-meteo.com/v1/search?name={location}&count=1&language=zh

Step 3: Fetch 7-Day Forecast

Use the Open-Meteo Forecast API:

https://api.open-meteo.com/v1/forecast?latitude={lat}&longitude={lon}&daily=weather_code,temperature_2m_max,temperature_2m_min,apparent_temperature_max,apparent_temperature_min,precipitation_sum,precipitation_probability_max,wind_speed_10m_max,wind_direction_10m_dominant,uv_index_max,sunrise,sunset&timezone=auto&forecast_days=7

Step 4: Run the Python Script

Execute the script at scripts/weather_report.py to fetch and format the data:

python3 scripts/weather_report.py "location_name"

The script will:

1. Geocode the location
2. Fetch 7-day forecast data
3. Output a formatted JSON report

Step 5: Generate Visual Report

After getting the data, create a React (.jsx) artifact that displays a beautiful weather dashboard with:

• Location name and coordinates
• 7-day forecast cards showing:
  • Date and day of week
  • Weather icon/emoji based on weather code
  • High/Low temperatures
  • Precipitation probability and amount
  • Wind speed and direction
  • UV index
• Color coding for temperature (blue=cold, green=comfortable, orange=warm, red=hot)
• Precipitation warnings highlighted
• A summary paragraph with clothing/umbrella recommendations

Weather Code Reference

| Code | Description | Emoji | |------|------------|-------| | 0 | Clear sky | ☀️ | | 1 | Mainly clear | 🌤️ | | 2 | Partly cloudy | ⛅ | | 3 | Overcast | ☁️ | | 45, 48 | Fog | 🌫️ | | 51, 53, 55 | Drizzle | 🌦️ | | 61, 63, 65 | Rain | 🌧️ | | 66, 67 | Freezing rain | 🌧️❄️ | | 71, 73, 75 | Snowfall | 🌨️ | | 77 | Snow grains | 🌨️ | | 80, 81, 82 | Rain showers | 🌧️ | | 85, 86 | Snow showers | 🌨️ | | 95 | Thunderstorm | ⛈️ | | 96, 99 | Thunderstorm with hail | ⛈️🧊 |

Response Style

• Use Chinese if the user writes in Chinese, English if the user writes in English
• Provide practical advice: 穿衣建议、是否带伞、出行建议
• Highlight extreme weather warnings
• Be friendly and conversational, like a TV weather presenter

Error Handling

• If location not found: Ask user to provide a more specific location name or try English/Chinese alternative
• If API fails: Inform user that the weather service is temporarily unavailable
• If network is disabled: Let user know this skill requires network access to fetch weather data