When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value. Also use when the user mentions "onboarding flow," "activation rate," "user activation," "first-run experience," "empty states," "onboarding checklist," "aha moment," or "new user experience." For signup/registration optimization, see signup-flow-cro. For ongoing email sequences, see email-sequence.
71
64%
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/onboarding-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.
The description excels at trigger term coverage and distinctiveness, with explicit cross-references to related skills that reduce overlap. However, it is notably weak on specifying what the skill actually does — it reads more like a routing rule than a capability description. Adding concrete actions (e.g., 'designs onboarding checklists, optimizes empty states, identifies aha moments') would significantly improve it.
Suggestions
Add concrete actions the skill performs, e.g., 'Designs onboarding checklists, optimizes empty states, identifies aha moments, and reduces time-to-value for new users.'
Restructure to lead with a 'what it does' statement before the 'Use when...' clause, so Claude understands both the capabilities and the triggers.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (post-signup onboarding, user activation) and some general areas like 'first-run experience' and 'time-to-value,' but it does not list specific concrete actions the skill performs (e.g., 'design onboarding checklists, create empty state screens, map aha moments'). It tells you the domain but not what it actually does. | 2 / 3 |
Completeness | The 'when' is very well covered with explicit trigger terms and a clear 'Use when' clause. However, the 'what' is weak — it says when to use the skill but never clearly states what the skill actually does (what actions it performs or what outputs it produces). The description is essentially all trigger guidance with no capability description. | 2 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'onboarding flow,' 'activation rate,' 'user activation,' 'first-run experience,' 'empty states,' 'onboarding checklist,' 'aha moment,' 'new user experience,' and 'time-to-value.' These are all terms a user would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | The description carves out a clear niche (post-signup onboarding/activation) and explicitly differentiates from related skills by referencing 'signup-flow-cro' for registration optimization and 'email-sequence' for ongoing emails. This boundary-setting significantly reduces conflict risk. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-organized reference skill for onboarding CRO that covers the domain comprehensively with good use of tables and structured sections. Its main weaknesses are a lack of truly concrete, actionable examples (e.g., actual copy, specific implementation code, or detailed wireframe descriptions) and some verbosity in explaining concepts that Claude already understands. The workflow could benefit from explicit sequencing with validation steps for conducting an onboarding audit.
Suggestions
Add concrete examples of deliverables—e.g., sample onboarding checklist copy, sample empty state copy, or a complete onboarding audit finding with specific before/after recommendations.
Trim the 'Core Principles' section to a brief list or remove it entirely, as these are well-known UX principles Claude already understands.
Add an explicit step-by-step workflow for conducting an onboarding audit (e.g., 1. Review current flow → 2. Map funnel metrics → 3. Identify drops → 4. Validate findings against activation data → 5. Prioritize recommendations) with validation checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is reasonably well-organized but includes some unnecessary explanation that Claude would already know (e.g., explaining what empty states are, general concepts like 'progress creates motivation'). Several sections could be tightened—the core principles section states obvious UX truisms, and the multi-channel onboarding section is somewhat generic. | 2 / 3 |
Actionability | The skill provides structured frameworks (tables, checklists, patterns) and specific output formats, but lacks truly concrete, executable guidance. Most recommendations are strategic/conceptual rather than copy-paste ready. For example, the empty state section describes what a 'good empty state' has but doesn't provide actual copy examples or wireframe-level specifics. | 2 / 3 |
Workflow Clarity | There's a clear initial assessment flow and the output format section defines deliverables, but the overall workflow for conducting an onboarding audit or designing a flow lacks explicit sequencing with validation checkpoints. The skill reads more like a reference document than a step-by-step process. No feedback loops or verification steps are present. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections, uses tables effectively for scanability, references external files appropriately (references/experiments.md, product-marketing-context.md), and links to related skills. The one external reference is one level deep and clearly signaled. | 3 / 3 |
Total | 9 / 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 | |
05d40bb
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.