What makes utility-bill-analyzer notable?

1.6K downloads. Trust evidence available

How should utility-bill-analyzer be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

utility-bill-analyzer

Analyze electricity, water, and gas bills to detect anomalies, compare usage, forecast costs, and suggest savings. Skill: utility-bill-analyzer Owner: voronindenis5 Summary: Analyze electricity, water, and gas bills to detect anomalies, compare usage, forecast costs, and suggest savings. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-14T06:18:31.804Z | auto Initial release of Utility Bill Analyzer. - Analyze electricity, water, and gas bills for anomalies, trends, and seasonal patterns. - Compare usage and costs year-over-y

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.6k

Updated

Oct 10, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.6K downloadsadoption · observed Oct 10, 2026
Latest release: 0.1.0release · observed Aug 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17b6amkd3wzqgg640v03a9r1n83gxs1:utility-bill-analyzer

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-voronindenis5-utility-bill-analyzer/snapshot"

Documentation

CLAWHUB

25,400 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: utility-bill-analyzer
version: 1.0.0
author: Denis Voronin
license: MIT
description: Analyze electricity, water, and gas bills to detect anomalies, compare usage, forecast costs, and suggest savings.
category: productivity
---

# Utility Bill Analyzer

Track and analyze monthly utility bills (electricity, water, gas) to detect anomalies, compare year-over-year usage, forecast costs, and get actionable savings suggestions.

## Quick Start

```bash
# Record a bill
python3 scripts/bill_analyzer.py add --type electricity --date 2025-01-15 --usage 450 --cost 67.50

# View history with ASCII bar chart
python3 scripts/bill_analyzer.py history

# Compare same month across years
python3 scripts/bill_analyzer.py compare --month 01

# Detect usage spikes (>1.5× rolling average)
python3 scripts/bill_analyzer.py anomaly

# Forecast next bill based on seasonal patterns
python3 scripts/bill_analyzer.py forecast

# Full annual report with savings suggestions
python3 scripts/bill_analyzer.py report
```

All commands accept an optional `--type electricity|water|gas` filter (except `add`, which requires it) and `--db <path>` to specify a custom database file.

## Commands

| Command | Description |
|---------|-------------|
| `add` | Record a new bill (type, date, usage, cost) |
| `history` | Show usage/cost trend with ASCII bar chart |
| `compare` | Compare same month across different years |
| `anomaly` | Detect bills where usage exceeds 1.5× the rolling average |
| `forecast` | Predict next bill based on seasonal averages and recent trend |
| `report` | Annual summary with seasonal breakdown, year-over-year comparison, and savings suggestions |

## Data Storage

Bills are stored in `scripts/bills.json` (configurable with `--db`). Each record:

```json
{
  "type": "electricity",
  "date": "2025-01-15",
  "month": 1,
  "year": 2025,
  "usage": 450,
  "cost": 67.50,
  "cpu": 0.15,
  "season": "winter"
}
```

## Features

- **Anomaly Detection**: Flags bills where usage exceeds 1.5× the 3-bill rolling average, with season-aware explanations (winter heating, summer AC).
- **Seasonal Patterns**: Recognizes winter/spring/summer/autumn usage patterns and reports seasonal averages.
- **Cost per Unit Tracking**: Tracks effective rate ($/kWh, $/m³) over time to distinguish rate increases from usage increases.
- **ASCII Bar Chart**: Visual usage trend directly in the terminal.
- **Forecasting**: Predicts next bill using historical same-month data (preferred) or recent average.
- **Savings Suggestions**: Generates type-specific tips based on detected patterns (high winter usage, rate increases, etc.).

## References

- `references/utility-savings-checklist.md` — 108 actionable savings tips by category
- `references/rate-analysis-guide.md` — How to read utility bills, spot billing errors, compare plans

README.md

# Utility Bill Analyzer

> Detect anomalies, compare usage, forecast costs, and get savings suggestions for electricity, water, and gas bills.

## What It Does

