Powerswitch Analyser
v1.0.2low riskdraft onlyAnalyses your NZ power bill and tells you if a different retailer would be cheaper. Uses Consumer NZ's Powerswitch logic locally.
Install
Install in Claude — recommended
Claude Desktop · Claude.ai · Claude CodeLocalskills is an Anthropic-spec plugin marketplace (github.com/localskills-ai/skills). Add it once, install any skill with one command — no zip wrangling, no self-attested permissions, no fetch-and-grant.
/plugin marketplace add localskills-ai/skills
/plugin install powerswitch-analyser@localskillsThen describe your task — Claude picks the skill from context.
Or — use without installing (MCP)
full setup →Prefer not to install? Connect the Localskills MCP server once and any agent can call this skill on the fly through a sandboxed, schema-bound channel.
1. Add the server (one time):
{
"mcpServers": {
"localskills": {
"type": "http",
"url": "https://localskills.ai/api/mcp"
}
}
}2. Then ask your agent:
Using the Localskills MCP (get_skill), fetch the "powerswitch-analyser" skill (nz/powerswitch-analyser) and apply it to my task.No MCP? Paste this to a permissive agent (Claude Code, dev CLI). It fetches the skill and sets it up directly. Hosted agents like Claude.ai will often (correctly) refuse this shape — use MCP above instead.
Install and set up the Localskills skill "powerswitch-analyser"
(nz/powerswitch-analyser).
Before installing anything, fetch and review it:
- https://localskills.ai/nz/powerswitch-analyser
- https://localskills.ai/api/install/claude-code/nz/powerswitch-analyser
Read its SKILL.md and the permissions declared in skill.json
(filesystem, network, shell). Don't grant more than it declares;
if anything looks off, stop and tell me.
Then install it for the agent you're running and confirm it's
available. Keep the work scoped to this skill — ask before any
broader environment changes.Or grab the files yourself — pick your agent. The download writes one file (or a folder) to where your agent looks for skills. Nothing runs on your machine until you invoke the skill from inside the agent.
Claude Codedownloador terminal ▾
curl -fsSL https://localskills.ai/api/install/claude-code/nz/powerswitch-analyser -o /tmp/powerswitch-analyser.zip && unzip -o /tmp/powerswitch-analyser.zip -d ~/.claude/skills/ && rm /tmp/powerswitch-analyser.zipMin Claude Code: >=1.0.0 · Writes to ~/.claude/skills/<slug>/
Cursordownloador terminal ▾
mkdir -p .cursor/rules && curl -fsSL https://localskills.ai/api/install/cursor/nz/powerswitch-analyser -o .cursor/rules/powerswitch-analyser.mdcMin Cursor: >=0.40.0 · Writes to .cursor/rules/<slug>.mdc
Codex CLIdownloador terminal ▾
curl -fsSL https://localskills.ai/api/install/codex/nz/powerswitch-analyser -o /tmp/powerswitch-analyser.zip && unzip -o /tmp/powerswitch-analyser.zip -d ./ && rm /tmp/powerswitch-analyser.zipMin Codex CLI: >=1.0.0 · Writes to .codex/skills/<slug>/
Want to read it before saving? Pipe the download to lessinstead of -o:curl -fsSL https://localskills.ai/api/install/cursor/nz/powerswitch-analyser | less
README
Powerswitch Analyser
Reads your NZ power bill, works out your usage profile, and tells you which retailers would likely be cheaper — using the same logic Powerswitch (Consumer NZ's free comparison tool) uses, but offline against your actual bill.
What it does
NZ has ~20+ active electricity retailers and lines are bundled into your retailer bill in opaque ways. Powerswitch is great but you have to:
- Type your usage in by hand from your bill.
- Pick fuel types and meter types from drop-downs you might not understand.
- Re-check periodically as plans change.
This skill skips the typing. Hand it your power bill (PDF, screenshot, or pasted text); it parses your daily fixed charge, kWh usage by tariff (anytime / day / night / controlled), the lines company implied by your address, and a couple of plan flags (low-user vs standard, prompt-payment discount).
Then it compares to a snapshot of retailer pricing and produces a ranked list of "you'd save / break even / pay more" vs each retailer.
Important caveats
- The plan snapshot is as of the date in the file. NZ power plans change quarterly-ish. Always verify on Powerswitch.org.nz before switching — the skill says this loudly in every output.
- The skill works for standard residential connections. Solar, battery, EV, commercial accounts, three-phase, controlled hot-water dual-meter setups → flagged for human attention.
- Lines charges vary by your specific lines company (Vector, Wellington Electricity, Orion, Aurora, Powerco, Counties, etc.). The skill identifies the lines company from your address or bill but doesn't compute lines costs in isolation — they're baked into the retailer plans we compare.
When to use it
- Your bill came in higher than usual and you want a sanity check.
- You haven't switched in 2+ years (NZ retailers tend to drift up after the welcome discount expires).
- You moved house and need to pick a retailer fresh.
- You're considering moving from low-user to standard tariff (or vice versa).
When NOT to use it
- For commercial accounts. Out of scope.
- For solar/battery analysis. Out of scope (see Powerswitch's solar buy-back rates page).
- For predicting your future bills if usage changes significantly.
- For deciding between gas + electric vs all-electric whole-home. Different question.
Inputs
- Your most recent power bill (PDF / screenshot / pasted text) — the skill needs roughly 30 days of usage data minimum, 12 months ideal.
- Your address (so the skill knows your lines company). The skill stores only the suburb + region in its working file — not the full street address.
- Optional: your current retailer + plan name, your "low user" / "standard" status.
Outputs
Your profile
------------
Region: Wellington
Lines company: Wellington Electricity
Tariff: Standard (anytime)
Daily fixed charge: $1.85/day
Average usage: 13.2 kWh/day
Annualised total (extrapolated from 11 months): ~$2,840/yr inc GST
Comparison vs your current plan
-------------------------------
Plan Annualised vs you Friction
Electric Kiwi MoveMaster $2,510 −$330 No exit fee, switch in app
Flick Off-peak Saver $2,580 −$260 Variable rates; requires smart meter
Genesis Standard (current) $2,840 — (your current — no switch needed)
Mercury GoodNights $2,830 −$10 —
Contact Basic $2,930 +$90 —
Top recommendation
------------------
Electric Kiwi MoveMaster looks ~$330/yr cheaper for your usage. Verify
on Powerswitch.org.nz with this exact bill, then switch via the
Electric Kiwi website (~5 min, no exit fee from current retailer).
Watch out for:
- Welcome credits expire after 12 months; build a reminder to re-run
this skill next year.
- If you have a hot-water cylinder on a "controlled" circuit, your
real savings could differ. This skill assumes anytime tariff only.
Permissions
fileSystem.read:downloads— to read PDF bills.fileSystem.read:documents— alt location.fileSystem.write:outputs— to save the profile + recommendation.- No network. The skill doesn't contact Powerswitch, retailers, or anywhere else.
- No shell.
Plan snapshot
The skill ships with a static plans.json (in assets/) — a curated snapshot of major-retailer residential pricing. It is not authoritative and goes stale fast. Always verify before switching.
Author
Paul Grey (@paulgrey). NZ power-bill comparison should not require a spreadsheet.
Skill instructions (SKILL.md)
View the prompt the agent receives
Powerswitch Analyser — SKILL
You analyse a NZ power bill and tell the user whether they'd save by switching retailer. You never switch on the user's behalf. You always advise the user to verify on Powerswitch.org.nz before they switch.
Operating rules
- You never contact retailers, lines companies, Powerswitch, or any external service.
- You handle standard residential connections only. If the bill shows EV, solar export, three-phase, dual-tariff (anytime + controlled), or a commercial GST number, flag and stop: this is more than the skill can responsibly analyse.
- Always include in the output: "Verify on Powerswitch.org.nz before switching. Plans change frequently and this skill works from a static snapshot."
- Privacy: store only suburb + region from the user's address, never the street address. The bill itself can be processed but the retained profile must redact.
- Use GST-inclusive numbers throughout — that's what residential consumers see.
Information to extract from the bill
- Retailer and plan name (top of bill).
- Pricing plan type: Low User vs Standard (Low User has a much lower daily fixed charge but higher per-kWh).
- Tariff structure: anytime only, peak/off-peak, day/night, controlled.
- Daily fixed charge ($/day inc GST).
- Per-kWh charge by tariff (c/kWh inc GST).
- Usage history — 11–12 months ideal, minimum 30 days. From the bill's history table or pasted previous-bill data.
- Prompt-payment discount if applied.
- Address → use to identify lines company. NZ has ~29 lines companies; rough mapping:
- Auckland (Wellsford to Papakura) → Vector
- South Auckland (Pukekohe, Waiuku, Franklin) → Counties Energy
- Hamilton + most of Waikato District → WEL Networks
- Eastern Waikato, Tauranga, Taranaki, much of Manawatū-Whanganui, Wairarapa → Powerco
- Wellington City, Porirua, Hutt Valley → Wellington Electricity
- Christchurch → Orion
- Dunedin, Central Otago, Wānaka, Queenstown → Aurora
- Other regions → ask the user. Full directory at https://www.ena.org.nz/your-lines-company/lines-company-map
If you can't extract one of the above with confidence, ask for it.
Comparison method
The skill ships with a static plans.json containing retailer plan structures: daily fixed charge + per-kWh by tariff, low-user vs standard variants, exit fees, and any non-pricing notes ("smart meter required", "variable wholesale rate", "welcome credit expires after N months").
For each comparison plan:
- Daily fixed cost = daily charge × 365.
- Usage cost = sum over tariffs of (kWh per year × c/kWh / 100).
- Total = fixed + usage, less any prompt-payment / welcome discount, plus exit fee if applicable.
- Compare to the user's current plan's same calculation.
Round to the nearest $10. Don't pretend to precision the snapshot doesn't have.
Output format
Your profile
------------
Region: <REGION>
Lines company: <LINES CO>
Tariff: <Standard | Low User> (<anytime | peak/off-peak | day/night>)
Daily fixed charge: $<X>/day
Average usage: <X> kWh/day
Annualised total (extrapolated from <N> months): ~$<X>/yr inc GST
Comparison vs your current plan
-------------------------------
Plan Annualised vs you Friction
<plan> $<X> −$<X> <note>
...
Top recommendation
------------------
<plan> looks ~$<X>/yr cheaper for your usage. Verify on
Powerswitch.org.nz with this exact bill, then switch via the
<retailer>'s site (~5 min).
Watch out for:
- <retailer-specific gotcha>
- ...
VERIFY before switching: https://www.powerswitch.org.nz/
Refusals
- "Switch me to <retailer> now." Refuse — the skill is advisory.
- "Predict my bill next quarter." Refuse — you don't know future usage.
- "Compare for my commercial account." Refuse and explain.
- "Should I get solar?" Out of scope. Refer to the Powerswitch solar buy-back rates.
- "Optimise my hot-water cylinder timing." Out of scope — this is about retailer choice, not load management.
Low-user vs standard rule of thumb
(For reference, not a hard recommendation.)
- Low-user plans are intended for ≤ 8,000 kWh/year in the North Island and Upper South Island.
- For Lower South Island (areas south of and including Christchurch, excluding the West Coast), the threshold is 9,000 kWh/year.
- If usage is below the threshold and the user is on Standard, suggest Low User.
- If usage is above and they're on Low User, suggest Standard.
- The breakeven sits at the regulated thresholds; show both calculations rather than guess.
The Electricity (Low Fixed Charge Tariff Option for Domestic Consumers) Regulations 2004 — the rules that require retailers to offer a Low User option with a capped daily fixed charge — are being phased out. The cap has been increasing by 30c/day each April since 2022 (currently $1.80/day for 2026–27). The regulations are removed entirely on 1 April 2027. After that, "low user" plans become a voluntary retailer offering, not a regulated one. Flag if the user's region is already in transition.
Plan snapshot freshness
In every output, include the date of the plan snapshot (e.g. Snapshot date: 2026-04-15). Tell the user if it's been more than 90 days — recommend they refresh from Powerswitch before relying on the comparison.
Tone
Practical, neutral. NZ-direct. The skill helps the user decide — it doesn't sell them a retailer.
Self-check
- Have I included the "verify on Powerswitch" line?
- Have I refused if the bill is non-residential?
- Have I noted the snapshot date?
- Are my numbers GST-inclusive?
- Have I redacted street address from the saved profile?
If any answer is "no", fix it.
Changelog
Changelog
[1.0.2] — 2026-05-25
Fixed
- Corrected the Powerswitch solar URL.
powerswitch.org.nz/solarreturns a 404 — the live page ispowerswitch.org.nz/solar-rates(Powerswitch's "Solar buy-back rates" page). Updated the refusal in SKILL.md and the solar-export example, and reworded "solar calculator" to "solar buy-back rates" since Powerswitch publishes a buy-back rates comparison, not a calculator. - ENA lines-company directory link made a full https URL —
https://www.ena.org.nz/your-lines-company/lines-company-map.
Changed
- README output example corrected for internal consistency. The "Genesis Standard (current)" row now reads $2,840 with no delta (matching the profile's ~$2,840/yr current total) instead of the inconsistent $2,790 / −$50. Fixed a stray GBP symbol (
+£10→−$10) on the Mercury row so all figures read in NZD and match the arithmetic.
[1.0.1] — 2026-05-21
Fixed
- Lines-company mapping expanded and corrected. Auckland is split (Vector vs Counties Energy in the south). WEL Networks (not Powerco) is Hamilton + most of Waikato District. Powerco covers eastern Waikato, Tauranga, Taranaki, much of Manawatū-Whanganui, Wairarapa. Added pointer to the ENA full directory.
- LFC regulation phase-out detail. Quoted the actual regulations (Electricity (Low Fixed Charge Tariff Option for Domestic Consumers) Regulations 2004), the schedule (cap up 30c/day each April from 2022, $1.80/day for 2026–27, removed entirely 1 April 2027), and the implication (low-user becomes voluntary, not regulated).
- Low-user thresholds spelled out by region. North Island + Upper South Island = 8,000 kWh/year; Lower South Island = 9,000 kWh/year.
[1.0.0] — 2026-05-20
Added
- Initial release.
- Parses NZ power bills (PDF, pasted text) — extracts retailer, plan, tariff, daily fixed charge, kWh usage, lines company.
- Compares against static snapshot of major-retailer residential plans.
- Outputs ranked annualised-cost comparison with switch-friction notes.
- Always advises verifying on Powerswitch.org.nz before switching.
- Refuses commercial accounts, solar / EV / three-phase / dual-tariff setups.
- Zero network permissions.