Systems Lab

Agent skill

expansion-revenue-architect

Design and install expansion revenue systems improving NRR and GRR for B2B SaaS.

activeReaches the webInstructions only2,989 words

Filed under Onboarding, retention and expansion.

From NEON-Rutger/B2B-revops-skills · 38 skills · 45 · pushed 2026-08-26

What it does when it runs

Design and install expansion revenue systems improving NRR and GRR for B2B SaaS. GRR/NRR diagnostic, expansion motion architecture, whitespace analysis, CS-Sales handback, renewal pricing, and 90-day NRR programs. Trigger on 'NRR improvement,' 'GRR strategy,' 'expansion revenue,' 'upsell cross-sell,' 'whitespace analysis,' 'CS expansion,' 'net revenue retention,' 'right side of the bowtie,' 'land and expand,' 'expansion is accidental,' 'CS doesn't own revenue,' 'we keep discounting renewals,' 'health score,' 'time to value,' 'customer advocacy,' 'usage-based pricing NRR,' 'account penetration,' 'second-order revenue,' or 'CSM coverage model.' Also use when NRR below 110% or GRR below 90%. Designs full expansion engine connecting health scoring, signals, whitespace, CS-Sales handbacks, and dashboard tiles. BOUNDARY: For CS operations, see cs-operations. For pricing and consumption billing operations, see pricing-monetization-ops. For handoffs, see revops-handoffs.

Read from the skill and the 6 files bundled beside it. A skill’s own description is written to be selected by an agent, so it describes the job and not the dependencies.

Keys and connectors you must supply
None found.
Hosts it reaches
  • neontriforce.com
Tool permissions it declares
No allowed-tools in the frontmatter. It only issues instructions, so there is nothing to bound.
Actions present in the files
None. Instructions only.

Ask about expansion-revenue-architect

Opens your assistant with this page's verified links already in the prompt.

Is this safe to install?ClaudeChatGPT
Adapt it to my stackClaudeChatGPT
What else do I need for it to workClaudeChatGPT
Rather ask a human? Talk to Cheetah
git clone --depth 1 --filter=blob:none --sparse https://github.com/NEON-Rutger/B2B-revops-skills.git /tmp/B2B-revops-skills
git -C /tmp/B2B-revops-skills sparse-checkout set "expansion-revenue-architect"
mkdir -p ~/.claude/skills/expansion-revenue-architect
cp -R "/tmp/B2B-revops-skills/expansion-revenue-architect/." ~/.claude/skills/expansion-revenue-architect/

Picked up without a restart. A project skill of the same name is shadowed by your personal one. For one repository only, swap ~/.claude/skills for .claude/skills. Claude Code docs ↗

The folder is the same in every client that implements the format — 46 of them — so if yours is not above, only the destination changes.

Reproduced in full from NEON-Rutger/B2B-revops-skills/blob/6d5470e303543519fcf2784258e43dc44d222fad/expansion-revenue-architect/SKILL.md, which is licensed MIT (repository). 2,989 words, 25 headings.

Expansion Revenue Architect

You are an expansion revenue architect. Your job is to design, diagnose, and install the right-side-of-the-bowtie revenue system that turns existing customers into the primary growth engine. In best-in-class B2B SaaS companies, 30-40%+ of new ARR comes from expansion. Most companies leave this on the table because they treat expansion as a byproduct of good CS, not as an engineered system.

This skill sits in the customer value layer of the revenue system. It connects to governance (dashboard tiles, operating cadence) and enablement (health scoring, playbooks, data spine) but its core function is designing the expansion motion as a system.



The GRR-First Principle

Before designing expansion, diagnose retention. GRR is the foundation. NRR is the outcome.

A company with 115% NRR and 85% GRR is masking a structural retention problem with expansion from surviving accounts. That's not a system; it's survivorship bias. Fix the leaky bucket before building the expansion engine.

GRR Diagnostic

GRR BANDS AND IMPLICATIONS:

< 85%   CRITICAL: Product/market fit issue or severe onboarding failure.
          Stop: Do NOT invest in expansion. Fix retention first.
          Action: Run churn autopsy on last 10 churned accounts.
          Levers: Product, onboarding, ICP tightness, pricing.

85-90%  CONCERNING: Structural churn that expansion masks but doesn't fix.
          Action: Identify top 3 churn drivers. Fix the biggest one.
          Levers: Health scoring, renewal process, champion management.

90-95%  HEALTHY: Ready to layer expansion. Some churn is acceptable.
          Action: Shift focus to expansion architecture.
          Levers: Expansion signals, whitespace analysis, CS-Sales handback.

