How do I install the Energy Star skill?

Run npx skillmds@latest add soapboxbuild/energy-star in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Energy Star safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Energy Star?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Energy Star free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Energy Star?

soapboxbuild (@soapboxbuild) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Energy Star by soapboxbuild — Agent Skill

Name: Energy Star
Author: soapboxbuild

Energy Star

Retrieve ENERGY STAR scores, energy use intensity (EUI), and carbon emissions for buildings via EPA Portfolio Manager. Connect properties by sharing them with api@soapbox.build in Portfolio Manager. Use when asked about ENERGY STAR score, EUI benchmarks, benchmarking compliance, carbon emissions per square foot, or Portfolio Manager.

soapboxbuild 6272ab8 2.4 KB Updated Sep 17, 2026

File contents

ENERGY STAR Portfolio Manager

Connection Setup (one-time per property)

Log into portfoliomanager.energystar.gov
Open your property → Share → Search "api@soapbox.build" → Share as Read Only
Call list_shared_properties to confirm it appears

Available Tools

All read tools are backed by the official ESPM REST API (authoritative). Earlier UI-scrape versions silently returned empty results, causing false "no data" conclusions — always trust the REST results.

list_properties — All properties in the account (propertyId, name, address)
get_property — Property details, floor area, primary function
get_metrics / get_score_details — Score (1-100), site/source EUI (kBtu/ft²), energy use, GHG (tCO2e). Auto-finds the latest 12-month period with data.
list_meters / list_meters_rest — All meters (meterId, name, type, units, inUse)
get_meter_consumption(propertyId, meterId?, startDate?, endDate?) — Monthly consumption. With meterId: flat [{startDate, endDate, usage, units, cost, estimated}] newest-first. Without: per-meter breakdown with Audette-ready usage_kWh/usage_therms.
submit_meter_data, add_meter, create_property, update_property, share_property — Write operations

Consumption / Audette Calibration

Prefer the "Aggregate Electric Meter" and "Aggregate Gas Meter" for whole-property totals. Do NOT also sum the individual sub-meters (e.g. ELtn97xxxx) — that double-counts.
Electricity native unit is usually kWh (usage_kWh == usage); gas is usually therms.
Empty REST results are truthful: a meter with no records means no bills were shared/entered — but aggregate meters usually carry full history.

ENERGY STAR Score Interpretation

75+ = eligible for ENERGY STAR certification
50 = national median
<25 = significant improvement opportunity
Score compares to similar buildings nationally (same type, climate, size)
scoreEligible: false / energyStarScore: null means no scored period was found in the window — report EUI instead

---name: energy-stardescription: Retrieve ENERGY STAR scores, energy use intensity (EUI), and carbon emissions for buildings via EPA Portfolio Manager. Connect properties by sharing them with api@soapbox.build in Portfolio Manager. Use when asked about ENERGY STAR score, EUI benchmarks, benchmarking compliance, carbon emissions per square foot, or Portfolio Manager.---# ENERGY STAR Portfolio Manager## Connection Setup (one-time per property)1. Log into portfoliomanager.energystar.gov2. Open your property → Share → Search "api@soapbox.build" → Share as Read Only3. Call `list_shared_properties` to confirm it appears## Available ToolsAll read tools are backed by the **official ESPM REST API** (authoritative). Earlier UI-scrape versions silently returned empty results, causing false "no data" conclusions — always trust the REST results.- `list_properties` — All properties in the account (propertyId, name, address)- `get_property` — Property details, floor area, primary function- `get_metrics` / `get_score_details` — Score (1-100), site/source EUI (kBtu/ft²), energy use, GHG (tCO2e). Auto-finds the latest 12-month period with data.- `list_meters` / `list_meters_rest` — All meters (meterId, name, type, units, inUse)- `get_meter_consumption(propertyId, meterId?, startDate?, endDate?)` — Monthly consumption. With `meterId`: flat `[{startDate, endDate, usage, units, cost, estimated}]` newest-first. Without: per-meter breakdown with Audette-ready `usage_kWh`/`usage_therms`.- `submit_meter_data`, `add_meter`, `create_property`, `update_property`, `share_property` — Write operations## Consumption / Audette Calibration- Prefer the **"Aggregate Electric Meter"** and **"Aggregate Gas Meter"** for whole-property totals. Do NOT also sum the individual sub-meters (e.g. `ELtn97xxxx`) — that double-counts.- Electricity native unit is usually kWh (`usage_kWh == usage`); gas is usually therms.- Empty REST results are truthful: a meter with no records means no bills were shared/entered — but aggregate meters usually carry full history.## ENERGY STAR Score Interpretation- 75+ = eligible for ENERGY STAR certification- 50 = national median- <25 = significant improvement opportunity- Score compares to similar buildings nationally (same type, climate, size)- `scoreEligible: false` / `energyStarScore: null` means no scored period was found in the window — report EUI instead

Frequently asked questions