energykitlisted
Install: claude install-skill thienqo/ios-skills
# EnergyKit
Query electricity cleanliness and cost forecasts and report device load telemetry using EnergyKit to help users shift power consumption to cleaner or cheaper grid periods. Targets Swift 6.4 / iOS 26+.
> **Beta-sensitive:** Core EnergyKit APIs require iOS/iPadOS 26.0+. iOS/iPadOS 27+ APIs (`ElectricalLoadDevice`, Home app LoadEvents integration) are beta-sensitive.
## Contents
- [Capabilities and Entitlements](#capabilities-and-entitlements)
- [Core Architecture](#core-architecture)
- [Action and Rating Semantics](#action-and-rating-semantics)
- [Route by Task](#route-by-task)
- [Common Mistakes](#common-mistakes)
- [Review Checklist](#review-checklist)
- [References](#references)
## Capabilities and Entitlements
All EnergyKit use requires the `com.apple.developer.energykit` entitlement. Enable the **EnergyKit** capability on your app target.
| Target Platform | Required Capabilities | Key APIs |
|---|---|---|
| iOS/iPadOS 26.x | EnergyKit | `ElectricityGuidance.Service`, `deviceID:` parameter |
| iOS/iPadOS 27+ | EnergyKit (+ EnergyKit LoadEvents for Home app) | `ElectricalLoadDevice`, `ElectricityInsightService` |
Handle `EnergyKitError.permissionDenied` when authorization is missing and `EnergyKitError.unsupportedRegion` outside supported grid territories (contiguous US).
## Core Architecture
1. **Electricity Guidance**: Time-weighted forecast stream telling apps when electricity is cleaner and less expensive.
- Use `.shift` for schedulable workload