energykit
Query grid electricity forecasts and submit load events using EnergyKit to help users optimize home electricity usage. Use when building smart home apps, EV charger controls, HVAC scheduling, or energy management dashboards that guide users to use power during cleaner or cheaper grid periods.
Security Assessment
Detected risks:
About energykit
The EnergyKit skill enables developers to build energy-intelligent applications by providing access to grid electricity forecasts and load event telemetry. It helps users optimize their home electricity usage by identifying times when grid power is cleaner and less expensive, allowing apps to shift or reduce managed device loads accordingly. This skill targets iOS 26+ and Swift 6.3, offering real-time guidance that considers both environmental impact and cost when available.
The skill provides two main capabilities: electricity guidance forecasts that deliver time-weighted ratings indicating optimal usage periods, and load event submission that allows apps to report actual device usage back to the system. It supports common smart home devices including EV chargers and HVAC systems, with queries structured around shift actions (moving consumption to different times) or reduce actions (lowering consumption without stopping). The guidance system streams continuous updates and includes venue-based management for handling multiple physical locations.
This skill is designed for developers building smart home applications, EV charging schedulers, HVAC control systems, and energy management dashboards. It requires the com.apple.developer.energykit entitlement and is currently in beta for iOS 26, meaning APIs may change before the GM release. Use cases include automated EV charging during off-peak or clean energy periods, intelligent HVAC scheduling to reduce costs while maintaining comfort, and energy monitoring dashboards that provide users with actionable insights about their electricity usage patterns and savings opportunities.
FAQ
What iOS version is required for EnergyKit?
EnergyKit requires iOS 26.0+ or iPadOS 26.0+ for core functionality. Some advanced features like grid cleanliness categories require iOS 26.1+ or iPadOS 26.1+ and need appropriate availability guards.
What entitlement is needed to use EnergyKit?
You must enable the com.apple.developer.energykit entitlement in your Xcode project. This should be configured as a capability in your app target before implementing any EnergyKit features. Missing this entitlement will result in EnergyKitError.permissionDenied errors.
What types of devices are supported for load events?
EnergyKit supports submitting load events for electric vehicle chargers (using ElectricVehicleLoadEvent) and HVAC systems (using ElectricHVACLoadEvent). These load events enable the system to generate insights based on actual device usage.
How does EnergyKit provide cost information?
EnergyKit incorporates rate plan information when available in the guidance data. You can check if rate information is included by examining the guidance.options property for the guidanceIncorporatesRatePlan flag. Cost data availability depends on the utility provider and location.
Is EnergyKit API stable for production use?
EnergyKit is marked as beta-sensitive since it's new in iOS 26. APIs may change before the GM release. Developers should re-check current Apple documentation before relying on specific API details in production applications.
Install energykit
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
dpearson2699/swift-ios-skills