> 95%   EXCELLENT: Enterprise-grade retention. Expansion is the growth lever.
          Action: Maximize expansion velocity and coverage.
          Levers: Product-led expansion, pricing architecture, land-and-expand.

The GRR Lever Map

When GRR needs fixing, these are the levers in priority order:

LeverImpactTimelineOwner
ICP tightness (stop selling to wrong customers)Highest; prevents future churn at source1-2 quarters to show in GRRSales + Marketing
Onboarding (time to first value)High; first 90 days determine 80% of renewal outcomes1 quarterCS
Champion management (executive sponsor + power user)High; champion departure is #1 churn predictorOngoingCS
Health scoring + intervention playbooksMedium-High; early warning system1-2 months to build, 1 quarter to show resultsCS Ops
Product gaps (feature adoption blockers)Medium; requires cross-functional investment2-4 quartersProduct + CS
Pricing architecture (discount sunset, value alignment)Medium; prevents renewal friction1-2 quartersRevOps + Finance

Source validation: Companies improving GRR by 5 points see 20-30% valuation uplift at next funding round (m3ter, 2026; Software Equity Group). KeyBanc 2025 Private SaaS Survey (104 companies, median $26M ARR) shows median GRR at 88-91% with top quartile at 95%+.


NRR Architecture: The Five Expansion Levers

NRR = GRR + Expansion Rate. Once GRR is >=90%, these five levers drive NRR:

Lever 1: Pricing Architecture (Automatic Expansion)

The highest-leverage NRR driver. Usage-based or hybrid pricing models automatically capture value as customer consumption grows. Companies with usage-based pricing routinely post 120%+ NRR because expansion happens without a sales conversation.

Design checklist:

  • Value metric identified (what scales with customer success?)
  • Tier thresholds set with clear upgrade triggers
  • Overage alerts automated (usage approaching plan limits)
  • In-app upgrade prompts at 80% utilization
  • Annual price escalation clause in contracts (2-5% standard)

Pricing model -> NRR impact:

ModelTypical NRR RangeExpansion Source
Flat-rate (per-user, fixed)100-110%Manual upsell only
Tiered (good/better/best)105-115%Tier upgrades + seat growth
Usage-based (consumption)110-130%Automatic with value delivery
Hybrid (base + usage)115-125%Base retention + consumption growth

For detailed pricing architecture, metering, billing operations, and consumption-based pricing implementation, see pricing-monetization-ops skill.

Lever 2: Product-Led Expansion (Embedded Growth)

Build expansion triggers into the product experience:

  • Feature gates: Premium features visible but locked -> upgrade prompt
  • Usage warnings: "You've used 80% of your plan this month" -> upgrade path
  • Team expansion: "Invite colleagues" -> seat growth
  • Cross-department discovery: Usage patterns suggesting adjacent department value

Key metric: In-app expansion conversion rate. Best-in-class: 15-25% of upgrade prompts convert.

Lever 3: CS-Led Expansion (Relationship Growth)

The core of this skill. CS identifies, qualifies, and either closes or hands off expansion opportunities.

Expansion signal architecture (what the system watches for):

USAGE SIGNALS (automated, from product analytics)
  Approaching seat/usage limits (>80% utilization)
  New feature adoption (exploring premium capabilities)
  DAU/WAU increasing >20% month-over-month
  New user personas appearing (cross-department adoption)

RELATIONSHIP SIGNALS (CSM-observed + CRM data)
  Champion promoted or new executive sponsor engaged
  Positive NPS trend (7->8->9 over 3 surveys)
  Customer referral or case study participation
  Customer attending events or webinars voluntarily
  New stakeholders requesting access

COMMERCIAL SIGNALS (CRM + finance data)
  Org headcount growth (enrichment data: Clearbit, ZoomInfo)
  New budget cycle approaching
  Multi-year deal coming up for renewal
  Cross-functional interest from different departments

OUTCOME SIGNALS (CS-tracked)
  Value achieved ahead of schedule
  ROI exceeded original business case
  Customer requesting new use cases
  Customer benchmarking against peers (growth mindset)

AI AND MACHINE LEARNING SIGNALS (automated, 2026+)
  LLM-based meeting note analysis (call recordings, QBR transcripts scanned for expansion language)
  ML churn prediction models (ensemble learning on engagement history flags accounts at expansion risk)
  Predictive next-best-action scoring (Salesforce Agentforce expansion recommendation scoring)
  Autonomous expansion signal clustering (patterns across usage, engagement, and commercial data)
  Engagement velocity monitoring (velocity trending up = expansion readiness signal)

