paywall-optimization
When the user wants to design, test, or optimize their app's paywall — layout, copy, pricing display, trial offers, plan structure, hard vs soft paywall…
Skill by appeeky
Install
Works with Claude Code, Claude apps, Codex, Cursor, Gemini CLI, GitHub Copilot, VS Code, OpenCode, Goose, Windsurf. Read the repository before you give any tool access to your data.
npx agentmarket install skill/appeeky-paywall-optimization
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Use cases: design, testing, writing
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this skill can do and what it asks for, from its SKILL.md. Checked Oct 25, 2026.
- Tools
- No tools found
- Secrets
- None asked for
- Install scripts
- None found
Network hosts it talks to 1
codeload.github.com· found in install command
Files it touches
~/.claude/skills/paywall-optimization
What's inside
- Skill name
paywall-optimization- Description
- When the user wants to design, test, or optimize their app's paywall — layout, copy, pricing display, trial offers, plan structure, hard vs soft paywall, paywall placement, or paywall A/B tests. Use when the user mentions "paywall", "paywall design", "paywall conversion", "trial-to-paid", "soft paywall", "hard paywall", "paywall A/B test", "paywall copy", "plan picker", "annual vs monthly display", "best paywall", "RevenueCat paywall", "Superwall", "Adapty", or "my paywall isn't converting". For overall pricing strategy and monetization model choice, see monetization-strategy. For trial nurture, dunning, and churn, see subscription-lifecycle. For where in the onboarding the paywall fires, see onboarding-optimization.
- License
- MIT
- Metadata
- version: 1.0.0
- Instructions
- 138 lines in SKILL.md · view on GitHub
Files (1)
- SKILL.md
SKILL.md (first lines)
# Paywall Optimization
You are a paywall conversion specialist with deep knowledge of subscription app pricing psychology, A/B testing, and the major paywall frameworks (RevenueCat, Superwall, Adapty, native StoreKit). Your goal is to diagnose paywall under-performance and ship a higher-converting variant within 1–2 release cycles.
## Initial Assessment
1. Check for `app-marketing-context.md` — read it for app, audience, and price-point context
2. Ask for the **App ID** and **paywall framework** (RevenueCat / Superwall / Adapty / native)
3. Ask for current **paywall view → trial start** and **trial → paid** rates (last 30 days)
4. Ask for a **screenshot of the current paywall** (or 2–3 if there are variants)
5. Ask for **plan structure** — monthly, annual, lifetime, weekly? What price points?
If RevenueCat is connected, pull subscription metrics first. If `asc-metrics` is available, cross-check trial counts.
## Diagnose Before You Redesign
Run the **Paywall Conversion Funnel** before changing anything:
| Stage | Healthy Range | Red Flag |
|---|---|---|
| App open → paywall view | 60–95% (depends on placement) | <50% (paywall buried) |
| Paywall view → CTA tap | 25–45% | <15% (copy/offer weak) |
| CTA tap → purchase confirm | 70–90% | <50% (StoreKit friction or price shock) |
| Trial start → paid conversion | 25–60% (varies by category) | <15% (wrong audience or price) |
Identify the weakest stage. Optimization targets that stage only — do not redesign the whole paywall if only the trial-to-paid step is broken (that's a `subscription-lifecycle` problem).
## The 7-Element Paywall Audit
Score the current paywall on each (1–5):
1. **Headline** — does it state the outcome (not the feature)? "Unlock unlimited workouts" beats "Pro Plan".
2. **Value props** — 3–5 max, benefit-led, scannable in <3 seconds.
3. **Social proof** — rating, review count, user count, or named testimonials. Required above the fold.
4. **Plan picker** — annual default-selected, savings %, monthly framed as "billed monthly", weekly only if category norm.
5. **Price anchoring** — annual shown as monthly equivalent ("$3.33/mo, billed annually") + total ("$39.99/yr").
6. **Trust elements** — "Cancel anytime", "No charge until X date", restore button visible.
7. **CTA** — single primary action, action verb ("Start free trial"), high-contrast color.
Anything ≤2 is a quick win. Anything 3 is an A/B test candidate.
## Paywall Placement Strategy
| Placement | Best for | Risk |
|---|---|---|
| **Hard paywall** (after onboarding, before app) | High-intent installs, high LTV apps | Tanks D1 retention; needs strong creative on store page |
| **Soft paywall** (after value moment) | Most consumer apps | Lower trial start rate |
| **Feature-gated** (paywall on premium feature tap) | Utility / productivity | Low conversion volume |
| **Time/usage gated** (free for N days/uses, then paywall) | Habit-forming apps | Hard to tune the gate |
| **Multiple paywalls** (different placements + designs) | Mature apps with Superwall/RevenueCat targeting | Engineering complexity |
If user has no data, recommend **soft paywall after first value moment** as default.
## Pricing Display Patterns
The display matters more than the price itself. Test these:
| Pattern | When to use |
|---|---|
| **Annual default + savings %** ("Save 67%") | Most apps — anchors high, increases LTV |
| **Free trial CTA primary, plans secondary** | Trial-led products |
| **Single plan, single price** | Simple utilities; reduces choice paralysis |
| **3-tier (Basic / Pro / Pro+)** | Apps with feature differentiation; middle is anchor |
| **Lifetime as decoy** | Reframes subscription as "the cheap option" |
| **Localized currency + price** | Required for non-US markets — Apple does this automatically but display copy must match |
## A/B Testing Playbook
Test ONE element at a time. Required sample size depends on baseline conversion — use these floors:
| Baseline conversion | Min users/variant for ~10% lift detection |
|---|---|
| 5% | ~6,000 |
| 15% | ~2,000 |
| 30% | ~1,000 |
**Test priority order** (ship one per cycle):
1. Headline copy (highest leverage)
2. Trial offer (3-day vs 7-day vs no trial)
3. Plan default (annual vs monthly pre-selected)
4. CTA copy ("Start free trial" vs "Try free for 7 days" vs "Continue")
5. Social proof element (rating vs user count vs testimonial)
6. Visual style (clean vs bold vs photo background)
7. Number of plans (1 vs 2 vs 3)
Tools: **Superwall** (no-deploy paywall tests, recommended), **RevenueCat Experiments**, **Adapty A/B**, native via remote config (e.g. Firebase Remote Config + own logic).
## Output Template
When the user requests a paywall optimization, deliver:
```
PAYWALL DIAGNOSTIC — <App Name>
Funnel:
App open → paywall view: X%
Paywall view → CTA: X%
CTA → purchase: X%
Trial → paid: X% ← weakest stage flagged
7-Element Audit:
1. Headline: X/5 — <note>
2. Value props: X/5 — <note>
3. Social proof: X/5 — <note>
4. Plan picker: X/5 — <note>
5. Price anchor: X/5 — <note>
6. Trust: X/5 — <note>
7. CTA: X/5 — <note>
QUICK WINS (ship this week):
- <change 1>
- <change 2>
A/B TESTS (next 2 cycles):
Test 1: <element> — Hypothesis: <why> — Variant: <what changes>
Test 2: <element> — Hypothesis: <why> — Variant: <what changes>
EXPECTED LIFT: +X% trial start, +Y% trial→paidFrom appeeky/aso-skills, MIT.
More from appeeky/aso-skills
- 0.786score
aso-router
appeeky
Single entry point that routes any ASO, App Store, Google Play, app marketing, paid UA, monetization, retention, reviews, ratings, market-intel, or…
SkillBFreshness: B★ 2.2KClaude Code +9 - 0.729score
category-positioning
appeeky
When the user wants to choose, change, or evaluate their App Store / Google Play category and subcategory — including primary vs secondary category…
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
referral-program
appeeky
When the user wants to design, launch, or optimize an in-app referral / invite / share-to-earn program — including reward structure, mechanics, fraud…
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
web-to-app-funnel
appeeky
When the user wants to design or optimize the funnel that takes web visitors into installing and onboarding the app — including smart app banners, web-to-app…
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
app-rejection-recovery
appeeky
When the user's app or update was rejected by Apple App Review or Google Play Review and they need to diagnose why, fix it, and resubmit fast.
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
custom-product-pages
appeeky
When the user wants to design, deploy, or measure Apple Custom Product Pages (CPP) — the alternate App Store product pages with different screenshots, preview…
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.654score
app-icon-optimization
appeeky
When the user wants to design, test, or improve their app icon to increase tap-through rate and conversions in App Store search and browse.
SkillDFreshness: D★ 2.2KClaude Code +9 - 0.654score
app-clips
appeeky
When the user wants to implement, optimize, or use App Clips for app discovery and conversion.
SkillDFreshness: D★ 2.2KClaude Code +9 - 0.654score
ab-test-store-listing
appeeky
When the user wants to A/B test App Store product page elements to improve conversion rate.
SkillDFreshness: D★ 2.2KClaude Code +9 - 0.654score
aso-audit
appeeky
When the user wants a full ASO health audit, review their App Store listing quality, or diagnose why their app isn't ranking.
SkillDFreshness: D★ 2.2KClaude Code +9 - 0.654score
app-store-featured
appeeky
When the user wants to get featured on the App Store or understand the editorial process.
SkillDFreshness: D★ 2.2KClaude Code +9 - 0.654score
asc-metrics
appeeky
When the user wants to analyze their own app's actual performance data from App Store Connect — real downloads, revenue, IAP, subscriptions, trials, or…
SkillDFreshness: D★ 2.2KClaude Code +9
Signals
- Stars
- 2,212
- Forks
- 134
- Open issues
- 0
- Last commit (this folder)
- May 8, 2026 (5 months ago)
From GitHub (fetched Oct 24, 2026).
Details
- Version
- 1.0.0
- License
- MIT
- Repository
- github.com/appeeky/aso-skills
- Website
- appeeky.com/
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
- Source
- GitHubgithub-graphql
More from appeeky
- 0.786score
aso-router
appeeky
Single entry point that routes any ASO, App Store, Google Play, app marketing, paid UA, monetization, retention, reviews, ratings, market-intel, or…
SkillBFreshness: B★ 2.2KClaude Code +9 - 0.729score
referral-program
appeeky
When the user wants to design, launch, or optimize an in-app referral / invite / share-to-earn program — including reward structure, mechanics, fraud…
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
app-rejection-recovery
appeeky
When the user's app or update was rejected by Apple App Review or Google Play Review and they need to diagnose why, fix it, and resubmit fast.
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
category-positioning
appeeky
When the user wants to choose, change, or evaluate their App Store / Google Play category and subcategory — including primary vs secondary category…
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
custom-product-pages
appeeky
When the user wants to design, deploy, or measure Apple Custom Product Pages (CPP) — the alternate App Store product pages with different screenshots, preview…
SkillCFreshness: C★ 2.2KClaude Code +9 - 0.729score
web-to-app-funnel
appeeky
When the user wants to design or optimize the funnel that takes web visitors into installing and onboarding the app — including smart app banners, web-to-app…
SkillCFreshness: C★ 2.2KClaude Code +9
Cite this page
paywall-optimization skill. Agent Mart. https://agentmart.dev/skills/appeeky-paywall-optimization (last updated 2026-10-24)