weatherkit

What This Skill Does

The weatherkit skill provides a direct interface to Apple's premium WeatherKit REST API. Unlike basic weather scrapers, this skill leverages professional-grade data sources to deliver highly precise, hyperlocal meteorological information. By utilizing JSON Web Token (JWT) authentication linked to your Apple Developer credentials, it ensures secure and authorized access to real-time data including UV indices, humidity levels, wind vectors, and precise sunrise/sunset timing. It is designed to handle both current snapshot requests and extended forecasting, supporting windows of up to 10 days for robust planning.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/jimmcq/weatherkit. Following installation, you must populate your environment configuration with your specific Apple Developer credentials. Ensure that the APPLE_TEAM_ID, APPLE_KEY_ID, APPLE_SERVICE_ID, and the local file system path to your .p8 private key (APPLE_WEATHERKIT_KEY_PATH) are correctly exported in your shell profile. Proper configuration of these variables is mandatory for the initial JWT handshake with Apple's servers.

Use Cases

This skill is perfect for scenarios requiring high-fidelity weather data. Use it to automate smart home lighting triggers based on actual sunset times, generate detailed outdoor activity reports for event planning, or integrate weather-dependent logic into your data analysis pipelines. It is particularly valuable for developers who need to ingest hyperlocal, long-range forecasts into decision-support systems or automated AI workflows.

Example Prompts

1. "Check the weather forecast for my hiking trip in coordinates 34.0522, -118.2437 from March 1st to March 5th."
2. "What is the current UV index and humidity in Los Angeles? I need to know if it's safe to keep my equipment outside."
3. "Give me a detailed daily forecast for London starting today for the next week, including the hourly breakdowns."

Tips & Limitations

Note that this skill relies on your Apple Developer account limits; please be mindful of your API request quotas to avoid throttling. Ensure your .p8 key has sufficient permissions within the Apple Developer portal. While the tool defaults to the US, always specify your country_code for international locations to ensure data accuracy. The tool provides granular datasets like forecastDaily and currentWeather by default, but you can request additional hourly data sets to suit your specific analytical needs. Always keep your private key file secure and restricted to read-only access for the user running the OpenClaw agent.