weather-forecast

# Weather Forecast Skill This skill enables querying weather forecasts using the Open-Meteo API, providing hourly temperature data for any location worldwide. ## When to Use This Skill Activate this skill when: - Users ask for weather information or forecasts - Users inquire about temperatures at specific locations - Users mention weather-related queries that require current or future data - Users provide location names and expect weather details ## Skill Components ### Scripts The `scripts/get_weather.py` script provides a reliable, reusable way to fetch weather data from the Open-Meteo API. This script is used instead of writing API calls from scratch each time because: - API endpoints and parameters need to be consistent - Error handling for network requests is standardized - JSON parsing and data extraction is automated - The script can be executed without loading into context ### References The `references/api_response_format.md` contains documentation about the Open-Meteo API response structure, including: - Request parameters (latitude, longitude, hourly data types) - Response format and field meanings - Time zone handling - Error conditions ## Workflow When this skill is activated: 1. **Extract location information** from the user's query. This may include: - City names (e.g., "Beijing", "Shanghai", "New York") - Specific coordinates (latitude, longitude) - Descriptive locations (e.g., "my current location") 2. **Convert location to coordinates**: - If city name is provided, use geocoding to get latitude and longitude - If coordinates are provided directly, use them as-is - Common city coordinates (saved in memory): Beijing (39.9042, 116.4074), Shanghai (31.2304, 121.4737), New York (40.7128, -74.0060), London (51.5074, -0.1278), Tokyo (35.6762, 139.6503) 3. **Execute the weather script** using the coordinates: - Run `scripts/get_weather.py` with latitude and longitude parameters - The script returns structured weather data including hourly temperatures 4. **Present results** to the user in a natural, readable format: - Summarize key information (current temperature, high/low, forecast) - Include relevant time information (next 24 hours or specific times mentioned) - Use units appropriate to the context (Celsius by default, Fahrenheit if requested) ## Important Notes - The Open-Meteo API provides hourly forecasts, not just current weather - Temperature values are in Celsius by default - The API is free and requires no authentication - Coordinate precision: up to 4 decimal places for better accuracy - If coordinates are not available for a location, inform the user and ask for coordinates or a different location ## Example Interactions User: "What's the weather like in Beijing?" Action: Extract "Beijing", use coordinates (39.9042, 116.4074), run script, present forecast User: "Will it be cold in Tokyo tomorrow?" Action: Extract "Tokyo" and "tomorrow", use coordinates (35.6762, 139.6503), run script, present tomorrow's temperature User: "Get the temperature for latitude 52.52 and longitude 13.41" Action: Use provided coordinates directly, run script, present hourly data User: "How hot will it be in Shanghai today?" Action: Extract "Shanghai", use coordinates (31.2304, 121.4737), run script, identify maximum temperature for today