weather_skill

Overview

This skill retrieves real-time and historical weather information directly from a professional weather API. It delivers current conditions, multi-day forecasts, and air quality data with higher timeliness and accuracy than generic search results. Use it when you need precise meteorological data for any city worldwide. The skill requires an API key and network access to the weather service.

How this skill works

The skill calls a configured weather API endpoint with the provided city name or geographic coordinates. It parses returned JSON to extract temperature, humidity, wind, weather descriptions, hourly and multi-day forecasts, and air quality indices. Responses are normalized so applications receive consistent fields regardless of the underlying API provider. Error handling reports API limits, missing keys, or invalid locations.

When to use it

• Get current weather for any city to display in an app or bot response.
• Retrieve hourly and multi-day forecasts for planning outdoor events or travel.
• Check air quality and pollutant levels for health-sensitive decisions.
• Compare historical weather data for analysis or reporting.
• Power widgets or dashboards that require frequent, accurate weather updates.

Best practices

• Store and rotate the API key securely; avoid embedding keys in client-side code.
• Cache responses short-term (e.g., 5–15 minutes) to reduce API calls and latency.
• Validate city names and support coordinates to handle ambiguous locations.
• Gracefully handle API errors and present fallback messages to users.
• Respect rate limits and batch requests when retrieving data for multiple cities.

Example use cases

• A travel assistant that provides local weather and hourly forecasts for upcoming trips.
• A smart home dashboard showing current conditions and a 7-day forecast.
• A fitness app that warns users when air quality is poor for outdoor workouts.
• A reporting tool that pulls historical weather to correlate with sales or event attendance.