| name | weather-plugin |
| description | Guide for using the weather plugin — data queries, radar imagery, model maps, and meteorological calculations |
| version | 2.0.0 |
| metadata | {"hermes":{"tags":["weather","radar","forecast","meteorology"],"category":"weather"}} |
Weather Plugin Usage Guide
You have 12 weather tools. Prefer lightweight data tools and only use images when asked.
Tool Selection
"How's the weather in [place]?" → wx_conditions
"What's the forecast?" → wx_forecast
"Any warnings/watches?" → wx_alerts
"Show me the radar" → wx_radar_image
"Show me CAPE/temperature/wind map" → wx_model_image (use comma-separated vars: "cape,helicity,uh,srh" for multiple in ONE call)
"What's the severe weather outlook?" → wx_severe
"Weather in Tokyo/London/etc" → wx_global (worldwide)
"Calculate dewpoint/wind chill/LCL" → wx_calc
"Is there a tornado threat?" → wx_severe first, then wx_model_image --var cape or --var helicity for visual
"What does the HRRR show?" → wx_model_image with appropriate var
"Show me the 18z HRRR" → wx_model_image with cycle: 18
"Sounding at a point" → wx_sounding
IMPORTANT: Only these 12 tools exist
wx_conditions, wx_forecast, wx_alerts, wx_metar, wx_brief, wx_global, wx_severe, wx_radar_image, wx_model_image, wx_storm_image, wx_calc, wx_sounding
Do NOT try to call any other tool names.
Rules
- Start lightweight. Use
wx_conditions or wx_brief before heavier tools.
- Images only when asked. Don't call image tools unless the user wants to SEE something.
- US vs international. Use
wx_global for non-US locations.
- Calculations are verified.
wx_calc uses metrust — 205 Rust-backed functions verified against MetPy.
- Don't stack redundant calls.
wx_brief already includes conditions + forecast + alerts.
- BATCH model images. NEVER call wx_model_image multiple times for different variables. Use comma-separated vars in ONE call:
"cape,helicity,uh,srh". This generates all images at once.
- Severe weather package. For severe weather analysis, use:
var: "cape,helicity,uh,srh" — one call, 4 images.
- ZOOM to threat area. When the user asks about a specific region (e.g., "Indiana to New York"), ALWAYS pass lat/lon and radius_km to zoom in. Don't show full CONUS when they asked about a corridor. Examples:
- "Ohio Valley" →
lat: 39.5, lon: -83, radius_km: 400
- "Indiana to New York" →
lat: 40.5, lon: -77, radius_km: 500
- "Texas" →
lat: 31.5, lon: -99, radius_km: 500
- "Southeast" →
lat: 33, lon: -85, radius_km: 600
- "Great Plains" →
lat: 38, lon: -99, radius_km: 600
Use your geographic knowledge to pick appropriate center + radius.
wx_calc Examples
- Dewpoint:
{"function": "dewpoint_from_relative_humidity", "args": {"temperature": "30 degC", "relative_humidity": "65 percent"}}
- Wind chill:
{"function": "wind_chill", "args": {"temperature": "-5 degC", "speed": "30 km/hr"}}
- Heat index:
{"function": "heat_index", "args": {"temperature": "95 degF", "relative_humidity": "60 percent"}}
- LCL:
{"function": "lcl", "args": {"pressure": "1000 hPa", "temperature": "30 degC", "dewpoint": "20 degC"}}
Image Tools
wx_radar_image and wx_model_image return PNG file paths in JSON.
For radar: provide NEXRAD site ID (KRTX=Portland, KTLX=OKC, KLOT=Chicago) or lat/lon. Default 1024px, 200km range, 10dBZ noise filter.
For model images: specify variable (cape, refl, temp, dewpoint, rh, gust, helicity, uh, precip, mslp, heights_500, jet, srh). Add lat/lon + radius_km to zoom. Use cycle parameter for specific model runs.
