customer-health-analyst — Claude Code skill: overview & setup
customer-health-analyst guides customer health scoring, churn prediction models, and product retention analytics.
no license 159 installs ★ 54 updated 2026-02-26
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a claude-codeWhat customer-health-analyst 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.
What it helps with
- 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 for the agent
- 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
How to install customer-health-analyst
1Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a claude-code2Manually: put the files in place
~/.claude/skills/customer-health-analyst/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/customer-health-analyst/
1Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a codex2Manually: put the files in place
.agents/skills/customer-health-analyst/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a cursor2Manually: put the files in place
.cursor/skills/customer-health-analyst/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ncklrs/startup-os-skills skills/customer-health-analyst2Manually: put the files in place
.github/skills/customer-health-analyst/SKILL.md1Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a gemini-cli2Platform CLI
gemini skills install https://github.com/ncklrs/startup-os-skills --path skills/customer-health-analystManually: put the files in place
.devin/skills/customer-health-analyst/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about customer-health-analyst
How do I install customer-health-analyst in Claude Code?
Run npx skills add ncklrs/startup-os-skills --skill customer-health-analyst -a claude-code in your terminal. You can also place the configuration directly into ~/.claude/skills/customer-health-analyst/SKILL.md.
What does customer-health-analyst do?
It provides guidelines for scoring customer health, spotting account risks early, and running retention analytics.
Which signals does the health score include?
The scoring framework evaluates product adoption, user engagement, contract growth trends, support ticket patterns, and payment track records.