ura-ha-platform-reference

Reference URA Home Assistant integration architecture and coding practices.

1|Updated Feb 17, 2026
One-click install
npx skills add https://github.com/ojiudezue/universal-room-automation --skill ura-ha-platform-reference
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ura-ha-platform-reference
Source: https://github.com/ojiudezue/universal-room-automation/tree/main/.claude/skills/ura-ha-platform-reference
Command: npx skills add https://github.com/ojiudezue/universal-room-automation --skill ura-ha-platform-reference

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides essential knowledge and guidelines for modifying the URA (Universal Room Automation) Home Assistant integration safely and effectively.

Core Features & Use Cases

  • URA Platform Reference: Offers comprehensive information on URA's internal architecture and coding practices.
  • Config-entry Types: Details on ROOM, ZONE, CM, and INTEGRATION config-entry types and their setup processes.
  • Options Flow: Instructions for managing options flow in URA integrations.
  • Coordinators: Explanation of URA's unique coordinator hierarchy and how to interact with them.
  • Signals: Guidelines on using dispatcher signals in URA integrations.
  • RestoreEntity: Best practices for implementing RestoreEntity subclasses.
  • Background Tasks: Recommendations for managing background tasks in URA.
  • Service Calls: Advice on handling service calls with unavailable targets.
  • Manifest.json: Guidance on managing dependencies and after_dependencies in URA's manifest.json.
  • .storage/ Access: Clarifications on accessing and modifying the .storage/ directory.
  • Bug Classes: Information on common bug classes and their fixes in URA/HA integration.
  • Pre-ship Gate: Steps to ensure code quality before deploying changes.

Quick Start

Load the ura-ha-platform-reference skill before modifying the URA integration. Review the documentation on handling config-entry types and managing options flow to avoid common pitfalls.

Frequently Asked Questions about ura-ha-platform-reference

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

FAQPage Schema
How do I manage options flow in a Home Assistant integration?

To manage options flow in a Home Assistant integration, follow specific instructions for handling config-entry options to ensure proper setup and avoid common pitfalls during modification.

What are the different config-entry types in Universal Room Automation?

Universal Room Automation uses ROOM, ZONE, CM, and INTEGRATION config-entry types, each requiring specific setup processes and handling practices within the Home Assistant platform architecture.

How do coordinators work in the URA Home Assistant integration?

Coordinators in the URA Home Assistant integration follow a unique hierarchy, and you interact with them using specific coding practices to manage data updates and platform signals effectively.

What are common bug classes when modifying Home Assistant integrations?

Common bug classes when modifying Home Assistant integrations include issues with service calls to unavailable targets and incorrect RestoreEntity implementations, which require specific fixes and pre-ship quality checks.

Can I access the .storage/ directory in my Home Assistant integration?

You can access and modify the .storage/ directory in your Home Assistant integration, but you must follow specific clarifications and guidelines to ensure safe and correct implementation.

Do I need prior knowledge of HA APIs to use the URA platform reference?

You need prior knowledge of Universal Room Automation's internal mechanisms and Home Assistant's platform APIs to effectively use this reference for modifying the integration safely.