aod-diagnostics-and-tooling

Monitors and analyzes Area Occupancy Detection system performance in Home Assistant, diagnosing sensor errors and pipeline issues.

316|9|Updated Nov 23, 2024
One-click install
npx skills add https://github.com/Hankanman/Area-Occupancy-Detection --skill aod-diagnostics-and-tooling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aod-diagnostics-and-tooling
Source: https://github.com/Hankanman/Area-Occupancy-Detection/tree/main/.claude/skills/aod-diagnostics-and-tooling
Command: npx skills add https://github.com/Hankanman/Area-Occupancy-Detection --skill aod-diagnostics-and-tooling

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides diagnostics tools for monitoring and interpreting the performance of the Area Occupancy Detection system in Home Assistant, helping users identify and address issues in their setups.

Core Features & Use Cases

  • Diagnostics Export: Access detailed diagnostic information on integration version, configuration version, areas, sensors, and health issues.
  • Health Checks: Run structured anomaly detection on sensor health, correlation failures, and other potential issues.
  • Debug Log Interpretation: Guide on interpreting the hourly analysis pipeline and sensor health logs for debugging purposes.
  • Simulator: Simulate occupancy scenarios to compare predicted probabilities against real-time sensor data.
  • Scripts: Provide read-only scripts for accessing the database schema and learning priors.
  • Use Case: A user might use this Skill to diagnose a problem where their area occupancy sensors are reporting false positives. They can use the Health Checks to identify potential sensor issues, the Simulator to validate their understanding of sensor readings, and the Scripts to directly inspect the database.

Quick Start

Use the 'aod-diagnostics-and-tooling' skill to download and inspect the diagnostics report for the Area Occupancy Detection integration.

Frequently Asked Questions about aod-diagnostics-and-tooling

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

FAQPage Schema
How do I diagnose false positives in my Home Assistant area occupancy sensors?

To diagnose area occupancy detection false positives, use health checks to identify sensor anomalies and correlation failures, then validate sensor behavior by simulating occupancy scenarios and comparing predicted probabilities against real-time data.

What is included in an Area Occupancy Detection diagnostics export?

An Area Occupancy Detection diagnostics export provides detailed information on integration version, configuration version, defined areas, configured sensors, and any detected health issues within your Home Assistant setup.

How do I interpret debug logs for the area occupancy detection pipeline?

Interpreting area occupancy detection debug logs involves analyzing the hourly pipeline and sensor health logs to identify pipeline errors, sensor malfunctions, or insufficient learning data affecting your system.

Do I need a Python environment to run area occupancy detection diagnostics?

Yes, you need a Python environment to execute diagnostic scripts, access the database schema, inspect learning priors, and run the interactive simulator for troubleshooting area occupancy detection scenarios.

Why does my area occupancy detection system report insufficient learning data?

Area occupancy detection reports insufficient learning data when the system lacks enough historical sensor correlations to build accurate priors, which you can verify by running read-only scripts to directly inspect the database schema.