ura-diagnostics-and-tooling

Diagnose URA system state via entity reads, database checks, log analysis, and Samba mount validation.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive set of tools and diagnostics for the Universal Room Automation (URA) system, allowing users to measure and validate the system's state, logs, database, and Samba mount.

Core Features & Use Cases

  • Live Entity State Reads: Access live entity states via the Home Assistant MCP and URA sqlite database.
  • Log Analysis: Scan logs for errors and anomalies, distinguishing between signal and noise.
  • DB Verification: Query and verify the URA sqlite database for data integrity and correctness.
  • Samba Mount Validation: Confirm the Samba mount for the .storage/core.config_entries is active and up-to-date.
  • Use Case: Before deploying a new version of URA, use this Skill to ensure that all components are functioning correctly and to take pre-deploy row-rate snapshots for database-sensitive cycles.

Quick Start

Run the 'ura_log_triage.sh' script to analyze the Home Assistant log for URA-related errors and anomalies.

Frequently Asked Questions about ura-diagnostics-and-tooling

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

FAQPage Schema
How do I run diagnostics on a Universal Room Automation system in Home Assistant?

URA log analysis scans Home Assistant logs for URA-related errors and anomalies, distinguishing between signal and noise. The 'ura_log_triage.sh' script automates this process to identify system issues quickly.

How do I validate a Samba mount for Home Assistant core config entries?

Samba mount validation confirms the Samba mount for .storage/core.config_entries is active and up-to-date. This ensures your Universal Room Automation system accesses necessary configuration data reliably.

Does this URA diagnostics tool require access to a sqlite database?

Yes, URA diagnostics requires access to URA's sqlite database, Home Assistant logs, and Samba mounts. These dependencies are necessary for querying data integrity, scanning logs, and validating active mounts.

What is the best way to verify database integrity before deploying a new URA version?

To verify database integrity before deploying a new URA version, use this tool to query the URA sqlite database and take pre-deploy row-rate snapshots. This ensures data correctness during database-sensitive deployment cycles.

Why do I need to read live entity states when troubleshooting Home Assistant automation?

Reading live entity states during troubleshooting allows you to compare current Home Assistant MCP values against URA sqlite database records. This identifies discrepancies causing automation failures.