Home Assistant Integration knowledge

Document Home Assistant Integration structure and development guidelines.

15|2|Updated Nov 11, 2024
One-click install
npx skills add https://github.com/sebr/inception-home-assistant --skill home-assistant-integration-knowledge-sebr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Home Assistant Integration knowledge
Source: https://github.com/sebr/inception-home-assistant/tree/main/.agents/skills/home-assistant-integration-knowledge
Command: npx skills add https://github.com/sebr/inception-home-assistant --skill home-assistant-integration-knowledge-sebr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This knowledge base provides a centralized reference for building, testing, and reviewing Home Assistant Integrations, helping teams standardize architecture, reduce bugs, and accelerate development.

Core Features & Use Cases

  • Standard integration templates and file layouts to streamline development.
  • Comprehensive guidance on config flows, tests, quality scale, diagnostics, and repairs to ensure robust integrations.
  • Practical templates and examples for common patterns (manifest.json, init.py, strings.json, services.yaml) and testing approaches.

Quick Start

Consult this guide when starting a new Home Assistant integration to align with established development standards.

Frequently Asked Questions about Home Assistant Integration knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What files are required for a Home Assistant integration?

A standard Home Assistant integration requires manifest.json, __init__.py, config_flow.py, strings.json, and quality_scale.yaml to define its structure, configuration, and quality scale.

How do I structure config flows in Home Assistant development?

To structure config flows in Home Assistant development, implement config_flow.py using established validation and error handling patterns to guide users through setup and integration.

What is the Home Assistant quality scale and how do I apply it?

The Home Assistant quality scale is a standard for integration robustness applied via quality_scale.yaml, ensuring proper testing, diagnostics, and repairs are implemented.

How do I set up tests for a Home Assistant integration?

Set up tests for a Home Assistant integration by following standard development guidelines that provide practical templates and testing approaches for validating config flows and behaviors.

Does my Home Assistant integration need diagnostics and repairs?

Yes, comprehensive Home Assistant integrations include diagnostics and repairs to ensure robustness, following standard development guidelines for error handling and issue resolution.

What is the best way to audit an existing Home Assistant integration?

The best way to audit a Home Assistant integration is checking its file layouts, config flows, and quality_scale.yaml against standard development guidelines to identify missing patterns.