weather-query

name	weather-query
description	Query OpenWeather current weather and 5-day forecast data and summarize conditions for a location. Use when users ask for current weather, near-term forecast, multi-day temperature ranges, precipitation probability, wind, pressure, or humidity for a city or coordinates, especially when live external weather data is required.

Weather Query

Use the bundled script to fetch and summarize weather from OpenWeather 2.5/weather and 2.5/forecast.

Sandbox Constraints

This script runs inside a sandboxed environment with strict rules:

• Only .venv/bin/python is allowed. Do not use bare python, python3, or any other interpreter.
• No shell operators. Do not use &&, ||, ;, |, >, <, $(...), or backticks.
• No cd. Always use the relative path from the project root.
• No --api-key or --city. The API key is injected by the sandbox proxy. Geocoding is not available inside the sandbox.
• Always use --lat and --lon. Look up coordinates with WebSearch first.
• The exact command prefix must be: .venv/bin/python plugins/weather-plugin/skills/weather-query/scripts/get_weather.py

Any command that does not match this format will be rejected.

Run Workflow

1. Look up coordinates. Use WebSearch to find the latitude and longitude for the requested location. Example query: "Chicago Illinois latitude longitude".

2. Run the script with --lat and --lon. Do not use --city (geocoding requires an API call that is not available inside the sandbox).

3. Summarize the result for the user.

   • Highlight current conditions first.
   • Mention precipitation chance, wind, and temperature range.
   • Note that severe alerts are not included by these endpoints.

Command Format

The only allowed Bash command format:

.venv/bin/python plugins/weather-plugin/skills/weather-query/scripts/get_weather.py --lat <LAT> --lon <LON>

Optional flags (append after coordinates):

.venv/bin/python plugins/weather-plugin/skills/weather-query/scripts/get_weather.py \
  --lat 41.8781 \
  --lon -87.6298 \
  --units metric \
  --lang en \
  --hours 12 \
  --days 5

Output Expectations

• Current section: temperature, feels-like, humidity, pressure, wind, condition text.
• Forecast section: timestamp (3-hour steps), temperature, precipitation probability, condition.
• Daily section: date, min/max temperatures, precipitation probability, condition.
• Alerts note: endpoint limitation message.

Troubleshooting

• Command rejected: verify you are using .venv/bin/python with the relative path, --lat/--lon, and no shell operators.
• 401 Unauthorized: the proxy may not be running. It must be started separately.
• Missing fields: OpenWeather omits fields when not applicable for that location/time.

Reference

• OpenWeather API details and field mapping: references/openweather-current-forecast.md