vinnividivicci/hvac-loads-skill

11 stars · Last commit 2026-10-01

A skill for HVAC load calculations

README preview

# hvac-loads-skill

A [Claude Code](https://claude.com/claude-code) skill that turns house plans (vector or scanned PDF) into **auditable room-by-room heating and cooling design loads**, using open-source engines. It also produces an **interactive 3D model of the exact surfaces used in the calculation**.

> **Professional-use notice.** This is a design aid for qualified professionals, like a calculation spreadsheet. It is **not** an ACCA-approved Manual J report and **not** a CSA F280-verified calculation. The professional using it remains responsible for the inputs, the method and the results.

![3D model of the BPC-022 sample house, rebuilt from scanned plans](docs/images/sonoma-model3d.png)

## What it does

```
plans.pdf ──► takeoff (Claude reads the plans; tools calibrate, crop, measure) ──► building.json
                                                                                  │  QA gates + your confirmation
                                                                                  ▼
                               typed surfaces (walls, windows, slabs, attic, crawlspace, garage…)
                     ┌───────────────────────────────┼───────────────────────────────┐
                     ▼                               ▼                               ▼
      ACCA Manual J procedures          EnergyPlus design-day heat balance     3D viewer + takeoff CSV
      via OpenStudio-HPXML (primary)    one zone per room (independent check)  (same surfaces)
                     └──────────────► comparison + report (EN/FR, PDF) ◄──────┘

View full repository on GitHub →