- 📊 **Track** monthly utility bills in a simple JSON database
- ⚠️ **Detect anomalies** — flags bills where usage exceeds 1.5× the rolling average
- 📅 **Compare** same-month usage across years to spot trends
- 🔮 **Forecast** next bill based on seasonal patterns and recent trends
- 📈 **Visualize** usage with ASCII bar charts in the terminal
- 💡 **Suggest savings** based on your usage patterns and 100+ efficiency tips
- 💰 **Track cost per unit** — distinguish rate hikes from usage increases

## Quick Start

```bash
# Add bills
python3 scripts/bill_analyzer.py add --type electricity --date 2025-01-15 --usage 450 --cost 67.50
python3 scripts/bill_analyzer.py add --type gas --date 2025-01-15 --usage 120 --cost 72.00
python3 scripts/bill_analyzer.py add --type water --date 2025-01-15 --usage 8 --cost 25.00

# View history
python3 scripts/bill_analyzer.py history

# Check for anomalies
python3 scripts/bill_analyzer.py anomaly

# Compare January across years
python3 scripts/bill_analyzer.py compare --month 01

# Forecast next bill
python3 scripts/bill_analyzer.py forecast

# Full annual report
python3 scripts/bill_analyzer.py report
```

## Requirements

- Python 3.7+ (stdlib only, no pip dependencies)

## Commands

| Command | Description |
|---------|-------------|
| `add` | Record a bill: `--type`, `--date`, `--usage`, `--cost` |
| `history` | Usage/cost trend with ASCII bar chart |
| `compare --month MM` | Same-month year-over-year comparison |
| `anomaly` | Detect bills >1.5× rolling average |
| `forecast` | Predict next bill from seasonal data |
| `report` | Annual summary + savings suggestions |

All commands (except `add`) accept `--type electricity|water|gas` to filter by utility type.

## Data

Bills are stored in `scripts/bills.json`. Specify a custom path with `--db <path>`.

## License

MIT © Denis Voronin

_meta.json

{
  "ownerId": "kn75wwn4x6djaf28jbykeamazd81gtdp",
  "slug": "utility-bill-analyzer",
  "version": "0.1.0",
  "publishedAt": 1786688311804
}

references/rate-analysis-guide.md

# Rate Analysis Guide — How to Read Utility Bills & Spot Errors

Understanding your utility bill is the first step to reducing it. This guide breaks down the components of electricity, water, and gas bills, and highlights common billing errors.

---

## 📋 Anatomy of an Electricity Bill

### Key Components
| Component | Description |
|-----------|-------------|
| **Meter reading** | Actual or estimated kWh consumed. Look for "A" (actual) vs "E" (estimated). |
| **Supply charge** | Cost of the electricity itself (per kWh). This is the energy you consumed. |
| **Delivery / Distribution charge** | Cost to transport electricity over wires to your home. Often fixed + variable. |
| **Demand charge** | (Commercial mostly) Peak power draw in kW. Residential rarely has this. |
| **Time-of-use (TOU)** | Different rates for peak, off-peak, and shoulder periods. |
| **Fixed daily charge** | A flat daily fee regardless of usage. Typically $0.30-$1.50/day. |
| **Taxes & fees** | Sales tax, public benefits charge, franchise fee, etc. |

### How to Calculate Your Effective Rate
```
Effective $/kWh = Total Bill Amount ÷ Total kWh
```
This is the true cost of each kWh including all charges. Compare this number across plans and providers.

### Reading the Meter
- **Digital meter**: Read the displayed kWh directly.
- **Dial meter**: Read dials left to right; if pointer is between numbers, use the lower number.
- **Smart meter**: Check your utility's app/portal for real-time data.

**Verify accuracy**: Note the meter reading on the bill date. Next month, subtract previous reading from current. The difference should match the billed usage.

---

## 📋 Anatomy of a Gas Bill

### Key Components
| Component | Description |
|-----------|-------------|
| **Meter reading** | Volume consumed, usually in m³ or therms or CCF. |
| **Therm conversion** | 1 therm ≈ 29.3 kWh ≈ 100,000 BTU. Gas is often billed in therms. |
| **Supply charge** | Cost of the gas commodity (per therm/m³). |
| **Delivery charge** | Cost to transport gas through pipelines. |
| **Weather normalization** | Some utilities adjust usage for weather (WNA). |
| **Customer charge** | Fixed monthly fee for connection. |

