weather

name: weather description: Fetches current weather conditions and a 7-day forecast for a requested location using Open-Meteo geocoding and forecast APIs. Use when the user asks about weather, temperature, rain, wind, or a weekly forecast for a place. allowed-tools: python metadata: displayName: Weather version: "1.0.0" author: Browser4 tags: "weather, forecast, climate, location"

Weather Skill

Description

Use this skill when a user needs current weather conditions or a 7-day forecast for a named location. The bundled script resolves the location with Open-Meteo geocoding, fetches live forecast data without an API key, and returns normalized JSON that is easy to summarize or quote directly.

Dependencies

None

Parameters

Parameter	Type	Required	Default	Description
location	String	Yes	-	Free-form location such as `Seattle, WA`, `London`, or `Tokyo`
units	String	No	metric	Unit system: `metric` for Celsius and km/h, or `imperial` for Fahrenheit and mph
countryCode	String	No	-	Optional ISO 3166-1 alpha-2 country code to disambiguate places such as `US`, `GB`, or `JP`

Return Value

The script prints JSON with the following shape:

{
  "query": {
    "location": "Seattle, WA",
    "units": "imperial",
    "countryCode": "US"
  },
  "resolvedLocation": {
    "name": "Seattle",
    "admin1": "Washington",
    "country": "United States",
    "countryCode": "US",
    "latitude": 47.61,
    "longitude": -122.33,
    "timezone": "America/Los_Angeles"
  },
  "current": {
    "time": "2026-04-09T09:00",
    "summary": "Partly cloudy",
    "temperature": 55.4,
    "temperatureUnit": "degF",
    "feelsLike": 53.8,
    "humidity": 68,
    "humidityUnit": "%",
    "precipitation": 0.0,
    "precipitationUnit": "inch",
    "windSpeed": 7.1,
    "windSpeedUnit": "mph",
    "windDirection": 220,
    "windDirectionUnit": "deg"
  },
  "forecast": [
    {
      "date": "2026-04-09",
      "summary": "Partly cloudy",
      "temperatureMax": 58.1,
      "temperatureMin": 45.3,
      "temperatureUnit": "degF",
      "precipitationProbabilityMax": 24,
      "precipitationProbabilityUnit": "%",
      "precipitationSum": 0.02,
      "precipitationSumUnit": "inch",
      "windSpeedMax": 12.4,
      "windSpeedUnit": "mph",
      "sunrise": "2026-04-09T06:31",
      "sunset": "2026-04-09T19:48"
    }
  ],
  "source": {
    "provider": "Open-Meteo",
    "forecastDays": 7
  }
}

Usage Examples

Activate the skill documentation with skill.activate("weather") if it is not already active.
Fetch the live weather JSON with skill.runScript("weather", "scripts/get_weather.py", [...args]).
Summarize the returned JSON for the user, explicitly calling out the current conditions and the 7-day forecast.

Current weather and 7-day forecast in metric units

skill.runScript(
    "weather",
    "scripts/get_weather.py",
    listOf("Berlin", "--units", "metric")
)

Disambiguate a city with a country code

skill.runScript(
    "weather",
    "scripts/get_weather.py",
    listOf("Springfield", "--country-code", "US", "--units", "imperial")
)

Error Handling

The script returns a non-zero exit code and an error JSON payload when:

location is missing or blank
units is not metric or imperial
geocoding cannot resolve the requested location
the upstream weather service is unavailable or returns malformed data

If multiple matching locations exist, use countryCode to disambiguate and rerun the script.

Implementation Notes

Uses only the Python standard library; no extra packages are required
Fetches live weather from Open-Meteo geocoding and forecast endpoints
Always returns the current conditions plus exactly 7 forecast days
Maps WMO weather codes to readable summaries before returning JSON