plenum-diagnostics-and-tooling

Analyze Plenum HVAC runtime behavior from SQLite history and logs.

6|1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/dhruvb14/smart-thermostat-with-vents --skill plenum-diagnostics-and-tooling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plenum-diagnostics-and-tooling
Source: https://github.com/dhruvb14/smart-thermostat-with-vents/tree/main/.claude/skills/plenum-diagnostics-and-tooling
Command: npx skills add https://github.com/dhruvb14/smart-thermostat-with-vents --skill plenum-diagnostics-and-tooling

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill solves the challenge of understanding HVAC zoning behavior by turning vague comfort issues into measurable diagnostics, historical evidence, and actionable system insights.

Core Features & Use Cases

  • Database Diagnostics: Query the Plenum SQLite app database to inspect cycles, room behavior, events, setpoints, vents, and historical performance.
  • Runtime Monitoring: Analyze live API status, WebSocket events, logs, and health endpoints to understand what the HVAC engine is doing now.
  • Quality Analysis: Use diagnostic scripts to identify short cycling, oscillation, overshoot, drifting rooms, and other HVAC performance problems.

Quick Start

Use the plenum diagnostics and tooling skill to analyze my Plenum app database and identify recent HVAC performance issues.

Frequently Asked Questions about plenum-diagnostics-and-tooling

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

FAQPage Schema
How do I diagnose HVAC short cycling and overshoot from thermostat logs?

HVAC short cycling and overshoot are diagnosed by running scripts against the Plenum SQLite history to calculate cycle reports, overshoot statistics, and operational health indicators from stored system activity.

What's the best way to monitor live HVAC WebSocket events and API status?

Live HVAC WebSocket events and API status are monitored by inspecting the Plenum runtime through health endpoints and event streams, capturing real-time engine behavior to understand current system operations.

Can I use SQLite database diagnostics to troubleshoot smart thermostat zoning issues?

SQLite database diagnostics troubleshoot smart thermostat zoning issues by querying the Plenum app database to inspect room behavior, setpoints, vents, and historical performance evidence stored in the system.

Do I need read-only database access to analyze HVAC performance metrics?

Read-only database access is required to analyze HVAC performance metrics, as the diagnostic scripts safely query stored Plenum system activity without modifying the live smart thermostat state or historical data.

How do I identify drifting rooms and oscillation in HVAC historical data?

Drifting rooms and oscillation in HVAC historical data are identified using quality analysis scripts that process event streams and cycle reports to detect performance anomalies and operational health problems.

Why does my HVAC system show vague comfort issues and how can I measure them?

Vague comfort issues are measured by converting stored Plenum system activity into actionable diagnostics and historical evidence, transforming unclear temperature complaints into quantifiable cycle reports and overshoot statistics.