business-health-diagnostic
Diagnose SaaS business health across growth, retention, efficiency, and capital. Use when preparing a business review or prioritizing urgent fixes.
What this skill does
## Purpose
Diagnose overall SaaS business health by analyzing growth, retention, unit economics, and capital efficiency metrics together. Use this to identify problems early, prioritize actions by urgency, and deliver a comprehensive health scorecard for board meetings, quarterly reviews, or fundraising preparation.
This is not a single-metric check—it's a holistic diagnostic that connects revenue, retention, economics, and efficiency to reveal systemic issues and opportunities.
## Key Concepts
### The Business Health Framework
A SaaS business is healthy when four dimensions work together:
1. **Growth & Retention** — Are you growing and keeping customers?
- Revenue growth rate
- NRR (Net Revenue Retention)
- Churn rate
- Quick Ratio
2. **Unit Economics** — Is the business model profitable at the customer level?
- CAC (Customer Acquisition Cost)
- LTV (Lifetime Value)
- LTV:CAC ratio
- Payback period
- Gross margin
3. **Capital Efficiency** — Are you using cash efficiently?
- Burn rate
- Runway
- Rule of 40
- Magic Number
4. **Strategic Position** — Are you positioned for sustainable success?
- Market positioning (below, at, above market pricing)
- Competitive moat (network effects, data, brand)
- Revenue concentration risk
- Operating leverage
### Stage-Specific Benchmarks
**Early Stage (Pre-$10M ARR):**
- Focus: Product-market fit, unit economics
- Growth: >50% YoY
- LTV:CAC: >3:1
- Gross Margin: >70%
- Runway: >12 months
- Acceptable: Negative margins, high burn (if unit economics work)
**Growth Stage ($10M-$50M ARR):**
- Focus: Scaling efficiently
- Growth: >40% YoY
- NRR: >100%
- Rule of 40: >40
- Magic Number: >0.75
- Acceptable: Moderate burn if growth is strong
**Scale Stage ($50M+ ARR):**
- Focus: Profitability, efficiency
- Growth: >25% YoY
- NRR: >110%
- Rule of 40: >40
- Profit Margin: >10%
- Required: Positive or near-positive cash flow
### Red Flag Categories
**Critical (Fix immediately):**
- Runway <6 months
- LTV:CAC <1.5:1
- Churn accelerating cohort-over-cohort
- NRR <90%
- Magic Number <0.3
**High Priority (Fix within quarter):**
- Rule of 40 <25
- Payback >24 months
- Quick Ratio <2
- Gross margin <60%
- Revenue concentration >50% in top 10 customers
**Medium Priority (Address within 6 months):**
- NRR 90-100% (flat, not growing)
- Magic Number 0.3-0.5
- Operating leverage negative
- Churn rate stable but high (>5% monthly)
### Anti-Patterns (What This Is NOT)
- **Not a single metric:** "Revenue is growing 50%, we're great!" (ignoring burn, churn, unit economics)
- **Not stage-agnostic:** Early-stage burn is acceptable; scale-stage burn is a problem
- **Not static:** Health is directional—are metrics improving or degrading?
- **Not just numbers:** Context matters (competitive pressure, market changes, team capacity)
### When to Use This Framework
**Use this when:**
- Preparing for board meetings or investor updates
- Quarterly business reviews (QBR)
- Fundraising preparation (know your numbers)
- Annual planning (identify improvement areas)
- You suspect problems but can't pinpoint them
- New PM/exec joining and needs health assessment
**Don't use this when:**
- You're pre-revenue (focus on product-market fit first)
- You're in pure research mode (not enough data)
- You need tactical guidance (use specific skills: feature, channel, pricing)
---
### Facilitation Source of Truth
Use [`workshop-facilitation`](../workshop-facilitation/SKILL.md) as the default interaction protocol for this skill.
It defines:
- session heads-up + entry mode (Guided, Context dump, Best guess)
- one-question turns with plain-language prompts
- progress labels (for example, Context Qx/8 and Scoring Qx/5)
- interruption handling and pause/resume behavior
- numbered recommendations at decision points
- quick-select numbered response options for regular questions (include `Other (specify)` when useful)
This file defines the domain-specific assessment content. If there is a conflict, follow this file's domain logic.
## Application
This interactive skill asks **up to 4 adaptive questions**, then delivers a comprehensive diagnostic with prioritized recommendations.
---
### Step 0: Gather Context
**Agent asks:**
"Let's diagnose your business health. I'll need metrics across four dimensions: growth, retention, unit economics, and capital efficiency.
**Company context:**
- Stage: (Pre-$10M ARR, $10M-$50M ARR, $50M+ ARR)
- Business model: (PLG, sales-led, hybrid)
- Target market: (SMB, mid-market, enterprise, mixed)
**Why this matters:** Benchmarks vary by stage. Early-stage optimizes for growth; scale-stage optimizes for efficiency.
Please provide the following metrics. Use 'unknown' if you don't have a metric."
---
### Step 1: Growth & Retention Metrics
**Agent asks:**
"**Growth & Retention:**
1. **Revenue:**
- Current MRR or ARR: $___
- Revenue growth rate: ___% (MoM or YoY)
2. **Retention:**
- Monthly churn rate: ___%
- NRR (Net Revenue Retention): ___%
- Quick Ratio: ___ (or I can calculate it)
3. **Expansion:**
- Expansion revenue as % of total MRR: ___%
4. **Cohort trends:**
- Are recent cohorts retaining better or worse than older cohorts?
1. Better (improving)
2. Same (stable)
3. Worse (degrading)
4. Unknown"
**Based on answers, agent evaluates:**
- ✅ **Healthy growth:** Growth >40% YoY (growth stage) or >25% (scale stage)
- ✅ **Healthy retention:** NRR >100%, churn <5% monthly, Quick Ratio >2
- 🚨 **Growth problems:** Growth <20% YoY
- 🚨 **Retention problems:** NRR <100%, churn >5%, cohort degradation
---
### Step 2: Unit Economics Metrics
**Agent asks:**
"**Unit Economics:**
1. **Acquisition:**
- CAC (Customer Acquisition Cost): $___
- Blended or by channel? (If by channel, what's your best channel CAC?)
2. **Value:**
- LTV (Lifetime Value): $___
- LTV:CAC ratio: ___ (or I can calculate it)
- Payback period: ___ months (or I can calculate it)
3. **Margins:**
- Gross margin: ___%
- Contribution margin (if known): ___%
4. **Trends:**
- Is CAC increasing, stable, or decreasing over time?
1. Decreasing (improving efficiency)
2. Stable
3. Increasing (diminishing returns)
4. Unknown"
**Based on answers, agent evaluates:**
- ✅ **Healthy economics:** LTV:CAC >3:1, payback <12 months, gross margin >70%
- ⚠️ **Marginal economics:** LTV:CAC 2-3:1, payback 12-18 months
- 🚨 **Poor economics:** LTV:CAC <2:1, payback >24 months, gross margin <60%
---
### Step 3: Capital Efficiency Metrics
**Agent asks:**
"**Capital Efficiency:**
1. **Cash:**
- Cash balance: $___
- Monthly net burn rate: $___
- Runway: ___ months (or I can calculate it)
2. **Efficiency ratios:**
- Rule of 40: ___ (Growth % + Profit Margin %) (or I can calculate it)
- Magic Number: ___ (S&M efficiency) (or I can calculate it)
3. **Operating expenses:**
- S&M as % of revenue: ___%
- R&D as % of revenue: ___%
- Is OpEx growing faster than revenue?
1. No (positive operating leverage)
2. Yes (negative operating leverage)
3. Unknown
4. **Profitability:**
- Profit margin: ___%
- Path to profitability: (already profitable, 6-12 months, 12-24 months, >24 months, unknown)"
**Based on answers, agent evaluates:**
- ✅ **Healthy efficiency:** Rule of 40 >40, magic number >0.75, runway >12 months
- ⚠️ **Acceptable efficiency:** Rule of 40 25-40, magic number 0.5-0.75, runway 6-12 months
- 🚨 **Poor efficiency:** Rule of 40 <25, magic number <0.5, runway <6 months
---
### Step 4: Deliver Comprehensive Diagnostic
**Agent synthesizes all metrics and delivers:**
1. **Overall Health Score** — Healthy / Moderate / Concerning / Critical
2. **Dimension Scores** — Growth, Retention, Economics, Efficiency
3. **Red Flags** — Critical, High Priority, Medium Priority
4. **Prioritized Recommendations** — Top 3-5 actions with expected impact
5. **Stage-Appropriate Benchmarks** — How yoRelated in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".