skills/by-role/customer-success/health-scorecard/SKILL.md
Build a customer health scorecard across usage, engagement, adoption, NPS, support load, and financial risk. Use when user says "health score", "customer health", "build a scorecard", "how healthy is this account", "customer scoring model", "green yellow red", "health dashboard", or "account health framework" - even if they don't say "scorecard" explicitly. Applies to CSMs building account health models or CS leaders standardizing health tracking across the team.
npx skillsauth add qa-aman/claude-skills health-scorecardInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Based on "Customer Success" by Mehta, Steinman & Murphy, a health score is the single most important operational tool in CS. It converts diverse signals - usage, support, sentiment, financial - into one composite view that tells a CSM where to focus time.
The core insight: a health score is only as useful as the action it triggers. A score without a corresponding playbook is a dashboard that collects dust. Build the score and the response together.
Score each dimension 1 (at risk) to 5 (healthy). Weight dimensions based on what predicts churn or expansion in your product. Defaults shown below - adjust weights to your context.
Dimension 1 - Product Usage (default weight: 25%) Measures whether the customer is actually using the product.
| Score | Signal | |-------|--------| | 5 | MAU >85% of licensed seats, logins growing MoM | | 4 | MAU 70-85%, stable | | 3 | MAU 50-70%, flat | | 2 | MAU 30-50% or declining >10% MoM | | 1 | MAU <30% or no logins in 30+ days |
Dimension 2 - Feature Adoption (default weight: 20%) Measures depth of product use, not just login frequency.
| Score | Signal | |-------|--------| | 5 | >75% of core features adopted, exploring advanced features | | 4 | 60-75% core features adopted | | 3 | 40-60% adopted, stuck in basic workflows | | 2 | <40% adopted, avoiding key features | | 1 | Using only 1-2 surface features, product barely embedded |
Dimension 3 - Engagement with CSM/Support (default weight: 15%) Measures relationship health and responsiveness.
| Score | Signal | |-------|--------| | 5 | Regular cadence calls, champion responsive within 24h, exec engaged | | 4 | Monthly calls, reasonable responsiveness | | 3 | Sporadic calls, 2-3 day response lag | | 2 | Skipping calls, slow to respond, champion hard to reach | | 1 | Gone dark - no response in 3+ weeks, declined last meeting |
Dimension 4 - NPS / Sentiment (default weight: 15%) Measures subjective satisfaction and advocacy likelihood.
| Score | Signal | |-------|--------| | 5 | NPS 9-10, reference willing, positive qualitative feedback | | 4 | NPS 7-8, satisfied, no active complaints | | 3 | NPS 6-7, neutral, minor grumbles | | 2 | NPS 4-6, frustrated, expressing dissatisfaction in calls | | 1 | NPS 0-3, actively unhappy, escalations or threats to leave |
Dimension 5 - Support Load (default weight: 15%) Measures whether the product is causing operational pain.
| Score | Signal | |-------|--------| | 5 | <2 tickets/month, all resolved promptly | | 4 | 2-4 tickets/month, normal resolution time | | 3 | 5-7 tickets/month or 1 lingering unresolved issue | | 2 | 8-12 tickets/month or critical open issue >2 weeks | | 1 | >12 tickets/month or multiple unresolved critical issues |
Dimension 6 - Financial Risk (default weight: 10%) Measures exposure at renewal and expansion potential.
| Score | Signal | |-------|--------| | 5 | Renewal >6 months, expansion conversation active, budget secured | | 4 | Renewal 4-6 months, no red flags | | 3 | Renewal 2-4 months, no expansion discussion started | | 2 | Renewal <2 months, budget uncertainty, no expansion | | 1 | Renewal <2 months, active budget scrutiny or downsell risk |
Weighted score = sum of (dimension score x dimension weight) Maximum possible score = 5.0
Example calculation:
Score ranges:
A single dimension scoring 1 can override a composite Green. Apply Red Flag Rule:
If any single dimension scores 1, the account is automatically Yellow regardless of composite. If two or more dimensions score 1, the account is automatically Red.
This prevents a high-usage account with a gone-dark champion from being masked by a good composite.
Produce a scorecard entry for each account:
[Customer name] - Health Score Scoring date: [date] CSM: [name]
| Dimension | Weight | Score (1-5) | Weighted | Notes | |-----------|--------|-------------|----------|-------| | Product Usage | 25% | | | | | Feature Adoption | 20% | | | | | Engagement | 15% | | | | | NPS / Sentiment | 15% | | | | | Support Load | 15% | | | | | Financial Risk | 10% | | | | | Composite | | | | |
Status: Green / Yellow / Red Red Flag Rule applied: Yes / No
Top risk signal: [the dimension with the lowest score and why it matters] Recommended next action: [1 specific intervention with a date]
Health scores must be refreshed regularly. Stale scores are worse than no scores because they create false confidence.
1. Composite score only, no dimension breakdown Bad: "Health score is 3.2." CSM doesn't know where to intervene. Good: Show composite plus all six dimensions. The breakdown tells the CSM where to act.
2. Static score never updated Bad: Setting a health score at onboarding and never refreshing it. Good: Mandatory refresh cadence. Green = monthly, Yellow = bi-weekly, Red = weekly.
3. No action linked to the score Bad: Health dashboard exists but no playbook triggers based on tier. Good: Every tier (Green, Yellow, Red) maps to a specific cadence and intervention type.
4. Ignoring single-dimension red flags Bad: Account with 85% MAU rated Green even though champion went dark 6 weeks ago. Good: Apply Red Flag Rule. A gone-dark champion is a churn signal regardless of usage.
5. Using only quantitative signals Bad: Scoring only usage and support tickets because they're easy to measure. Good: Include sentiment and engagement even if they require CSM judgment to score. Hard-to-measure signals are often the earliest churn indicators.
development
Plan a webinar end-to-end using April Dunford's Obviously Awesome positioning framework to find the topic angle that makes the webinar obviously valuable to the right audience. Produces topic positioning, abstract, speaker brief, registration page, promotion sequence, day-of run-of-show, and post-webinar follow-up. Use when the user asks to plan a webinar, virtual event, online workshop, "we need a webinar on X", host a webinar, online masterclass, or any live virtual event with promotion and follow-up. Reads ICP, services, and brand voice from knowledge/.
development
Write long-form thought leadership articles, opinion pieces, industry POV essays, and CEO/founder bylines using the Made to Stick SUCCESs framework (Chip and Dan Heath). Use when the user asks for a long-form article, executive byline, opinion piece, industry POV, manifesto, "explain our point of view on X", or wants to publish an authority-building piece (1200-2500 words). Reads brand voice and positioning from knowledge/.
development
Plan a monthly content calendar across channels using the Content Marketing Matrix (Dave Chaffey, Smart Insights) - Entertain/Inspire/Educate/Convince. Every post gets a quadrant label. The monthly calendar must hit 40% Educate, 40% Inspire+Convince, 20% Entertain. Produces a week-by-week posting schedule with topics, formats, channels, and asset links. Use when the user says "content calendar", "social calendar", "plan next month's content", "what should we post", "content plan", "editorial calendar", "schedule posts for the month", or wants a structured posting plan for LinkedIn, Twitter, email, or blog. Reads brand voice, ICP, and past learnings from knowledge/.
development
Write SEO-optimized long-form articles targeting specific keywords using the They Ask You Answer Big 5 framework (Marcus Sheridan). Articles are categorized by Big 5 type (Cost, Problems, Versus, Best/Reviews, How-To) and structured accordingly. The "answer first" rule applies to every article. Use when the user asks for an SEO article, blog post for ranking, "rank for keyword X", organic content, search-optimized post, pillar page, or content for organic traffic. Includes keyword targeting, search intent matching, internal linking suggestions, and meta tags.