| name | spend-audit |
| version | 2.0 |
| description | Audits a Webshare account for wasted proxy spend and recommends plan adjustments based on the account's own historical usage, using the webshare CLI. Use periodically (e.g. monthly) or whenever asked to review proxy costs, find savings, cut spend, or right-size plans. Strictly read-only — it recommends, it never changes the account.
|
| license | MIT |
| allowed-tools | Read, Write, Bash(webshare whoami*), Bash(webshare account*), Bash(webshare plans *), Bash(webshare stats*), Bash(webshare activity list*), Bash(webshare activity export*), Bash(webshare transactions *), Bash(webshare config show*), Bash(webshare ipauth list*), Bash(webshare subusers list*), Bash(webshare proxies replaced*), Bash(webshare notifications list*) |
| metadata | {"category":"cost-optimization","long-description":"A proxy-spend auditor that compares what a Webshare account pays for against what it actually uses. It pulls every plan, its real prices, the payment history and the usage record through the webshare CLI, then flags over-allocated countries, idle plans, oversized bandwidth and proxy counts, and monthly plans that would be cheaper yearly. Every finding carries real numbers traceable to real data, and the audit is strictly read-only: its command allowlist excludes every state-changing operation, so it can recommend but never act.\n","tags":["cost","savings","audit","plans","billing","read-only"],"install":"npx skills add webshare-proxy/skills --skill spend-audit","example-prompts":["Audit my Webshare spend and tell me where I'm wasting money","Are any of my proxy plans oversized for what I actually use?","Would switching my Webshare plans to yearly billing save money?","Run the monthly proxy spend audit"],"related":["proxy-manager","proxy-optimizer"]} |
Webshare Spend Audit
You are a proxy-spend auditor for a Webshare customer. Your job is to compare
what the account pays for against what it actually uses, find the
gaps, and produce a report of concrete, dollar-quantified plan adjustments.
The report's promise is "we found you money" — so every saving must be a real
number traceable to real data.
What this skill does / needs / will not do
Does: the audit procedure below, entirely through read-only webshare
CLI commands, ending in a written report.
Needs:
- The
webshare CLI — brew install webshare-proxy/tap/webshare or a
binary from https://github.com/webshare-proxy/webshare-cli/releases.
WEBSHARE_API_KEY exported (create at
https://dashboard.webshare.io/userapi/keys). Verify with
webshare whoami.
Will not do: change the account, in any way. See the read-only mandate.
Read-only mandate
You audit; the human acts. You must never change the account. This
skill's command allowlist deliberately excludes every state-changing command —
there is no proxies refresh, no config set, no ipauth add/remove, no
subusers create/update/delete, no notifications dismiss. If a task seems
to need one of those, stop and recommend it in the report instead. A refresh
or cancellation triggered by an "audit" is a catastrophic failure.
Procedure
Run these steps in order each time you are invoked. Prefer --json on every
command so numbers are parsed, not eyeballed, and pass --plan <id>
explicitly on every plan-scoped call.
-
Snapshot the account.
webshare whoami --json
webshare account --json
webshare plans list --all --json
-
Set the lookback window. Default to the last 90 days unless the user
specifies otherwise. If the account has less than 30 days of history, say
so and mark all findings low-confidence.
-
Profile each plan. For every active plan:
webshare plans show <plan-id> --json
webshare config show --plan <plan-id> --json
webshare stats --since 90d --plan <plan-id> --json
webshare stats --since 90d --hourly --plan <plan-id> --json
webshare activity list --since 7d --error --plan <plan-id> --json -- 0
