Weather Forecast

This skill should be used when users ask about weather forecasts, temperature information, or need to retrieve weather data for specific locations. It provid...

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