Agent skill

Retention Predictor

by MaxKmet in MaxKmet/idea-validation-agents

Predicts retention potential by evaluating usage frequency, habit formation mechanics, and churn risk factors for a B2C app idea.

MITAuto-check passedSales & Support

Install Retention Predictor

skills CLI
$ npx skills add MaxKmet/idea-validation-agents --skill retention-predictor -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install MaxKmet/idea-validation-agents retention-predictor --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/MaxKmet/idea-validation-agents.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/retention-predictor .claude/skills/retention-predictor && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
retention-predictor
GitHub stars
477
Token cost
~577 tokens
SKILL.md length
191 words
Files
1
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Predicts retention potential by evaluating usage frequency, habit formation mechanics, and churn risk factors for a B2C app idea.

  • Works in 5 steps: Estimate natural usage frequency based… → Identify external triggers that would… → Score habit formation potential (1–5)… → …
  • Tasks that involve Customer success
  • SKILL.md covers Purpose, Input, Evaluation Factors and Process, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Retention Predictor is an agent skill from MaxKmet/idea-validation-agents. Predicts retention potential by evaluating usage frequency, habit formation mechanics, and churn risk factors for a B2C app idea.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Sales & Support, covering Customer success. The repository describes itself as: AI agents that act as your personal venture analyst - from startup idea brainstorming to full validation and go-to-market strategy. Built for developers who'd rather validate in… The licence is MIT.

When your agent uses it

  • Tasks that involve Customer success

Example prompts

  • “Use the retention-predictor skill to predict retention potential by evaluating usage frequency, habit formation mechanics, and churn risk factors…”
  • “/retention-predictor”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Estimate natural usage frequency based on the problem (daily tooth brushing vs. annual tax filing).
  2. Identify external triggers that would cue app usage.
  3. Score habit formation potential (1–5) across the six factors above.
  4. Estimate D1, D7, D30 retention benchmarks for the app category.
  5. Flag high churn risk factors.

What it can do on your machine

Read from SKILL.md and the folder at commit 3a4c800. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Retention Predictor loads about 577 tokens when it runs. Until then it costs about 37 tokens; SKILL.md has 191 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~37
When it runs · the whole SKILL.md, loaded when a task matches
~577

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from MaxKmet/idea-validation-agents at commit 3a4c800, republished under its MIT licence (© MaxKmet). 191 words, ~577 tokens.

