Home Assistant Entities
When to Use This Skill
| Use this skill when... |
Use ha-automations instead when... |
| Understanding entity domains |
Creating automation rules |
| Customizing entities |
Working with triggers/actions |
| Creating template sensors |
Writing automation conditions |
| Setting up groups |
Working with scripts/scenes |
| Working with device classes |
Handling events |
Entity ID Structure
domain.object_id
Examples:
light.living_room_ceilingsensor.outdoor_temperaturebinary_sensor.front_door_contactswitch.garden_irrigation
Common Domains
| Domain |
Description |
Example |
light |
Lighting control |
light.kitchen |
switch |
On/off switches |
switch.outlet |
sensor |
Numeric sensors |
sensor.temperature |
binary_sensor |
On/off sensors |
binary_sensor.motion |
climate |
HVAC control |
climate.thermostat |
cover |
Blinds, garage doors |
cover.garage |
lock |
Door locks |
lock.front_door |
media_player |
Media devices |
media_player.tv |
camera |
Camera feeds |
camera.front_yard |
vacuum |
Robot vacuums |
vacuum.roomba |
fan |
Fan control |
fan.bedroom |
alarm_control_panel |
Alarm systems |
alarm_control_panel.home |
person |
People tracking |
person.john |
device_tracker |
Device location |
device_tracker.phone |
weather |
Weather info |
weather.home |
input_boolean |
Virtual toggle |
input_boolean.guest_mode |
input_number |
Virtual number |
input_number.target_temp |
input_select |
Virtual dropdown |
input_select.house_mode |
input_text |
Virtual text |
input_text.message |
input_datetime |
Virtual date/time |
input_datetime.alarm |
input_button |
Virtual button |
input_button.reset |
automation |
Automations |
automation.motion_light |
script |
Scripts |
script.morning_routine |
scene |
Scenes |
scene.movie_night |
group |
Entity groups |
group.all_lights |
timer |
Countdown timers |
timer.laundry |
counter |
Counters |
counter.guests |
zone |
Geographic zones |
zone.home |
sun |
Sun position |
sun.sun |
For complete device class tables (binary sensor and sensor), see REFERENCE.md.
Entity Customization
customize.yaml
# Single entity
light.living_room:
friendly_name: "Living Room Light"
icon: mdi:ceiling-light
# Binary sensor
binary_sensor.front_door:
friendly_name: "Front Door"
device_class: door
# Sensor
sensor.outdoor_temperature:
friendly_name: "Outdoor Temperature"
device_class: temperature
unit_of_measurement: "°C"
Glob Customization
customize_glob:
"light.*_ceiling":
icon: mdi:ceiling-light
"sensor.*_temperature":
device_class: temperature
unit_of_measurement: "°C"
"binary_sensor.*_motion":
device_class: motion
Template Sensors
template:
- sensor:
# Simple state
- name: "Average Temperature"
unit_of_measurement: "°C"
device_class: temperature
state: >-
{{ ((states('sensor.living_room_temp') | float +
states('sensor.bedroom_temp') | float +
states('sensor.kitchen_temp') | float) / 3) | round(1) }}
# With attributes
- name: "Power Usage"
unit_of_measurement: "W"
device_class: power
state: "{{ states('sensor.energy_meter_power') }}"
attributes:
cost_per_hour: >-
{{ (states('sensor.energy_meter_power') | float * 0.15 / 1000) | round(2) }}
# Availability
- name: "Solar Power"
unit_of_measurement: "W"
device_class: power
state: "{{ states('sensor.inverter_power') }}"
availability: "{{ states('sensor.inverter_power') != 'unavailable' }}"
For template binary sensors, switches, buttons, numbers, groups, utility meters, counters, and timers, see REFERENCE.md.
State Attributes
Common Attributes
| Domain |
Common Attributes |
light |
brightness, color_temp, rgb_color, hs_color, effect |
climate |
temperature, current_temperature, hvac_action, preset_mode |
media_player |
volume_level, media_title, media_artist, source |
cover |
current_position, current_tilt_position |
weather |
temperature, humidity, pressure, wind_speed, forecast |
person |
source, latitude, longitude, gps_accuracy |
sun |
elevation, azimuth, next_rising, next_setting |
Accessing Attributes
# In templates
{{ state_attr('light.living_room', 'brightness') }}
{{ state_attr('climate.thermostat', 'current_temperature') }}
{{ state_attr('sun.sun', 'elevation') }}
# In conditions
condition:
- condition: numeric_state
entity_id: light.living_room
attribute: brightness
above: 100
Quick Reference
State Functions
| Function |
Description |
Example |
states('entity') |
Get state |
states('sensor.temp') |
state_attr('entity', 'attr') |
Get attribute |
state_attr('light.x', 'brightness') |
is_state('entity', 'value') |
Check state |
is_state('light.x', 'on') |
is_state_attr('entity', 'attr', 'val') |
Check attribute |
is_state_attr('climate.x', 'hvac_action', 'heating') |
states.domain |
All entities in domain |
states.light |
expand('group.x') |
Expand group members |
expand('group.all_lights') |
Agentic Optimizations
| Context |
Command |
| Find entity usage |
grep -r "entity_id:" config/ --include="*.yaml" |
| List customizations |
grep -rA2 "^[a-z_]*\\..*:" config/customize.yaml |
| Find template sensors |
grep -rB2 "platform: template" config/ --include="*.yaml" |
| Find groups |
grep -rA5 "^group:" config/ --include="*.yaml" |
| List domains used |
grep -roh "[a-z_]*\\." config/ --include="*.yaml" | sort -u |
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: laurigates-claude-plugins-ha-entities3description: Home Assistant Entities4---56# Home Assistant Entities78## When to Use This Skill910| Use this skill when... | Use ha-automations instead when... |11|------------------------|-----------------------------------|12| Understanding entity domains | Creating automation rules |13| Customizing entities | Working with triggers/actions |14| Creating template sensors | Writing automation conditions |15| Setting up groups | Working with scripts/scenes |16| Working with device classes | Handling events |1718## Entity ID Structure1920```21domain.object_id22```2324**Examples:**25- `light.living_room_ceiling`26- `sensor.outdoor_temperature`27- `binary_sensor.front_door_contact`28- `switch.garden_irrigation`2930## Common Domains3132| Domain | Description | Example |33|--------|-------------|---------|34| `light` | Lighting control | `light.kitchen` |35| `switch` | On/off switches | `switch.outlet` |36| `sensor` | Numeric sensors | `sensor.temperature` |37| `binary_sensor` | On/off sensors | `binary_sensor.motion` |38| `climate` | HVAC control | `climate.thermostat` |39| `cover` | Blinds, garage doors | `cover.garage` |40| `lock` | Door locks | `lock.front_door` |41| `media_player` | Media devices | `media_player.tv` |42| `camera` | Camera feeds | `camera.front_yard` |43| `vacuum` | Robot vacuums | `vacuum.roomba` |44| `fan` | Fan control | `fan.bedroom` |45| `alarm_control_panel` | Alarm systems | `alarm_control_panel.home` |46| `person` | People tracking | `person.john` |47| `device_tracker` | Device location | `device_tracker.phone` |48| `weather` | Weather info | `weather.home` |49| `input_boolean` | Virtual toggle | `input_boolean.guest_mode` |50| `input_number` | Virtual number | `input_number.target_temp` |51| `input_select` | Virtual dropdown | `input_select.house_mode` |52| `input_text` | Virtual text | `input_text.message` |53| `input_datetime` | Virtual date/time | `input_datetime.alarm` |54| `input_button` | Virtual button | `input_button.reset` |55| `automation` | Automations | `automation.motion_light` |56| `script` | Scripts | `script.morning_routine` |57| `scene` | Scenes | `scene.movie_night` |58| `group` | Entity groups | `group.all_lights` |59| `timer` | Countdown timers | `timer.laundry` |60| `counter` | Counters | `counter.guests` |61| `zone` | Geographic zones | `zone.home` |62| `sun` | Sun position | `sun.sun` |6364For complete device class tables (binary sensor and sensor), see [REFERENCE.md](REFERENCE.md).6566## Entity Customization6768### customize.yaml6970```yaml71# Single entity72light.living_room:73 friendly_name: "Living Room Light"74 icon: mdi:ceiling-light7576# Binary sensor77binary_sensor.front_door:78 friendly_name: "Front Door"79 device_class: door8081# Sensor82sensor.outdoor_temperature:83 friendly_name: "Outdoor Temperature"84 device_class: temperature85 unit_of_measurement: "°C"86```8788### Glob Customization8990```yaml91customize_glob:92 "light.*_ceiling":93 icon: mdi:ceiling-light9495 "sensor.*_temperature":96 device_class: temperature97 unit_of_measurement: "°C"9899 "binary_sensor.*_motion":100 device_class: motion101```102103## Template Sensors104105```yaml106template:107 - sensor:108 # Simple state109 - name: "Average Temperature"110 unit_of_measurement: "°C"111 device_class: temperature112 state: >-113 {{ ((states('sensor.living_room_temp') | float +114 states('sensor.bedroom_temp') | float +115 states('sensor.kitchen_temp') | float) / 3) | round(1) }}116117 # With attributes118 - name: "Power Usage"119 unit_of_measurement: "W"120 device_class: power121 state: "{{ states('sensor.energy_meter_power') }}"122 attributes:123 cost_per_hour: >-124 {{ (states('sensor.energy_meter_power') | float * 0.15 / 1000) | round(2) }}125126 # Availability127 - name: "Solar Power"128 unit_of_measurement: "W"129 device_class: power130 state: "{{ states('sensor.inverter_power') }}"131 availability: "{{ states('sensor.inverter_power') != 'unavailable' }}"132```133134For template binary sensors, switches, buttons, numbers, groups, utility meters, counters, and timers, see [REFERENCE.md](REFERENCE.md).135136## State Attributes137138### Common Attributes139140| Domain | Common Attributes |141|--------|-------------------|142| `light` | `brightness`, `color_temp`, `rgb_color`, `hs_color`, `effect` |143| `climate` | `temperature`, `current_temperature`, `hvac_action`, `preset_mode` |144| `media_player` | `volume_level`, `media_title`, `media_artist`, `source` |145| `cover` | `current_position`, `current_tilt_position` |146| `weather` | `temperature`, `humidity`, `pressure`, `wind_speed`, `forecast` |147| `person` | `source`, `latitude`, `longitude`, `gps_accuracy` |148| `sun` | `elevation`, `azimuth`, `next_rising`, `next_setting` |149150### Accessing Attributes151152```yaml153# In templates154{{ state_attr('light.living_room', 'brightness') }}155{{ state_attr('climate.thermostat', 'current_temperature') }}156{{ state_attr('sun.sun', 'elevation') }}157158# In conditions159condition:160 - condition: numeric_state161 entity_id: light.living_room162 attribute: brightness163 above: 100164```165166## Quick Reference167168### State Functions169170| Function | Description | Example |171|----------|-------------|---------|172| `states('entity')` | Get state | `states('sensor.temp')` |173| `state_attr('entity', 'attr')` | Get attribute | `state_attr('light.x', 'brightness')` |174| `is_state('entity', 'value')` | Check state | `is_state('light.x', 'on')` |175| `is_state_attr('entity', 'attr', 'val')` | Check attribute | `is_state_attr('climate.x', 'hvac_action', 'heating')` |176| `states.domain` | All entities in domain | `states.light` |177| `expand('group.x')` | Expand group members | `expand('group.all_lights')` |178179## Agentic Optimizations180181| Context | Command |182|---------|---------|183| Find entity usage | `grep -r "entity_id:" config/ --include="*.yaml"` |184| List customizations | `grep -rA2 "^[a-z_]*\\..*:" config/customize.yaml` |185| Find template sensors | `grep -rB2 "platform: template" config/ --include="*.yaml"` |186| Find groups | `grep -rA5 "^group:" config/ --include="*.yaml"` |187| List domains used | `grep -roh "[a-z_]*\\." config/ --include="*.yaml" \| sort -u` |188189---190> Converted and distributed by [TomeVault](https://tomevault.io/claim/laurigates) — claim your Tome and manage your conversions.191<!-- tomevault:4.0:skill_md:2026-04-11 -->
tomevault-io