Made by@usagemetricsCustomer health score
@usagemetrics/customer-health-score
Score customer health from usage, support, and billing signals with weights you can read and edit. Bands every account green, yellow, or red, names the top drivers, tracks change since the last score, and flags at-risk accounts renewing soon. Works from one CSV.
- Activity
- New: be the first to try it
- Installs
- 0 installs
- Likes
- 0 likes
- Clones
- 0 clones
- 1# Customer health score
- 3Combines usage, support, and billing signals into one health score per account, using a weights file your team can read and change. Every account gets a band, its top drivers, its change since last time, and a flag if it is at risk and renewing soon.
- 5**Who it is for:** customer success leads and founders who want a weekly at-risk list without buying a CS platform.
- 7## Example
- 9Input: `examples/accounts.csv` (11 accounts, 8 signals) and `examples/weights.json`.
- 11Output (`out/health.md`):
- 13| Band | Accounts | ARR |
- 14| --- | --- | --- |
- 15| green | 5 | $273,600 |
- 16| yellow | 3 | $138,000 |
- 17| red | 2 | $50,400 |
- 19```
- 20| **Bluebird Labs** | 25 red | -39 | $42,000 | 44 d | Usage trend (-0.68), Seat use (0.35), Core feature users (1) |
- 21```
- 23Plus `out/health.csv` with every account, band, sub-scores by group, and drivers.
- 25## What it can access
- 27- Runs `node scripts/health.mjs` (Node built-ins only).
- 28- Reads `data/`. Writes `data/health-weights.json` (your weights) and `out/health*`.
- 29- No network, no CRM or help desk logins. You bring the exports.
- 31## Setup
- 33None. Put one row per account in `data/accounts.csv` and ask Claude for a health score. It starts from the example weights and tunes them with you.