Download SKILL.mdSave it as .claude/skills/retention-predictor/SKILL.md (or your agent's skills folder).
name
retention-predictor
description
Predicts retention potential by evaluating usage frequency, habit formation mechanics, and churn risk factors for a B2C app idea.
<!-- version: 0.1.0 | outputs: memory/ideas/<slug>/retention.json -->

Skill: retention-predictor

Purpose

Retention determines LTV. An app that churns users in week 1 can't build a business regardless of acquisition. This skill evaluates how sticky the idea is structurally — not based on feature lists, but on the underlying usage pattern and habit formation potential.

Input

  • Idea slug
  • App concept description
  • memory/ideas/<slug>/desire_scores.json (desire strength informs habit potential)
  • memory/ideas/<slug>/user_extraction.json (usage frequency from pain map)

Evaluation Factors

FactorHigh Retention SignalLow Retention Signal
Usage frequencyDaily or multiple times/dayWeekly or less
External triggerClear real-world trigger (meal, workout, payday)No natural trigger
Progress/reward loopClear progress visible over timeNo feedback loop
Network effectsGets better with more usersNo network component
Data lock-inUser data accumulatesNothing to lose by leaving
Habit stackFits into existing daily routineRequires behavior change

Process

<!-- TODO: Add D1/D7/D30 retention benchmark database by app category -->
<!-- TODO: Add churn risk scoring rubric -->
  1. Estimate natural usage frequency based on the problem (daily tooth brushing vs. annual tax filing).
  2. Identify external triggers that would cue app usage.
  3. Score habit formation potential (1–5) across the six factors above.
  4. Estimate D1, D7, D30 retention benchmarks for the app category.
  5. Flag high churn risk factors.

Output

Write to memory/ideas/<slug>/retention.json:

json
{
  "natural_usage_frequency": "multiple daily | daily | weekly | monthly | infrequent",
  "external_trigger": "",
  "habit_formation_score": 0,
  "churn_risk_factors": [],
  "estimated_retention": {
    "d1": 0,
    "d7": 0,
    "d30": 0
  },
  "churn_risk": "low | medium | high",
  "retention_verdict": "sticky | moderate | disposable"
}

Notes

<!-- TODO: Cross-reference with desire_scores — survival/control desires = higher retention -->

© MaxKmet, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/retention-predictor of MaxKmet/idea-validation-agents.

Open the folder on GitHubat commit 3a4c800

Compare with similar skills

Retention Predictor next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Retention Predictor compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Retention Predictor this skillMaxKmet/idea-validation-agents477—~577Automated safety check: PassMIT
Customer Deck Builderzapier/gtm-cheat-codes342—~1.1kAutomated safety check: PassMIT
Cs Health Scorecardmohitagw15856/pm-claude-skills1.4k—~2.4kAutomated safety check: PassMIT
Youtube SearchZeroPointRepo/youtube-skills1k1 repos~1.8kAutomated safety check: PassMIT
YtZeroPointRepo/youtube-skills1k1 repos~951Automated safety check: PassMIT
Loki Modedavila7/claude-code-templates32k7 repos~7.1kAutomated safety check: WarnMIT

Similar skills

  • Customer Deck Builder

    zapier/gtm-cheat-codes

    Official

    Builds a tailored sales or customer success deck from approved CRM context and generates it in Gamma through Zapier MCP for calls like QBRs or renewals.

    342 GitHub stars~1.1k tokensUpdated 2 mo ago
    Sales & SupportAuto-check passed
  • Cs Health Scorecard

    mohitagw15856/pm-claude-skills

    Build a customer health scorecard for a specific account. An agent skill from mohitagw15856/pm-claude-skills.

    1.4k GitHub stars~2.4k tokensUpdated yesterday
    Sales & SupportAuto-check passed
  • Youtube Search

    ZeroPointRepo/youtube-skills

    A skill your agent uses when the user wants to find YouTube content on any topic: searching for videos or channels, finding creators who cover a subject, discovering tutorials, talks, or expert…

    1k GitHub starsUsed in 1 repo~1.8k tokens
    Sales & SupportAuto-check passed
  • Yt

    ZeroPointRepo/youtube-skills

    A skill your agent uses when YouTube is relevant: pasted video links or IDs, @handles, quick video lookups, summaries, channel latest uploads, topic search, or any request involving YouTube content…

    1k GitHub starsUsed in 1 repo~951 tokens
    Sales & SupportAuto-check passed
  • Loki Mode

    davila7/claude-code-templates

    Multi-agent autonomous startup system for Claude Code. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 7 repos~7.1k tokens
    Sales & SupportAuto-check: warnings
  • Account Research

    explorium-ai/gtm-skills

    Account research skill for Claude Code and Codex: generate a high-signal company intelligence brief including firmographics, technographics, funding history, hiring signals, business events, recent…

    175 GitHub stars~2.8k tokensUpdated yesterday
    Sales & SupportAuto-check passed

More from MaxKmet/idea-validation-agents

All 15 skills in this repo
  • Cac Modeler

    MaxKmet/idea-validation-agents

    Models LTV, CAC by channel, LTV:CAC ratios, and payback period for an indie developer.

    477 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Competitor Mapper

    MaxKmet/idea-validation-agents

    Maps the full competitive landscape — direct, indirect, substitute, and emerging competitors — with positioning gap analysis, review mining, and marketinsights-calibrated saturation scoring.

    477 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Decision Memo

    MaxKmet/idea-validation-agents

    Writes a concise, human-readable decision brief summarizing the full validation analysis — including score, verdict, RAT experiment, pre-mortem, and tier-appropriate next actions.

    477 GitHub stars~2k tokensUpdated 3 mo ago
    Auto-check passed
  • Desire Evaluator

    MaxKmet/idea-validation-agents

    Scores the strength of core human desire motivations (survival, status, belonging, control, curiosity) for a given app idea to predict user pull and retention potential.

    477 GitHub stars~551 tokensUpdated 3 mo ago
    Auto-check passed
  • Distribution Analysis

    MaxKmet/idea-validation-agents

    Evaluates organic reach potential, paid feasibility, platform distribution advantages, creator economy fit, and founder edge for a B2C app idea.

    477 GitHub stars~3.1k tokensUpdated 3 mo ago
    Auto-check passed
  • Idea Scoring

    MaxKmet/idea-validation-agents

    Aggregates all dimension scores into a final idea score (0–100) and issues a verdict.

    477 GitHub stars~3.2k tokensUpdated 3 mo ago
    Auto-check passed

Questions about Retention Predictor

What does Retention Predictor do?

Predicts retention potential by evaluating usage frequency, habit formation mechanics, and churn risk factors for a B2C app idea. Retention Predictor is an agent skill from MaxKmet/idea-validation-agents. Predicts retention potential by evaluating usage frequency, habit formation mechanics, and churn risk factors for a B2C app idea.

When should I use Retention Predictor?

Retention Predictor fits situations like: tasks that involve Customer success.

How do I install Retention Predictor in Claude Code?

Run `npx skills add MaxKmet/idea-validation-agents --skill retention-predictor -a claude-code`. Or copy the skill folder (skills/retention-predictor in MaxKmet/idea-validation-agents) into .claude/skills/retention-predictor in your project. Claude Code loads it when a task matches its description.

How do I install Retention Predictor in Codex?

Run `npx skills add MaxKmet/idea-validation-agents --skill retention-predictor -a codex`. Or copy the skill folder (skills/retention-predictor in MaxKmet/idea-validation-agents) into .agents/skills/retention-predictor in your project. Codex loads it when a task matches its description.

Can I use Retention Predictor in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add MaxKmet/idea-validation-agents --skill retention-predictor -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/retention-predictor, .gemini/skills/retention-predictor, .github/skills/retention-predictor and .opencode/skills/retention-predictor in your project.

What does Retention Predictor need to run?

SKILL.md names no scripts, command-line tools or credentials: Retention Predictor is instructions for the agent only.

Does Retention Predictor access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Retention Predictor safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Retention Predictor use?

Retention Predictor is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Retention Predictor use?

About 577 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Retention Predictor?

Skills that share tags, products or a category with Retention Predictor: Customer Deck Builder (zapier/gtm-cheat-codes, 342 stars), Cs Health Scorecard (mohitagw15856/pm-claude-skills, 1.4k stars), Youtube Search (ZeroPointRepo/youtube-skills, 1k stars) and Yt (ZeroPointRepo/youtube-skills, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Retention Predictor?

MaxKmet (a GitHub user) maintains it in MaxKmet/idea-validation-agents, which has 477 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on June 16, 2026.

Source: MaxKmet/idea-validation-agents on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.