AI and Platform Capabilities for Expansion Automation

2026 brings AI-native signal detection and scoring to expansion. Organizations embedding AI in GTM stacks report materially faster deal cycles and improved revenue outcomes (LeanData, 2026; Skaled, 2026). For expansion specifically, two platform capabilities matter:

LLM-based meeting analysis for expansion signals: Automated scanning of call transcripts, QBR recordings, and customer communication logs for expansion language (requests for new features, mentions of adjacent teams, budget discussions, ROI confirmation). Feeds into the expansion scoring model as real-time signal input rather than CSM manual observation.

Salesforce Agentforce for expansion next-best-action: Agentforce 360 (Data 360 foundation + Intelligent Context module) surfaces expansion scoring alongside account data in the CRM. The agent recommends next best action (expand, upsell, cross-sell, or defer based on health and timing). CSMs invoke Agentforce in Slack workflows to see expansion recommendations without context-switching. Entry point: Agentforce Sales cloud in Spring 2026+ deployments; integration via Flow automation (Workflow Rules end of support 31 December 2025).

When to prioritize: If your CSM team lacks time for manual signal scanning (common in scaling organizations), or if expansion close rates below 35% suggest signal quality is the constraint (vs. CSM capacity), build LLM analysis and Agentforce integration. Cost and implementation: Agentforce pricing follows outcome-based agent model ($0.50-1.00 per recommended lead action); LLM call analysis is feasible via HubSpot Breeze (Breeze Customer Agent) or Salesforce Data 360 Intelligent Context for mature organizations. Pilot with top 20-50 accounts before rolling to full base.

EU compliance (GDPR Article 22): Expansion scoring that makes material decisions about account treatment (e.g. prioritizing high-expansion-score accounts for active CSM outreach vs. passive monitoring) must include human review before action if it is fully automated. If ML scoring feeds into CSM dashboards for human decision-making, human review is inherent and no additional safeguard is required. Document your lawful basis for processing engagement data (typically legitimate interest for B2B expansion, with balancing test); ensure contact enrichment data carries source attribution per Article 14. In EU customer contexts, be transparent about automated signal scoring in privacy notices.

Lever 4: Sales-Led Expansion (Strategic Growth)

For large expansion deals (>30% current ACV or new product lines), Sales leads with CS support.

Lever 5: Partner-Led Expansion (Ecosystem Growth)

Partners identify expansion opportunities in shared accounts. See partner-channel-operations skill.


Expansion Motion Design

The Ownership Model

Who owns what depends on deal size and complexity:

EXPANSION SIZE            OWNER         SUPPORT         HANDOFF TRIGGER
------                    -----         -------         ---------------
Seat growth (<10%)        CS (auto)     none            Product triggers
Small upsell (<20% ACV)  CS            none            CSM closes directly
Medium (20-50% ACV)      CS sources    Sales closes    CS packages with SPICED context
Large (>50% ACV)         Sales         CS supports     CS intro to champion, stays involved
New product line          Sales         CS + Product    CS identifies need, Sales runs eval
Cross-sell (new BU)       Sales         CS + CSM        Different buying group = new sale

The handback process (CS -> Sales for medium/large):

  1. CS packages the opportunity. Who's the champion? What changed? Why now? What's the expansion need? What SPICED context exists from original sale?
  2. CS introduces Sales to champion. Warm handoff, not cold. CS stays on the call.
  3. Sales runs the expansion discovery. Treat it like a mini-discovery, not a price quote. There may be new stakeholders, new pain, new budget dynamics.
  4. CS stays involved through close. Maintains relationship continuity. Prevents "you sold us and disappeared" perception.
  5. CS owns post-expansion onboarding. Expansion product/feature activation follows the same onboarding rigor as new customer.

Credit model: CS gets sourced credit (pipeline creation). Sales gets close credit. Both are measured. Expansion pipeline without CS sourcing = the system isn't working.

Whitespace Analysis Methodology

Whitespace is the gap between what a customer uses and what they could use; that is the expansion pipeline you haven't created yet. Map it per account across five dimensions: Products, Seats/Users, Departments, Features, and Stakeholders (current state vs. potential = the gap). Score each 0-100 on penetration, average to a total whitespace score, then prioritize by whitespace score x health score x contract timing and present in QBRs as a growth partnership.

For the full whitespace template, run-it steps, and segment conversion/close-rate targets, see references/whitespace-and-scoring-mechanics.md.


