# customer-health-analyst

customer-health-analyst guides customer health scoring, churn prediction models, and product retention analytics.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 159 installs · ★ 54 repo stars
- Author: ncklrs
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ncklrs/startup-os-skills/tree/HEAD/skills/customer-health-analyst/SKILL.md
- Updated: 2026-02-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/customer-health-analyst

## What it does

This skill equips your coding agent with frameworks for scoring customer accounts and forecasting cancellations. It centers on a 0 to 100 overall score distributed across product activity, account growth signals, team engagement, support ticket history, and billing terms.

The methodology relies on structured rules grouped in `rules/` under prefixes like `health-*`, `churn-*`, and `cohort-*`. It emphasizes leading indicators that emerge 60 to 90 days before churn happens, rather than reacting to lost revenue after the contract ends.

You need access to telemetry from your product, helpdesk, or CRM. Without baseline metrics like DAU/MAU shifts or ticket escalation logs, the scoring logic cannot generate grounded alerts.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/customer-health-analyst/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/customer-health-analyst/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/customer-health-analyst/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/customer-health-analyst/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ncklrs/startup-os-skills skills/customer-health-analyst
```

2. **Manually: put the files in place**
- File: `.github/skills/customer-health-analyst/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ncklrs/startup-os-skills --path skills/customer-health-analyst
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/customer-health-analyst/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ncklrs/startup-os-skills/tree/HEAD/skills/customer-health-analyst/SKILL.md

## When to use it
- structure a 0 to 100 customer health index with weighted categories
- flag churn warning signs 60 to 90 days before renewal dates
- define KPI formulas for executive retention reporting including NRR and GRR
- set intervention triggers for accounts experiencing usage drops over 30%

## Example prompts
- Design a customer health scoring model for our SaaS product with weights on active usage
- Outline an escalation workflow for accounts where DAU dropped more than 30%
- Draft an executive retention dashboard layout tracking cohort retention and NRR

## Similar
- [customer-success-manager](https://affpapa.org/en/nevibecode/skills/customer-success-manager.md) — skill · 719 installs
- [customer-health-score](https://affpapa.org/en/nevibecode/skills/customer-health-score.md) — skill · 26800 installs
- [chief-customer-officer-advisor](https://affpapa.org/en/nevibecode/skills/chief-customer-officer-advisor.md) — skill · 397 installs
- [customer-success-and-retention](https://affpapa.org/en/nevibecode/skills/customer-success-and-retention.md) — skill · 239 installs
- [customer-churn-signals](https://affpapa.org/en/nevibecode/skills/customer-churn-signals.md) — skill · 26700 installs
- [customer-success](https://affpapa.org/en/nevibecode/skills/customer-success.md) — skill · 4900 installs

From the same set: [ncklrs/startup-os-skills](https://affpapa.org/en/nevibecode/by/ncklrs/startup-os-skills.md) — 51 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
