What I do

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

code

~/.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:

code

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

code

~/.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:

bash

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

•

Use geolocation to find coordinates:

bash

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

•
Extract latitude and longitude from the JSON response

•

Use coordinates with get-weather:

bash

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

•Return the current weather information in the following format:

code

╔════════════════════════════════════════════════════════════════════════════╗
║                          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)