Founder retention
Skill 1elasmarjad/yc-founder-skills/plugins/yc-founder-skills/skills/founder-retention
Skills for early-stage startup founders.
npx -y skills add 1elasmarjad/yc-founder-skills --skill founder-retentionAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- 18 days oldThe repository was created 18 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Define, calculate, interpret, and improve startup retention using core-action, user, logo, revenue, usage, and marketplace cohorts. Use for churn, activation, PMF evidence, engagement cadence, customer success, AI-product tourists, annual contracts, or deciding whether acquisition is ready to scale.
SKILL.md
13.4 KB, as published. Nobody here has run it
Purpose
Make repeated user value visible through correctly defined cohorts and connect every retention movement to a segment, lifecycle failure, and product action.
Give the founder a decision, the evidence behind it, the strongest contrary case, and the smallest executable next step. Do not produce generic encouragement or a long menu of tactics.
When to Trigger
Use this skill according to the frontmatter description. If the stated issue is a symptom of an earlier broken link, say so and route to founder-debugger or the owning retained skill.
Inputs Needed
- Target segment and acquisition source
- Core value event and its raw instrumentation
- Natural repeat cadence
- Signup, activation, core action, payment, expansion, contraction, and churn events
- User, account, logo, revenue, usage, or GMV unit
- Cohort start rule and observation window
- Customer contract length and cancellation freedom
- Qualitative evidence from retained, churned, and failed-activation users
Ask only for missing inputs capable of changing the decision. For reversible actions, make assumptions explicit and propose a bounded test instead of blocking on perfect data.
Questions to Ask
- What action proves the user received value?
- How often should a successful user naturally repeat it?
- Who belongs in the denominator?
- Does the curve flatten for any segment?
- Are newer cohorts improving?
- Is revenue retention hiding logo churn or vice versa?
- Are annual contracts masking weak usage?
- Did acquisition mix change?
- Where does the lifecycle first diverge between retained and churned users?
- What do the best retained users do before everyone else?
- Is involuntary churn separated from lost value?
Mental Models
- Retention is repeated value, not login frequency.
- Natural cadence before benchmark.
- Cohort before aggregate.
- Core-action retention before generic activity.
- Activation is the first retention intervention.
- Flattening reveals a retained segment, not universal PMF.
- Logo, revenue, usage, and GMV retention answer different questions.
- Annual contracts require engagement evidence.
- Cost per retained customer connects retention to distribution.
Use these models as competing lenses. Select the one that best explains the observed behavior, state what evidence would falsify it, and convert it into a decision rather than repeating it as a slogan.
YC Principles
- Repeat usage is stronger evidence than what users say.
- Choose the cadence from the product: daily, weekly, monthly, annual, or event-driven.
- A flattening cohort curve indicates PMF only for that product and retained segment.
- Do not scale growth channels while users flow out of the product.
- Track the actual core action, not vanity activity.
- Talk to retained and churned users to understand the mechanism behind the curve.
Paul Graham Principles
- Make a small number of users intensely happy before broad acquisition.
- Contact with users should change the product toward what they repeatedly need.
- Growth without strong appeal can conceal a moderately wanted product and create the fatal pinch.
Garry Tan Principles
- Treat retention as a product-craft outcome, not a lifecycle-messaging project alone.
- Use AI to analyze cohorts and qualitative evidence while preserving stable event definitions.
- In AI products, separate tourists from durable workload users and monitor dependency on underlying model changes.
Decision Frameworks
Metric selector
- Consumer habit: user core-action retention at daily or weekly cadence.
- Infrequent consumer job: event or annual return at the natural opportunity window.
- B2B SaaS: account/logo retention plus active workflow and gross/net revenue retention.
- Usage product or API: retained active accounts and usage/revenue curves.
- Marketplace: buyer, seller, transaction, and GMV retention by market.
- Annual contracts: usage, breadth, depth, and outcome health before renewal.
- AI: task or workflow retention after tourist cohorts wash out, plus cost and correction rate.
Churn decomposition
- Bad-fit acquisition
- Failure to activate
- Core value not delivered
- Value delivered too rarely
- Reliability or trust failure
- Price-value mismatch
- Customer business failure or champion loss
- Competitive switch
- Involuntary payment failure
- Seasonal or natural dormancy
Intervention order
- Verify instrumentation.
- Segment the curve.
- Fix acquisition quality if bad-fit users dominate.
- Fix activation if retained users share an early behavior others miss.
- Fix core product if activated users still do not repeat.
- Fix reliability and trust before reminders.
- Use lifecycle communication only when value exists but triggers are missed.
- Scale acquisition only after retained cohorts justify it.
Step-by-Step Process
- Define the user, core action, natural cadence, cohort start, and denominator.
- Audit raw events and identity/account stitching.
- Plot cohorts by segment and acquisition source.
- Compare user, account, revenue, usage, or GMV retention as appropriate.
- Choose the business object that can actually churn: use account retention when an account buys and renews, user retention when individuals independently receive value, and report both when seat depth predicts renewal.
- Treat small cohorts as directional evidence: show counts beside percentages, compare multiple cohorts, and avoid scaling from one apparent plateau until the mechanism repeats.
- Find the first lifecycle divergence between retained and churned users.
- Interview and observe both groups.
- Classify churn mechanisms.
- Choose the earliest controllable mechanism.
- Ship one intervention and annotate the cohort.
- When the natural retention cadence exceeds the decision window, use an explicitly labeled leading indicator tied to the known mechanism, but keep the later cohort readout scheduled; never relabel activation or stated intent as retention.
- Wait the minimum honest observation window.
- Compare newer cohorts and guardrail metrics.
- Decide whether to iterate product, narrow segment, change acquisition, adjust price, or scale.
Checklists
Definition
- Core action represents value.
- Cadence matches the job.
- Cohort and denominator are explicit.
- Identity and event instrumentation reconcile.
- Segments and channels are separable.
Interpretation
- Curve shape and newer-cohort trend are shown.
- Contracts are not mistaken for engagement.
- Logo and revenue views are compared.
- Qualitative mechanisms support the numbers.
- Acquisition scaling is gated on retained quality.
Red Flags
- Retention means app opens or logins with no value action.
- DAU/MAU is used for an infrequent product.
- Only aggregate active users are shown.
- Annual contracts produce false confidence.
- A curve flattening near zero is celebrated without segment size or economics.
- Expansion from a few accounts hides widespread logo churn.
- The team sends reminders before fixing missing value.
- Acquisition mix changes but cohorts are not segmented.
- AI model changes alter quality without cohort annotation.
Common Mistakes
- Using a universal retention benchmark.
- Changing cohort definitions between reports.
- Ignoring failed activation.
- Blending free, paid, consumer, SMB, and enterprise users.
- Treating cancellation reasons as causal truth without behavior.
- Optimizing resurrection while new cohorts remain broken.
- Calculating LTV from an unflattened curve.
- Scaling GTM based on bookings rather than retained customers.
Metrics
- Core-action retention curve
- Activation into first value
- Time to first value
- Logo/account retention
- Gross revenue retention
- Net revenue retention
- Usage or GMV retention
- Expansion, contraction, and resurrection
- Involuntary versus voluntary churn
- Cost per retained customer
- Retention by segment and channel
- Newer-cohort improvement
- AI task success, correction, and cost among retained users
For every metric, define the unit, numerator, denominator, cohort, segment, cadence, source event, and owner. Prefer decision thresholds and cohort movement over universal benchmarks.
Example Scenarios
Scenario 1
Travel users book twice a year: use opportunity or annual booking retention, not DAU/MAU; measure whether users return when the job recurs.
Scenario 2
Annual enterprise contracts renew but usage collapses: treat workflow activity and realized outcome as leading retention; contract lock-in is not PMF.
Scenario 3
An AI app has large month-one churn: rebase analysis after tourist cohorts, isolate retained workloads, and compare task success, frequency, willingness to pay, and model dependency.
AI Prompt Templates
Template 1
Define the correct retention metric for this product, including unit, core action, cohort start, cadence, denominator, segments, and observation window.
End with a decision, owner, deadline, metric, threshold, stop rule, and strongest contrary case.
Template 2
Diagnose these cohort curves. Separate instrumentation, acquisition quality, activation, core value, reliability, pricing, and customer-context causes.
End with a decision, owner, deadline, metric, threshold, stop rule, and strongest contrary case.
Template 3
Design one retention experiment from this lifecycle divergence with owner, event changes, target cohort, threshold, guardrails, and honest observation period.
End with a decision, owner, deadline, metric, threshold, stop rule, and strongest contrary case.
Related Skills
founder-talking-to-usersfounder-mvpfounder-distributionfounder-pricingfounder-default-alivefounder-debugger
Further Reading
- Startup School Week 4: Launching and Growth — Links manual launch, retention, funnels, product growth, and external channels.
- Growth Office Hours — How to derive the core action and natural retention interval from retained-user behavior.
- David Lieb on Google Photos and Bump — A concrete postmortem on why downloads and actives can conceal misunderstood retention.
- Analytics for Startups — Instrumentation and product analytics for the PMF journey.
- The Real Product-Market Fit — Distinguishes a decent business or product from unmistakable market pull.
- Growth AMA with Gustaf Alströmer — Stage-specific channel selection, founder-led growth, retention prerequisites, and marketplace sequencing.
Source Links
- Startup School Week 4: Launching and Growth — Kat Mañalac and Gustaf Alströmer. Links manual launch, retention, funnels, product growth, and external channels.
- Growth Office Hours — Anu Hariharan and Gustaf Alströmer. How to derive the core action and natural retention interval from retained-user behavior.
- David Lieb on Google Photos and Bump — David Lieb and Gustaf Alströmer. A concrete postmortem on why downloads and actives can conceal misunderstood retention.
- Analytics for Startups — Y Combinator. Instrumentation and product analytics for the PMF journey.
- The Real Product-Market Fit — Michael Seibel. Distinguishes a decent business or product from unmistakable market pull.
- Growth AMA with Gustaf Alströmer — Gustaf Alströmer. Stage-specific channel selection, founder-led growth, retention prerequisites, and marketplace sequencing.
- Retention Is All You Need — Andreessen Horowitz. Secondary analysis of AI-tourist churn, curve flattening, engagement, and cost per retained customer.
- 16 More Startup Metrics — Andreessen Horowitz. A specific cohort-analysis procedure and warnings about vanity metrics.
- How to Know If You've Got Product-Market Fit — Lenny Rachitsky. Secondary synthesis emphasizing long-term cohort retention and market-specific flattening.
- What I've Learned from Users — Paul Graham. Tests whether founders are paying attention by asking what, specifically, they have learned from users.
Gives 0 of the 12 instructions most analytics metrics skills give
Counted across 368 of the 369 authors here whose files we hold, read 2026-08-06
- read product marketing context before asking questionsin 18 of 368, across 12 files
- use lowercase with underscores for event namesin 16 of 368, across 6 files
- track events for decisions not vanity metricsin 15 of 368, across 5 files
- use object-action format for event namesin 15 of 368, across 8 files
- produce a tracking plan documentin 14 of 368, across 4 files
- Call RUBE_SEARCH_TOOLS first to get current schemasin 13 of 368, across 2 files
- establish consistent event naming conventions before implementingin 10 of 368, across 4 files
- Verify dimension and metric compatibility before reportingin 9 of 368, across 2 files
- Encrypt data at rest and in transitin 9 of 368, across 3 files
- use snake_case for event namesin 9 of 368, across 5 files
- monitor technical health during the testin 9 of 368, across 5 files
- use consistent property namesin 8 of 368, across 4 files
Said here and by no other author read
- route broken links to the owning skill
- ask only for inputs capable of changing the decision
- define the user core action and cadence
- audit raw events and identity stitching
- plot cohorts by segment and acquisition source
- choose the correct churnable business object
Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once.