energykitlisted
Install: claude install-skill thiennc-tesoglobal/ios-skills
# EnergyKit
Use grid cleanliness and cost guidance to shift or reduce managed-device load.
For managed-device insights, submit the device's real load events promptly.
> **Beta-sensitive.** Core EnergyKit ships in iOS/iPadOS 26. The iOS/iPadOS 27
> `ElectricalLoadDevice` and Home-facing LoadEvents experience are beta; re-check
> current Apple documentation before relying on those APIs.
## Contents
- [Setup](#setup)
- [Core Concepts](#core-concepts)
- [Querying Electricity Guidance](#querying-electricity-guidance)
- [Working with Guidance Values](#working-with-guidance-values)
- [Energy Venues](#energy-venues)
- [Submitting Load Events](#submitting-load-events)
- [Electricity Insights](#electricity-insights)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)
## Setup
### Entitlements and Version Split
| Runtime | Load-event device API | Capabilities |
|---|---|---|
| iOS/iPadOS 26.x | `deviceID:` compatibility initializer | EnergyKit |
| iOS/iPadOS 27+ beta | `ElectricalLoadDevice` with the `device:` initializer | EnergyKit; add EnergyKit LoadEvents for Home app integration |
All EnergyKit use requires `com.apple.developer.energykit`; enable the EnergyKit
capability on the app target. On iOS/iPadOS 27+, add the EnergyKit LoadEvents
capability (`com.apple.developer.energykit.loadevents-experience`) only when the
app needs device names, energy context, activity logs, historical charts, or
trend notifications in the Ho