platonai 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:
locationis missing or blankunitsis notmetricorimperial- 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