CtrlK
BlogDocsLog inGet started
Tessl Logo

paywall-upgrade-cro

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.

60

Quality

70%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

—

The risk profile of this skill

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/paywall-upgrade-cro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

50%Scale 1-3

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This is a moderately well-structured skill that covers paywall CRO comprehensively but suffers from being more of a knowledge reference than an actionable instruction set. The wireframe templates are a strength, but the skill lacks executable code examples, explicit workflow sequencing with validation steps, and is verbose in areas where Claude already has strong baseline knowledge (dark patterns, general UX principles). It would benefit from being trimmed and restructured into a concise overview with supporting reference files.

Suggestions

Add an explicit step-by-step workflow for creating a paywall (e.g., '1. Identify trigger point → 2. Draft copy using headline formula → 3. Build component → 4. Verify dismiss/frequency logic → 5. Set up A/B test'), with validation checkpoints at each stage.

Replace wireframe pseudocode with actual implementable examples (e.g., a React component for a feature-gate modal, or specific HTML/CSS for a usage-limit paywall) to increase actionability.

Move the A/B testing section, anti-patterns, and timing/frequency rules into separate reference files to reduce the main SKILL.md to a lean overview, and ensure the referenced `references/experiments.md` actually exists in the bundle.

Remove or drastically condense sections that explain concepts Claude already knows well (Core Principles like 'Value Before Ask' and 'Respect the No') — instead, encode these as brief constraints or a checklist.

DimensionReasoningScore

Conciseness

The skill is reasonably organized but includes some unnecessary framing ('You are an expert...'), and several sections like 'Core Principles' and 'Anti-Patterns' cover concepts Claude already understands well. The wireframe-style examples are efficient, but the overall document could be tightened by ~30%.

2 / 3

Actionability

The skill provides wireframe templates for specific paywall types (feature lock, usage limit, trial expiration) which are somewhat actionable, but they're pseudocode/wireframes rather than actual implementable code. The guidance is mostly descriptive ('show what the feature does,' 'clear explanation') rather than providing concrete copy formulas, specific CSS/HTML patterns, or executable examples.

2 / 3

Workflow Clarity

There's a logical flow from assessment → principles → trigger points → components → specific types → testing, but the workflow for actually creating a paywall is implicit rather than explicitly sequenced. There are no validation checkpoints (e.g., 'verify the paywall respects dismiss frequency before shipping') and no feedback loops for iterating on conversion performance.

2 / 3

Progressive Disclosure

The skill references `references/experiments.md` and related skills (page-cro, onboarding-cro, ab-test-setup), showing awareness of progressive disclosure. However, no bundle files exist to support the reference, and the main document is quite long (~180 lines) with content like A/B testing metrics and anti-patterns that could be split into reference files. The inline content is heavy for a SKILL.md overview.

2 / 3

Total

8

/

12

Passed

Description

89%Scale 1-3

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 is a strong description with excellent trigger term coverage and clear boundary-setting against a related skill. Its main weakness is that the 'what' portion could be more specific about the concrete actions performed (e.g., designing layouts, writing persuasive copy, structuring pricing tiers). The explicit differentiation from page-cro is a notable strength for disambiguation.

Suggestions

Add more specific concrete actions beyond 'create or optimize' — e.g., 'design paywall layouts, write upgrade copy, structure feature comparison tables, craft urgency messaging for trial expirations.'

DimensionReasoningScore

Specificity

The description names the domain (in-app paywalls, upgrade screens) and some actions ('create or optimize'), but doesn't list multiple specific concrete actions like designing layouts, writing copy, A/B testing variants, or configuring feature gates.

2 / 3

Completeness

Clearly answers both 'what' (create or optimize in-app paywalls, upgrade screens, upsell modals, feature gates) and 'when' (explicit 'Use when' equivalent at the start plus extensive trigger term list). Also includes a helpful boundary distinction from page-cro.

3 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'paywall,' 'upgrade screen,' 'upgrade modal,' 'upsell,' 'feature gate,' 'convert free to paid,' 'freemium conversion,' 'trial expiration screen,' 'limit reached screen,' 'plan upgrade prompt,' 'in-app pricing.' These are highly natural and comprehensive.

3 / 3

Distinctiveness Conflict Risk

Explicitly distinguishes itself from the public pricing page skill (page-cro) and carves out a clear niche: in-product upgrade moments where the user has already experienced value. The trigger terms are specific enough to avoid conflicts.

3 / 3

Total

11

/

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

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
TheCraigHewitt/seomachine
Reviewed

Table of Contents

Is this your skill?

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.