CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

38

Quality

37%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/paywall-upgrade-cro/SKILL.md

The canonical home for this skill is paywall-upgrade-cro in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

38%Scale 1-5

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

This skill is a comprehensive but excessively verbose reference document that reads more like a textbook on paywall CRO than an actionable skill for Claude. Its main strengths are the concrete paywall copy templates and the thorough coverage of experiment ideas, but these are buried in hundreds of lines of strategic advice and UX principles that Claude already understands. The content would benefit enormously from aggressive trimming and splitting into separate reference files.

Suggestions

Cut the content by at least 60% — remove sections explaining concepts Claude already knows (Core Principles, Anti-Patterns, basic UX advice) and focus on the unique, actionable templates and output format.

Split the massive 'Experiment Ideas' section into a separate EXPERIMENTS.md reference file, and move 'Common Patterns by Business Model' into a PATTERNS.md file, keeping only brief summaries with links in the main SKILL.md.

Add a clear numbered workflow: 1) Gather context (assessment questions), 2) Identify paywall type, 3) Draft paywall copy using templates, 4) Define metrics plan, 5) Propose A/B tests — with explicit validation steps between stages.

Make the output format more concrete with a complete example showing a filled-in paywall design deliverable rather than just listing the fields.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~500+ lines, extensively covering concepts Claude already understands (what a paywall is, what dark patterns are, basic UX principles). Many sections like 'Anti-Patterns to Avoid' and 'Core Principles' explain things Claude inherently knows. The massive 'Experiment Ideas' section alone is hundreds of lines of brainstorming that could be drastically condensed.

2 / 5

Actionability

The skill provides wireframe-style copy templates for different paywall types which are somewhat actionable, but there's no executable code, no specific implementation guidance, and much of the content is high-level strategic advice rather than concrete steps. The templates are useful but are more like suggestions than copy-paste ready outputs.

3 / 5

Workflow Clarity

There's a rough workflow implied (Initial Assessment → Design → Test → Measure) and the Output Format section defines deliverables, but there's no explicit sequenced process with validation checkpoints. The 'Initial Assessment' section provides good discovery questions, but the path from assessment to deliverable is not clearly sequenced.

3 / 5

Progressive Disclosure

Everything is crammed into a single massive file with no bundle files to offload content. The enormous 'Experiment Ideas' section, the 'Common Patterns by Business Model' section, and the detailed paywall templates would all benefit from being in separate referenced files. The content is structured with headers but the sheer volume makes navigation difficult.

2 / 5

Total

10

/

20

Passed

Description

36%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 uses second-person voice ('Your goal is to') and reads more like a persona prompt than a skill description, which undermines its utility for skill selection. It identifies a clear domain (paywalls and upgrade flows) but lacks concrete actions, explicit trigger guidance, and natural keyword coverage. The absence of a 'Use when...' clause and specific deliverables significantly limits Claude's ability to select this skill appropriately.

Suggestions

Add an explicit 'Use when...' clause with trigger terms like 'paywall', 'subscription', 'upsell', 'freemium conversion', 'upgrade prompt', 'pricing page', or 'monetization'.

Replace the goal-oriented language with concrete actions such as 'Designs paywall screens, writes upgrade copy, plans conversion triggers, structures tiered pricing displays'.

Rewrite in third person voice (e.g., 'Designs in-app paywalls and upgrade flows to convert free users...') instead of second person ('Your goal is to').

DimensionReasoningScore

Specificity

Names the domain (in-app paywalls and upgrade flows) but the actions are vague — 'convert free users to paid' and 'upgrade users to higher tiers' are goals rather than concrete actions like 'design paywall screens' or 'write upgrade copy'. No specific deliverables or techniques are mentioned.

2 / 5

Completeness

Has a vague 'what' (convert/upgrade users) but no explicit 'when' clause. The phrase 'at moments when they've experienced enough value' describes a design philosophy rather than telling Claude when to select this skill. No 'Use when...' guidance is provided.

2 / 5

Trigger Term Quality

Includes some relevant keywords like 'paywalls', 'upgrade flows', 'free users', 'paid', and 'higher tiers', but misses natural user phrases like 'subscription', 'pricing page', 'freemium', 'monetization', 'conversion rate', 'upsell', or 'paygate'.

3 / 5

Distinctiveness Conflict Risk

The paywall/upgrade flow domain is somewhat specific, but the description could overlap with general UX writing skills, marketing copy skills, or pricing strategy skills. The lack of concrete deliverables makes it harder to distinguish from adjacent skills.

3 / 5

Total

10

/

20

Passed

Validation

81%

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

Validation9 / 11 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

9

/

11

Passed

Repository
administrakt0r/AI-Agents-Safe-Coding-Skills
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.