When the user wants to create or optimize in-app paywalls, upgrade screens, upsell modals, or feature gates. Also use when the user mentions "paywall," "upgrade screen," "upgrade modal," "upsell," "feature gate," "convert free to paid," "freemium conversion," "trial expiration screen," "limit reached screen," "plan upgrade prompt," or "in-app pricing." Distinct from public pricing pages (see page-cro) — this skill focuses on in-product upgrade moments where the user has already experienced value.
77
Quality
72%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./config/claude/skills/paywall-upgrade-cro/SKILL.mdQuality
Discovery
72%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This description excels at trigger terms and distinctiveness, with comprehensive keywords and explicit differentiation from related skills. However, it's weak on specificity - it tells Claude when to use the skill but not what concrete actions it enables (e.g., writing copy, designing layouts, optimizing CTAs). The description reads more like a trigger list than a capability description.
Suggestions
Add specific actions the skill performs, e.g., 'Creates compelling upgrade copy, designs conversion-focused modal layouts, optimizes CTA placement and messaging'
Restructure to lead with capabilities before the trigger list: 'Designs and optimizes in-app paywalls, upgrade screens, and upsell modals to maximize freemium conversion. Use when...'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (in-app paywalls, upgrade screens) and lists types of screens (upsell modals, feature gates), but doesn't describe concrete actions like 'design', 'write copy for', 'optimize conversion rates', or 'A/B test'. | 2 / 3 |
Completeness | Strong 'when' clause with explicit triggers, but the 'what' is weak - it says 'create or optimize' but doesn't specify what actions or outputs the skill provides. The description focuses heavily on triggers without explaining capabilities. | 2 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'paywall', 'upgrade screen', 'upsell', 'feature gate', 'convert free to paid', 'freemium conversion', 'trial expiration screen', 'limit reached screen', 'plan upgrade prompt', 'in-app pricing'. | 3 / 3 |
Distinctiveness Conflict Risk | Explicitly distinguishes itself from 'page-cro' for public pricing pages and clearly defines its niche as 'in-product upgrade moments where the user has already experienced value' - very clear boundary. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid, actionable skill with excellent concrete examples of paywall templates and clear guidance on timing and components. The main weaknesses are minor verbosity in the opening and a lack of explicit validation/testing workflows before deploying paywalls. The structure and progressive disclosure are well-executed.
Suggestions
Remove the 'You are an expert...' framing sentence - Claude doesn't need role-play setup in skills
Add a validation workflow section with explicit steps: implement → test with sample users → measure metrics → iterate
Consider trimming obvious anti-patterns (e.g., 'hiding the close button' is self-evident) to improve conciseness
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Content is reasonably efficient but includes some unnecessary framing ('You are an expert...') and could be tighter in places. The component lists and anti-patterns sections are well-structured but some bullet points state obvious concepts. | 2 / 3 |
Actionability | Provides concrete, copy-paste ready paywall templates with specific copy examples, clear component structures, and specific metrics to track. The feature lock, usage limit, and trial expiration paywall examples are immediately usable. | 3 / 3 |
Workflow Clarity | Covers when to show paywalls and the upgrade flow sequence, but lacks explicit validation checkpoints. No feedback loops for testing if paywalls are working or steps to verify implementation before launch. | 2 / 3 |
Progressive Disclosure | Well-organized with clear sections, appropriate length for an overview skill, and properly signals external references (experiments.md, related skills). Content is appropriately structured without deep nesting. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
355d067
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.