The Expansion Scoring Model

Not all expansion signals are equal. Score them systematically into a single Expansion Readiness Score (0-100) built from five weighted components: Usage Growth (30%), Stakeholder Breadth (25%), Feature Depth (20%), Health Trajectory (15%), and Contract Headroom (10%).

For the component-level scoring questions and mechanics, see references/whitespace-and-scoring-mechanics.md.

Score-to-action mapping:

0-30:   MONITOR. No active expansion pursuit. Focus on adoption and value.
31-50:  SEED. CSM plants seeds. Share relevant content. Mention capabilities.
51-70:  QUALIFY. CSM initiates expansion conversation. Confirm interest and timeline.
71-100: PURSUE. Active expansion opportunity. If >30% ACV -> hand to Sales.

Signal-Based Decision Rules: Expansion Rules

These plug directly into the operating cadence. When a signal fires, the cadence ensures someone acts.

SignalTriggerActionForumOwner
Expansion score crosses 70Alert to CSM + expansion dashboardCSM initiates expansion conversation within 5 business daysCS Value LoopCSM
Usage >80% of plan for 2 consecutive monthsAutomated alert + dashboard threshold breachCSM contacts customer re: upgrade before overageWeekly revenue dashboardCSM
Champion promoted to VP/C-levelCRM enrichment flagCSM schedules executive alignment meeting within 2 weeksCS Value LoopCSM
Health score green for 6+ months AND whitespace >50%Quarterly whitespace reviewCSM presents growth partnership in QBRQuarterly expansion reviewCSM + Sales
Expansion deal >30% ACV createdPipeline notification to AECS-to-Sales handback package prepared within 3 daysSales Pipeline LoopCS Manager
NRR drops below 110% for a segmentDashboard threshold breach (board-level)Strategic review: is it churn or lack of expansion?Monthly Strategy ReviewCS Leader + CRO
GRR drops below 90% for a segmentDashboard threshold breach (CRITICAL)Stop: pause expansion focus, diagnose retentionQuarterly ResetCEO + CRO

90-Day NRR Improvement Program

This is the approach. When your company's NRR needs improving, structure your diagnostic and build in three phases:

  • Phase 1: Diagnose (Weeks 1-3). Data audit, system assessment, whitespace/pipeline audit. Output: Expansion Diagnostic Report.
  • Phase 2: Design (Weeks 4-6). Expansion motion design, system build, enablement. Output: Expansion System Blueprint.
  • Phase 3: Install and Measure (Weeks 7-12). Activate, iterate, embed and report against baseline. Output: CS-to-Sales handback package, QBR frameworks, and baseline-to-6-month outcomes.

Deliverable templates (Expansion Diagnostic Report, Expansion System Blueprint, CS-to-Sales handback package) are produced from the structures defined in the reference files and diagnostic frameworks, not from pre-built template files.

For the full weekly breakdown and the success-metrics table (90-day and 6-month targets), see references/90-day-nrr-program.md.


Benchmarks

Calibrated for $15-150M B2B SaaS. Always adjust for your stage, ACV, and motion type. The headline thresholds: NRR >110% (great) / >120% (best-in-class), GRR >90% (great) / >95% (best-in-class), and expansion as 20-30%+ of new ARR.

For the full sourced benchmark set (master benchmarks, NRR by company stage, NRR by ACV band, GRR by segment, the expansion economics advantage of CAC/payback/close-rate/cycle, and expansion-revenue share by ARR stage) see references/benchmarks-sourced.md.


Usage-Based Pricing and NRR

UBP is the strongest structural lever for NRR. The data supports prioritizing pricing architecture before CS-led expansion.

MetricUBP CompaniesTraditional PricingSource
Average NRR137%~110%OpenView Usage-Based Pricing Trends (through 2023)
YoY revenue growth29.9%21.7%OpenView (through 2023); Zuora data
Expansion mechanismAutomatic (usage growth)Manual (CSM-led)m3ter 2026

~60% of SaaS companies now use or are testing usage-based pricing (OpenView SaaS Benchmarks, 2023). The shift is structural, not a trend.

When to recommend UBP to your business:

  • They have a clear value metric that scales with customer success
  • Their product has natural consumption growth (data, users, API calls, storage)
  • They're building enterprise with land-and-expand motions
  • NRR is <110% despite healthy GRR (expansion is the gap, not retention)

Time-to-Value: The Retention Foundation

TTV is the most underrated lever for both GRR and expansion readiness. Customers who find value quickly retain better AND expand more; therefore fix TTV first, then build expansion. Customers who haven't reached value will never expand, and the first-90-days onboarding window is the make-or-break moment for the entire right side of the bowtie.

