energyplus-assistant

Identify and fix QA/QC issues in EnergyPlus IDF models.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/mbcoalson/skills --skill energyplus-assistant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: energyplus-assistant
Source: https://github.com/mbcoalson/skills/tree/main/.claude/skills/energyplus-assistant
Command: npx skills add https://github.com/mbcoalson/skills --skill energyplus-assistant

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires eppy, beautifulsoup4, pandas, openpyxl, and includes scripts (resource) and templates (resource) and examples (resource) components.

What problem does it solve?

EnergyPlus IDF model analysis, QA/QC, and simulation workflows are complex, time-consuming, and often require specific environment setups (like Docker/MCP), leading to inefficiencies and errors. This Skill provides intelligent, environment-aware automation to streamline these processes.

Core Features & Use Cases

  • Fast Pre-Simulation QA/QC: Performs rapid validation using direct IDF parsing (Python/eppy) in seconds, avoiding lengthy simulation failures.
  • Automated IDF Repair: Fixes common issues like corrupt ZoneHVAC:EquipmentList objects, field shifts, and IDF version mismatches.
  • HVAC System Analysis: Discovers and visualizes HVAC topology, aiding in understanding and troubleshooting complex systems.
  • ECM Testing: Facilitates parametric studies for energy conservation measures (e.g., lighting, envelope, schedules).
  • Use Case: "Run a quick QA/QC check on my 'model.idf' file to ensure it's ready for simulation, then fix any detected equipment list corruptions."

Quick Start

Run a quick QA/QC check on my 'model.idf' file.

Frequently Asked Questions about energyplus-assistant

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

FAQPage Schema
How do I run QA/QC checks on EnergyPlus IDF files before simulation?

QA/QC validation on IDF files identifies issues like corrupt equipment lists and field misalignments using direct Python parsing with eppy, completing in seconds without running full simulations. This Skill automates rapid pre-simulation checks to prevent costly simulation failures.

Can I automatically fix common errors in EnergyPlus IDF models?

Yes, automated IDF repair fixes common issues including corrupt ZoneHVAC:EquipmentList objects, field shifts, and version mismatches. The Skill identifies and corrects these problems directly in your IDF files, preparing them for reliable simulation.

How do I analyze HVAC system topology in EnergyPlus models?

HVAC system analysis discovers and visualizes equipment connections and topology within EnergyPlus models, helping you understand complex systems and troubleshoot configuration issues. This Skill parses IDF structure to map HVAC relationships automatically.

Can I run parametric energy conservation measure testing across multiple IDF models?

Parametric ECM testing enables systematic evaluation of energy conservation measures like lighting, envelope, and schedule changes across project models. The Skill supports batch analysis and generates comparative results for measure impact assessment.

Does this work with Windows paths and Docker environments?

The Skill includes environment-aware logic handling Windows path formats, Docker availability, and non-destructive outputs. It adapts automatically to your setup, supporting both direct parsing and MCP-based workflows depending on your environment.

What dependencies do I need to run EnergyPlus model analysis?

Required dependencies include eppy for IDF parsing, beautifulsoup4 for data extraction, pandas for analysis, and openpyxl for spreadsheet output. These libraries enable comprehensive IDF validation, repair, and reporting workflows.