Manage daily bills, expenses, and recurring payments with tracking, reminders, and analysis. Use when the user asks about bill management, expense tracking,...
16 installs
Coding
utility-bill-analyzer
Try itAnalyze electricity, water, and gas bills to detect anomalies, compare usage, forecast costs, and suggest savings.
What it does
Analyze electricity, water, and gas bills to detect anomalies, compare usage, forecast costs, and suggest savings.
The skill document
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
# 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 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:
{
"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 categoryreferences/rate-analysis-guide.md— How to read utility bills, spot billing errors, compare plans
Related skills
Use when you want to know which appliances actually drive your electric bill, whether a bill spike is explained by your usage, if standby/vampire draw is worth addressing, whether replacing an old fridge/dryer/AC pays back, or when modeling tiered utility rates — builds a ranked cost-per-appliance table from watts, duty cycle, and usage hours, reconciles it against your real bill, and computes replacement payback.
Match Gmail spending patterns to your cards
1 installs
Maxio Advanced Billing (maxio.com). Use this skill for ANY Maxio Advanced Billing request — searching and reading data. Whenever a task involves Maxio Advanced Billing, use this skill instead of calling the API directly.
Extracts structured data from receipt text (OCR/photo description) and generates monthly spending reports. Parses merchant, date, line items, tax, total, and category. Produces summary stats: top merchants, category breakdown, total spend.
Analyze conversation transcripts: decisions, action items, dates, people, executive summary.
4 installs