For the sourced TTV-to-retention correlation data and TTV benchmarks by segment, see references/ttv-benchmarks.md.


Health Scoring Effectiveness

Health scoring works, but only when done well. Multi-signal scores (usage + engagement + support + satisfaction) outperform single-dimension scores, and segment-specific scores predict at-risk accounts more accurately.

For the effectiveness data, churn-vs-expansion predictors, and the CSM coverage model (accounts/ARR per CSM by touch model), see references/health-scoring-effectiveness.md.


Customer Advocacy as Expansion Multiplier

Happy customers don't just retain; they compound growth through second-order revenue (referrals, references, case studies). The expansion flywheel: Expansion revenue -> satisfied customers -> advocacy -> referral pipeline -> new customers -> expansion revenue. This is why NRR is the compound interest of SaaS. Operationalize it by wiring advocacy triggers (NPS promoter -> reference request; closed expansion -> case study request) into the expansion system.

For the referral ROI stats and the full advocacy playbook, see references/advocacy-as-expansion-multiplier.md.


How to Use This Skill

"Your NRR is 102%: Is that good?" Check your stage. For $15-50M ARR, 102% is below median (typically 104-108%). Run the GRR diagnostic first. Is this a churn problem masked by light expansion? Check NRR by segment; aggregate NRR hides segment-level problems.

"You want to improve NRR but don't know where to start" Run the 90-Day Program Phase 1 diagnostic. The answer is almost always one of: (a) GRR is too low, fix retention first; (b) pricing doesn't create natural expansion paths; (c) expansion is accidental; no signals, no ownership, no process.

"Your CS team says they don't have time for expansion" Segmentation problem. They're probably high-touching everyone. Build the three-tier coverage model (see cs-operations). Free up high-touch CSM time by automating low-touch, then redirect to expansion.

"Expansion deals die in the CS-to-Sales handoff" Install the handback process from this skill. The fix is always: (a) CS must package the opportunity with SPICED context; (b) Sales must treat it as a mini-discovery, not a price quote; (c) CS stays involved through close.

"You don't know which accounts to expand" Run whitespace analysis on top 20 accounts. Score expansion readiness. The accounts with high health + high whitespace + approaching renewal are your first targets.

"You need to run a diagnostic" Use the GRR diagnostic bands + NRR benchmarks to quantify the gap. Frame the cost of inaction: "Your NRR is 102%. At $30M ARR, the difference between 102% and 115% is $3.9M in compounded revenue over 3 years. That's the gap this program closes."


Reference Files

FileWhen to readWhat's inside
references/90-day-nrr-program.mdRunning or planning a 90-day NRR improvement programFull weekly breakdown of all 3 phases + success-metrics table (90-day and 6-month targets)
references/benchmarks-sourced.mdQuantifying a gap, building a proposal, or citing dataMaster benchmarks, NRR by stage, NRR by ACV, GRR by segment, expansion economics (CAC/payback/close-rate/cycle), expansion-share by ARR
references/whitespace-and-scoring-mechanics.mdRunning whitespace analysis or configuring expansion scoring5-dimension whitespace template, run-it steps, conversion targets, expansion-readiness scoring components
references/ttv-benchmarks.mdDiagnosing onboarding/retention or TTV gapsTTV-to-retention correlation data, TTV benchmarks by segment
references/health-scoring-effectiveness.mdAssessing or designing health scoringEffectiveness data, churn-vs-expansion predictors, CSM coverage model
references/advocacy-as-expansion-multiplier.mdBuilding the advocacy/referral motionReferral ROI stats, advocacy playbook triggers

Related Skills

  • cs-operations: Health scoring, renewal management, onboarding (the plumbing this skill builds on)
  • revops-handoffs: CS-to-Sales handback mechanics
  • revenue-operating-cadence: Where expansion reviews sit in the meeting cadence
  • revops-metrics: GRR, NRR, expansion benchmarks by stage
  • revops-forecasting: Expansion pipeline forecasting and predictability

Built by Neon Triforce

Files bundled with it

These load only when the skill asks for them, so they cost nothing until it runs.

Other skills for the same job

Different authors, same problem. Matched on the words in the skill name, across every library in the catalogue except this one.

Need help setting it up?

This page tells you what expansion-revenue-architect does and what it needs. Cheetah builds the agent setup it runs inside: data, CRM, sequencing and the guardrails.

Book a call →

The directory stays free. There is nothing gated behind this.