---
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

1. **Start lightweight.** Use `wx_conditions` or `wx_brief` before heavier tools.
2. **Images only when asked.** Don't call image tools unless the user wants to SEE something.
3. **US vs international.** Use `wx_global` for non-US locations.
4. **Calculations are verified.** `wx_calc` uses metrust — 205 Rust-backed functions verified against MetPy.
5. **Don't stack redundant calls.** `wx_brief` already includes conditions + forecast + alerts.
6. **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.
7. **Severe weather package.** For severe weather analysis, use: `var: "cape,helicity,uh,srh"` — one call, 4 images.
8. **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.