weather

---

name: weather description: Return information about the weather for a given location. license: MIT compatibility: opencode metadata:

What I do

1. Run the following shell command with optional latitude and longitude parameters.

Copy~/.config/opencode/skill/weather/get-weather [--latitude <lat>] [--longitude <lon>]

Parameters:

• --latitude <lat> (optional): Latitude in decimal degrees (WGS84). Default: 38.9822 (Overland Park, KS)
• --longitude <lon> (optional): Longitude in decimal degrees (WGS84). Default: -94.6708 (Overland Park, KS)

Examples:

Copy# Default location (Overland Park, Kansas)
~/.config/opencode/skill/weather/get-weather

# Specific location (Toronto, Canada)
~/.config/opencode/skill/weather/get-weather --latitude 43.65 --longitude -79.38

# New York City
~/.config/opencode/skill/weather/get-weather --latitude 40.7128 --longitude -74.0060

---

Geolocation Helper Script

If you don't know the latitude and longitude of a location, use the geolocation script to search for cities, states, or postal codes and get their coordinates.

Usage:

Copy~/.config/opencode/skill/weather/geolocation --name <search_term> [options]

Required:

• --name <string>: Search term (city name, postal code, state, etc.)

Options:

• --count <number>: Number of results to return (1-100, default: 10)
• --language <string>: Language code for translated results (default: en)
• --countryCode <string>: ISO-3166-1 alpha2 country code filter (e.g., US, FR, DE)
• --format <string>: Response format (json or protobuf, default: json)
• --help, -h: Show help message

Examples:

Copy# Search for a city
~/.config/opencode/skill/weather/geolocation --name "Seattle"

# Search with result limit
~/.config/opencode/skill/weather/geolocation --name "Springfield" --count 3

# Search with country filter (Paris, France only)
~/.config/opencode/skill/weather/geolocation --name "Paris" --countryCode "FR" --count 1

# Search by postal/zip code
~/.config/opencode/skill/weather/geolocation --name "10001" --countryCode "US"

# Search with language preference (German)
~/.config/opencode/skill/weather/geolocation --name "Munich" --language "de"

Response Format:

The script returns JSON with an array of matching locations, each containing:

• id: Unique location identifier
• name: Location name
• latitude: Latitude coordinate (WGS84)
• longitude: Longitude coordinate (WGS84)
• elevation: Elevation in meters above sea level
• timezone: IANA timezone identifier
• country: Country name
• country_code: ISO-3166-1 alpha2 country code
• admin1: First-level administrative area (state/province)
• admin2: Second-level administrative area (county/district)
• population: Number of inhabitants
• postcodes: Array of postal codes

Typical Workflow:

1. Use geolocation to find coordinates:

   Copy~/.config/opencode/skill/weather/geolocation --name "Tokyo" --countryCode "JP" --count 1
   

2. Extract latitude and longitude from the JSON response

3. Use coordinates with get-weather:

   Copy~/.config/opencode/skill/weather/get-weather --latitude 35.6895 --longitude 139.69171
   

---

1. Return the current weather information in the following format:

Copy╔════════════════════════════════════════════════════════════════════════════╗
║                          WEATHER FORECAST                                  ║
╠════════════════════════════════════════════════════════════════════════════╣
║ Location: {latitude}°N, {longitude}°E                                      ║
║ Elevation: {elevation}m asl                                                ║
║ Timezone: {timezone} ({timezone_abbreviation})                             ║
╠════════════════════════════════════════════════════════════════════════════╣
║                        CURRENT CONDITIONS                                  ║
╠════════════════════════════════════════════════════════════════════════════╣
║ Time: {current_time}                                                       ║
║ Temperature: {temp}°C (Feels like: {apparent_temp}°C)                      ║
║ Humidity: {humidity}%                                                      ║
║ Dew Point: {dew_point}°C                                                   ║
║ Weather: {weather_description}                                             ║
║                                                                            ║
║ Wind: {wind_speed} km/h {wind_direction}                                   ║
║ Gusts: {wind_gusts} km/h                                                   ║
║ Pressure: {pressure} hPa                                                   ║
║ Visibility: {visibility} m                                                 ║
║                                                                            ║
║ Cloud Cover: {cloud_cover}%                                                ║
║   Low: {cloud_low}% | Mid: {cloud_mid}% | High: {cloud_high}%             ║
║                                                                            ║
║ Precipitation: {precip}mm (Probability: {precip_prob}%)                    ║
║   Rain: {rain}mm | Showers: {showers}mm | Snow: {snow}mm                  ║
║                                                                            ║
║ UV Index: {uv_index} (Clear Sky: {uv_clear})                              ║
║ Sunshine Duration: {sunshine}s                                             ║
║ Day/Night: {is_day}                                                        ║
╠════════════════════════════════════════════════════════════════════════════╣
║                          6-HOUR FORECAST                                   ║
╠════════════════════════════════════════════════════════════════════════════╣
║ Hour     | Temp | Precip | Wind   | Clouds | Conditions                   ║
║----------|------|--------|--------|--------|------------------------------║
║ {h+1}    | {t}° | {p}%   | {w} km | {c}%   | {desc}                       ║
║ {h+2}    | {t}° | {p}%   | {w} km | {c}%   | {desc}                       ║
║ {h+3}    | {t}° | {p}%   | {w} km | {c}%   | {desc}                       ║
║ {h+4}    | {t}° | {p}%   | {w} km | {c}%   | {desc}                       ║
║ {h+5}    | {t}° | {p}%   | {w} km | {c}%   | {desc}                       ║
║ {h+6}    | {t}° | {p}%   | {w} km | {c}%   | {desc}                       ║
╚════════════════════════════════════════════════════════════════════════════╝

Formatting Requirements:

Each line MUST be exactly 76 characters between the ║ characters. Use padding to ensure alignment.

Field Formatting:

• All numeric fields must be right-aligned within their space
• Text fields must be left-aligned within their space
• Pad with spaces to maintain exact column widths

Current Conditions Section:

• Each label line: "Label: value" format, pad to 76 chars total
• Format numbers consistently:
  • Coordinates: 1 decimal place (e.g., "38.98°N")
  • Temperature: 1 decimal place (e.g., "5.7°C")
  • Percentages: whole numbers (e.g., "52%")
  • Wind: 1 decimal place (e.g., "16.3 km/h")
  • Pressure: 1 decimal place (e.g., "973.7 hPa")
  • Visibility: whole meters (e.g., "35900 m")

6-Hour Forecast Table Column Widths:

• Hour: 9 chars (left-aligned, e.g., "07:00 PM ")
• Temp: 5 chars (right-aligned number + "°", e.g., " 5°" or " -2°")
• Precip: 7 chars (right-aligned number + "%", e.g., " 0%" or " 100%")
• Wind: 7 chars (right-aligned number + " km", e.g., " 16 km" or " 9 km")
• Clouds: 7 chars (right-aligned number + "%", e.g., " 2%" or " 100%")
• Conditions: 29 chars (left-aligned, e.g., "Clear sky ")

Weather Code Mapping:

• 0: Clear sky
• 1-3: Partly cloudy
• 45, 48: Fog
• 51-67: Rain
• 71-77: Snow
• 80-82: Showers
• 95-99: Thunderstorm

Additional Requirements:

• Convert wind_direction_10m from degrees to cardinal direction (N, NE, E, SE, S, SW, W, NW)
• Format is_day as "Day" or "Night"
• Show current hour data (index 0) for current conditions
• Show next 6 hours (indices 1-6) for forecast table
• All temperatures in Celsius, distances in meters/kilometers

When to use me

Use me to get weather information for any location worldwide. You can:

• Provide latitude and longitude coordinates directly with get-weather
• Use the geolocation helper script to search for locations by city name, state, or postal code
• Call get-weather without parameters to get weather for the default location (Overland Park, Kansas)