### Gas Unit Conversions
- 1 m³ of natural gas ≈ 10.55 kWh ≈ 0.360 therms
- 1 therm = 100,000 BTU = 29.3 kWh
- 1 CCF (100 cubic feet) ≈ 1.037 therms

---

## 📋 Anatomy of a Water Bill

### Key Components
| Component | Description |
|-----------|-------------|
| **Meter reading** | Volume consumed, usually in m³, gallons, or CCF. |
| **Tiered rates** | Usage is often priced in tiers — the more you use, the higher the per-unit rate. |
| **Fixed service charge** | Flat monthly/quarterly fee for water connection. |
| **Sewer / Wastewater charge** | Often based on water consumption. |
| **Stormwater fee** | Fixed fee for drainage infrastructure. |
| **Irrigation meter** | Separate meter for outdoor water — may not include sewer charges. |

### Reading a Water Meter
- Most meters read in m³ or gallon

references/utility-savings-checklist.md

# Utility Savings Checklist — 100+ Actionable Tips

A comprehensive checklist organized by category. Each tip includes an estimated savings where available.

---

## ⚡ Electricity

### Lighting (12 tips)
1. Replace incandescent bulbs with LEDs (save 75% energy, last 25× longer)
2. Use natural light whenever possible — open curtains during the day
3. Install motion sensors for outdoor lights
4. Use timers on decorative/landscape lighting
5. Choose lower wattage bulbs in hallways and closets
6. Install dimmer switches to reduce consumption
7. Turn off lights when leaving a room (obvious but easy to forget)
8. Use task lighting (desk lamp) instead of lighting the whole room
9. Keep light fixtures and bulbs clean — dirt reduces output by up to 50%
10. Use solar-powered outdoor pathway lights
11. Paint walls light colors to reduce lighting needs
12. Remove unused bulbs in overlit areas (e.g., multi-bulb fixtures)

### Heating & Cooling (20 tips)
13. Set thermostat to 20-22°C (68-72°F) in winter; each degree above 20°C adds ~10% to heating
14. Set thermostat to 24-26°C (76-78°F) in summer; each degree below 26°C adds ~10% to cooling
15. Install a programmable or smart thermostat (Nest, Ecobee)
16. Lower thermostat by 2-3°C at night or when away
17. Use ceiling fans — they make rooms feel 4°C cooler
18. Reverse ceiling fan direction in winter to push warm air down
19. Clean/replace HVAC filters monthly (clogged filters waste 15%+ energy)
20. Seal gaps around windows and doors with weatherstripping
21. Add insulation to attic — top-up pays for itself in 2-5 years
22. Install thermal/insulated curtains
23. Close curtains/blinds on hot summer days to block solar heat gain
24. Open curtains on winter days to let solar heat in
25. Use draft stoppers under exterior doors
26. Service heating/cooling systems annually
27. Consider a heat pump — 3× more efficient than resistance heating
28. Zone heating/cooling — close vents in unused rooms
29. Install a door sweep on the garage-to-house door
30. Caulk around window frames and baseboards
31. Install storm windows or use window insulation film in winter
32. Shade outdoor AC unit with trees or awning (improves efficiency 10%)

### Appliances & Electronics (18 tips)
33. Unplug "vampire" electronics (TVs, chargers, game consoles) — save 5-10% on electricity
34. Use smart power strips to cut standby power automatically
35. Wash clothes in cold water (90% of washing energy heats the water)
36. Air-dry clothes instead of using the dryer
37. If using dryer: clean lint trap before every load, use sensor dry setting
38. Run dishwasher and washing machine only with full loads
39. Air-dry dishes (turn off heated dry cycle)
40. Choose ENERGY STAR appliances when replacing
41. Use the right-sized burner for pots — small pot on large burner wastes energy
42. Keep refrigerator at 3-4°C (37-40°F), freezer at -18°C (0°F)
43. Clean refrigerator coils twice a year
44. Don't overload the fridge — air needs to circulate
45. Microwave

Github ReposUpdated 15h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.