Agent-Skills.md

Agent Skills: Default location (Overland Park, Kansas)

Return information about the weather for a given location.

UncategorizedID: chaddm/ad-astra-per-aspera/weather

Install this agent skill to your local

pnpm dlx add-skill https://github.com/chaddm/ad-astra-per-aspera/tree/HEAD/skills/weather

Skill Files

Browse the full folder contents for weather.

Download Skill

Loading file tree…

skills/weather/SKILL.md

Skill Metadata

Name
weather
Description
Return information about the weather for a given location.

What I do

  1. Run the following shell command with optional latitude and longitude parameters.
~/.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:

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

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

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

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

    ~/.config/opencode/skill/weather/get-weather --latitude 35.6895 --longitude 139.69171
  1. Return the current weather information in the following format:
╔════════════════════════════════════════════════════════════════════════════╗
║                          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)