home-assistant-dev-guidelines

The packages pattern modularizes your Home Assistant setup by splitting automations, sensors, and scripts into separate YAML files grouped by function. This reduces clutter, improves maintainability, and makes debugging easier across large configurations.

Use Jinja2 templates in triggers, conditions, and actions to create dynamic automations that respond to sensor states and context. Structure templates safely by validating template syntax against official documentation and avoiding unsafe variable interpolation in your automation definitions.

Apply consistent entity naming, standardized YAML formatting, and structured automation naming conventions to ensure your configuration remains readable and scalable. These standards prevent naming collisions and make automations easier to locate and modify later.

Yes. Presence detection and notification automations benefit from standardized trigger-condition-action patterns, proper template handling, and package organization. This Skill guides you through defining reliable presence logic and integrating notifications into your automation workflow.

Test automation logic by validating YAML syntax, verifying template safety, and checking trigger conditions against real entity states. Implement error handling in actions to gracefully manage failed notifications or state transitions without breaking dependent automations.

Familiarity with YAML syntax, basic Home Assistant entities, and automation concepts helps, but this Skill guides you from planning through deployment. Start by reviewing YAML formatting rules and entity naming conventions before organizing your first package.