Designing free-to-paid conversion flows for SaaS products. Trigger moments, paywall design, value demonstration, upsell vs downsell, win-back flows, churn prevention. Honest about paywall-everywhere (gates everything aggressively), free-forever-trap (no upgrade path surfaces), and value-triggered-upgrade (paywall surfaces at moments of demonstrated value) patterns. Triggers on upgrade flow, paywall, free-to-paid, freemium conversion, trial conversion, plan upgrade, subscription upgrade, win-back flow, churn prevention. Also triggers when free-to-paid conversion is low, when paywalls are blocking the wrong moments, or when upgrade flows are being scoped for the first time.
58
67%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/upgrade-flow-design/SKILL.mdQuality
Discovery
100%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 an excellent skill description that thoroughly covers specific capabilities, includes rich natural trigger terms, and clearly delineates both what the skill does and when it should be activated. The inclusion of named patterns with brief definitions adds valuable specificity, and the situational triggers ('when free-to-paid conversion is low') go beyond simple keyword matching to capture real user intent.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions and concepts: trigger moments, paywall design, value demonstration, upsell vs downsell, win-back flows, churn prevention. Also names specific patterns (paywall-everywhere, free-forever-trap, value-triggered-upgrade) with clear definitions. | 3 / 3 |
Completeness | Clearly answers both 'what' (designing free-to-paid conversion flows, paywall design, value demonstration, etc.) and 'when' (explicit trigger list plus situational triggers like low conversion rates and first-time scoping). The 'Triggers on...' and 'Also triggers when...' clauses serve as explicit trigger guidance. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'upgrade flow', 'paywall', 'free-to-paid', 'freemium conversion', 'trial conversion', 'plan upgrade', 'subscription upgrade', 'win-back flow', 'churn prevention'. Also includes situational triggers like 'free-to-paid conversion is low' and 'paywalls are blocking the wrong moments'. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a very clear niche around SaaS free-to-paid conversion specifically. The combination of paywall design, freemium conversion, and win-back flows creates a distinct domain unlikely to conflict with general pricing, marketing, or UX skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
35%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill covers upgrade flow design comprehensively with strong conceptual frameworks (the three-pattern taxonomy, trigger-moment design, 12-consideration checklist) and useful diagnostic failure modes. However, it is significantly over-verbose, restating core concepts multiple times across sections, and lacks concrete actionable artifacts like template copy, specific metric thresholds, or output formats. The progressive disclosure structure references many files but duplicates their content inline, defeating the purpose of the split.
Suggestions
Cut the content by 40-50%: remove the closing section (restates everything), trim the intro to 2-3 sentences, eliminate repeated explanations of the three-pattern taxonomy, and move detailed pattern descriptions entirely into reference files rather than duplicating them.
Add concrete, copy-paste-ready artifacts: example paywall modal copy for each trigger type, a template upgrade flow audit document, specific metric thresholds (e.g., 'usage threshold typically 50-80% of power-user volume'), and a sample output format for upgrade flow recommendations.
Add explicit validation checkpoints to the 12-consideration framework: e.g., 'After step 3, validate trigger moments against actual usage data to confirm users at those moments show high intent signals' and 'After step 6, A/B test primary vs downsell paths before full rollout.'
Provide the referenced bundle files or remove the references — currently 9 dead links create false progressive disclosure while the main file carries all the weight.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~300+ lines. It repeatedly restates the same core concepts (value-triggered-upgrade, paywall-everywhere, free-forever-trap) across multiple sections including the intro, the keystone framing section, the framework summary, and the closing. The closing section essentially restates the entire skill. Much of this content is strategic knowledge Claude already possesses about SaaS conversion patterns, and the explanatory framing ('The voice is the senior product marketing director who has watched...') wastes tokens on persona description rather than actionable guidance. | 1 / 3 |
Actionability | The skill provides structured frameworks, named patterns, and diagnostic failure modes which are useful, but lacks concrete executable artifacts. There are no code examples, no template paywall copy to adapt, no specific metrics thresholds (e.g., what constitutes 'N times'), no sample upgrade flow wireframe descriptions, and no concrete output formats. The guidance stays at the strategic/conceptual level rather than providing copy-paste-ready deliverables. | 2 / 3 |
Workflow Clarity | The 12-consideration framework provides a clear checklist for auditing or designing upgrade flows, and the failure modes section offers diagnostic paths. However, there are no explicit validation checkpoints or feedback loops — for example, no step says 'validate trigger moments against actual user data before implementing' or 'test paywall copy with A/B framework before rolling out.' The sequence of work is implied but not explicitly ordered with verification gates. | 2 / 3 |
Progressive Disclosure | The skill references 9 separate reference files with clear descriptions and relative paths, which is good structure. However, no bundle files are provided, so these references are dead links. Additionally, the main SKILL.md contains substantial detail that overlaps with what the reference files presumably cover (e.g., trigger moment details, paywall patterns, win-back patterns are all explained at length in the main file AND referenced to separate files), suggesting the content split is poorly executed — the main file should be leaner with the detail living in references. | 2 / 3 |
Total | 7 / 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 | |
8e70d03
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.