CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

paywall-upgrade-cro

You are an expert in in-app paywalls and upgrade flows. Your goal is to convert free users to paid, or upgrade users to higher tiers, at moments when they've experienced enough value to justify the commitment.

Quality

55%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

42%Weight 40%Scale 1-5

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

The body is well-organized and covers the domain thoroughly, with useful wireframe templates and a concrete output specification. However, it is a monolithic 575-line file whose bulk is generic best-practice and experiment-idea lists Claude could generate itself, with placeholder-only examples and no explicit step-by-step workflow tying assessment to deliverables.

Suggestions

Move the Experiment Ideas, Common Patterns by Business Model, and Mobile Paywall Patterns sections into reference files (e.g., references/experiments.md, references/business-models.md) and keep SKILL.md as a lean overview that links to them.

Replace placeholder wireframes with at least one fully worked example containing real copy, and supply actual benchmark numbers in the Metrics Plan instead of deferring them.

Add an explicit step-by-step workflow (1. Establish context via the assessment questions, 2. Select trigger points, 3. Produce paywall designs per Output Format, 4. Define metrics plan) so the sequence from assessment to deliverable is unambiguous.

Trim generic best-practice bullets that restate common knowledge (e.g., checkout basics like 'Minimal fields', 'Multiple payment methods') to reduce token cost.

DimensionReasoningScore

Conciseness

The ~575-line body is dominated by generic CRO best-practice bullets Claude already knows ('Minimal fields', 'Multiple payment methods', 'Clear pricing display') plus a ~150-line Experiment Ideas brainstorm list. Padding is the majority of the file rather than incidental, matching the 'noticeably verbose; several padded sections' anchor.

2 / 5

Actionability

The wireframe templates and the Output Format section are concrete deliverable definitions, but the wireframes are placeholder skeletons ('[Specific capability]', '$X/mo') with no worked example of real copy, and no actual benchmark numbers despite the Metrics Plan promising 'expected benchmarks'. Skeleton-level guidance with missing key details.

3 / 5

Workflow Clarity

A sequence exists implicitly (Initial Assessment → ask the listed questions if needed → design paywalls → deliver per Output Format → metrics plan), but it is never explicitly sequenced as a process and there are no validation or verification checkpoints. The sequence is present but checkpoints are implicit.

3 / 5

Progressive Disclosure

No bundle files exist; everything is inlined in a 575-line SKILL.md. Section headers and navigation are well organized (better than the anchor-2 'minimal structure' case), but content that clearly belongs in separate reference files — Experiment Ideas (~150 lines), business-model patterns, mobile patterns — is inlined, matching the 'some structure but content that should be separate is inline' anchor.

3 / 5

Total

11

/

20

Passed

Description

48%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description establishes a clear niche (in-app paywall and upgrade conversion) but is written as a second-person persona statement rather than a third-person capability description with usage triggers. It lacks a 'Use when...' clause and concrete action verbs, and misses common trigger synonyms like subscription, upsell, and free trial.

Suggestions

Rewrite in third person with concrete actions, e.g.: 'Designs in-app paywalls and upgrade flows: paywall copy, trigger timing, upgrade checkout flows, and A/B test plans. Use when optimizing paywalls, upsells, subscription conversion, free-trial expiration, or free-to-paid conversion.'

Add an explicit trigger clause covering natural variations users would say: paywall, upgrade screen, upsell, subscription conversion, monetization, trial expiration.

Replace the persona framing ('You are an expert...') with a direct statement of what the skill produces (paywall designs with copy, upgrade flows, metrics plans).

DimensionReasoningScore

Specificity

The description names the domain ('in-app paywalls and upgrade flows') and the conversion goal, but describes a persona rather than concrete actions the skill performs (no 'designs paywall screens', 'writes upgrade copy', 'plans A/B tests'). The second-person voice ('You are an expert', 'Your goal is') incurs the mandated 1-point penalty from a base of 3.

2 / 5

Completeness

The 'what' is moderately clear (paywall/upgrade conversion expertise), but there is no 'Use when...' clause or equivalent trigger guidance — the phrase 'at moments when they've experienced enough value' describes paywall timing, not when to invoke the skill. Missing trigger guidance caps this at 3.

3 / 5

Trigger Term Quality

Natural terms like 'paywalls', 'upgrade flows', 'convert free users to paid', and 'tiers' are present, but common variations users would actually say are missing — 'subscription', 'upsell', 'free trial', 'monetization', 'pricing screen'. This matches the anchor for some relevant keywords missing common synonyms.

3 / 5

Distinctiveness Conflict Risk

The in-app paywall/upgrade niche is fairly distinct with specific triggers, though it risks minor overlap with the closely related CRO skills the body itself lists (page-cro for pricing pages, onboarding-cro) and with general conversion-optimization skills. Mostly distinct with minor overlap risk.

4 / 5

Total

12

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (577 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

skills/paywall-upgrade-cro/SKILL.md

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.