How vinnividivicci/hvac-loads-skill works
This repository is a Claude Code skill and Python toolkit for turning house plans into auditable room-by-room heating and cooling loads. The user supplies plans and site context; plan takeoff produces a building model, which is validated before design conditions and two load methods are run. Results are compared and delivered as a report, takeoff CSV, JSON, and interactive 3D model. The graph preserves documented capability branches, but some internals are unsampled; uncertain connections are omitted rather than inferred.
Main entry points: pipeline.py Project pipeline · geometry.py Typed surfaces · results.py Load comparison · design.py Design conditions
Components 21
Project workflow
- HVAC load skill
skills/hvac-load-calc/SKILL.md - Command tools
skills/hvac-load-calc/scripts/hvacload.py - Project pipeline
skills/hvac-load-calc/scripts/hvacload/pipeline.py
Plans and model
- PDF plan tools
skills/hvac-load-calc/scripts/hvacload/pdfkit.py - Building model
skills/hvac-load-calc/scripts/hvacload/model.py - Typed surfaces
skills/hvac-load-calc/scripts/hvacload/geometry.py - Geometry QA
skills/hvac-load-calc/scripts/hvacload/qa.py - Assembly properties
skills/hvac-load-calc/scripts/hvacload/assembly.py
Design loads
- Design conditions
skills/hvac-load-calc/scripts/hvacload/design.py - Weather and codes
skills/hvac-load-calc/scripts/hvacload/weather.py - NBC conditions
skills/hvac-load-calc/scripts/hvacload/codes.py - Manual J engine
skills/hvac-load-calc/scripts/hvacload/hpxml.py - EnergyPlus check
skills/hvac-load-calc/scripts/hvacload/eplus.py
Review and deliverables
- Load comparison
skills/hvac-load-calc/scripts/hvacload/results.py - EN/FR report
skills/hvac-load-calc/scripts/hvacload/report.py - 3D viewer
skills/hvac-load-calc/scripts/hvacload/viewer.py
Runtime integrations
- Engine setup
skills/hvac-load-calc/scripts/hvacload/tools.py
Other components
- Professional
- Claude Code user
- OpenStudio / EnergyPlus
- Weather and NBC data
Connections 27
- Professional → Claude Code user: provides plans
README.md - Claude Code user → HVAC load skill: runs workflow
README.md - HVAC load skill → Command tools: invokes tools
README.md - Command tools → Project pipeline: dispatches commands
skills/hvac-load-calc/scripts/hvacload.py - Project pipeline → PDF plan tools: uses plan tools
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → Building model: loads model
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → Typed surfaces: builds surfaces
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → Geometry QA: checks model
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → Design conditions: prepares loads
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → Manual J engine: runs primary method
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → EnergyPlus check: runs cross-check
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → Load comparison: combines results
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → EN/FR report: builds report
skills/hvac-load-calc/scripts/hvacload/pipeline.py - Project pipeline → 3D viewer: creates viewer
skills/hvac-load-calc/scripts/hvacload/pipeline.py - PDF plan tools → Building model: informs takeoff
README.md - Professional → Geometry QA: confirms geometry
README.md - Typed surfaces → Manual J engine: writes surfaces
skills/hvac-load-calc/scripts/hvacload/hpxml.py - Typed surfaces → EnergyPlus check: models surfaces
skills/hvac-load-calc/scripts/hvacload/eplus.py - Typed surfaces → 3D viewer: renders same surfaces
README.md - Typed surfaces → Load comparison: supplies takeoff basis
README.md - Design conditions → Weather and codes: uses weather data
skills/hvac-load-calc/scripts/hvacload/design.py - Design conditions → NBC conditions: uses code values
README.md - Building model → Assembly properties: defines assemblies
README.md - Engine setup → OpenStudio / EnergyPlus: downloads engines
skills/hvac-load-calc/scripts/hvacload/tools.py - Weather and codes → Weather and NBC data: fetches data
README.md - Load comparison → EN/FR report: feeds comparison
skills/hvac-load-calc/scripts/hvacload/report.py - Load comparison → Professional: delivers outputs
README.md