weather

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

1. Activate the skill documentation with skill.activate("weather") if it is not already active.
2. Fetch the live weather JSON with skill.runScript("weather", "scripts/get_weather.py", [...args]).
3. 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

See Also

• Web Scraping Skill
• Data Validation Skill