weather-forecast

name	weather-forecast
description	This skill should be used when users ask about weather forecasts, temperature information, or need to retrieve weather data for specific locations. It provides access to the Open-Meteo weather API for getting hourly temperature forecasts based on latitude and longitude coordinates.

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