CtrlK
BlogDocsLog inGet started
Tessl Logo

onboarding-wizard-design

Designing first-run product onboarding wizards that get users to the ah-ha moment without overwhelming them. Step architecture, progressive disclosure, escape hatches, completion incentives, drop-off measurement. Honest about tutorial-overload (dump everything upfront), skip-friendly-empty (skipped onboarding leads to abandoned product), and earned-progressive-disclosure (right things at the right moments) patterns. Triggers on onboarding wizard, product onboarding, first-run experience, signup flow, activation flow, FRX, time-to-value, ah-ha moment design. Also triggers when activation rates are low, when users skip onboarding and never return, when onboarding flows are being scoped for the first time, or when audience research shows users not finding key features.

58

Quality

67%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/onboarding-wizard-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 what the skill does, when to use it, and includes rich trigger terms spanning both keyword-based and scenario-based triggers. The description is specific about its techniques and patterns, making it highly distinguishable from adjacent skills. The only minor note is its length, but the content is substantive rather than padded.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions and concepts: step architecture, progressive disclosure, escape hatches, completion incentives, drop-off measurement. Also names specific patterns like tutorial-overload, skip-friendly-empty, and earned-progressive-disclosure.

3 / 3

Completeness

Clearly answers both 'what' (designing first-run onboarding wizards with specific techniques) and 'when' (explicit trigger terms and situational triggers like low activation rates, users skipping onboarding, scoping onboarding flows for the first time).

3 / 3

Trigger Term Quality

Excellent coverage of natural terms users would say: 'onboarding wizard', 'product onboarding', 'first-run experience', 'signup flow', 'activation flow', 'FRX', 'time-to-value', 'ah-ha moment'. Also includes scenario-based triggers like 'activation rates are low' and 'users skip onboarding and never return'.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive niche focused specifically on first-run product onboarding wizards. The specific terminology (FRX, ah-ha moment, activation flow) and named patterns make it very unlikely to conflict with other skills like general UX design or broader product design 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 has strong domain coverage and a clear conceptual framework for onboarding wizard design, with well-organized sections and useful failure-mode diagnostics. However, it is significantly too verbose — repeating key concepts multiple times, explaining things Claude already knows, and including audience/scope definitions that waste tokens. The actionability is moderate: it provides patterns and frameworks but lacks concrete deliverable templates or example outputs that would make Claude's task unambiguous.

Suggestions

Cut the opening narrative paragraphs, the 'what this skill covers' scope section, the audience definition, and the closing section — these repeat information or explain things Claude already knows. This alone would reduce the file by ~40%.

Add a concrete example output: show what a completed wizard design deliverable looks like (e.g., a sample 5-step wizard spec for a hypothetical SaaS product with step copy, ah-ha moment identification, skip behavior, and instrumentation plan).

Move detailed pattern descriptions (progressive disclosure patterns, skip/resume mechanics, user-type variations) into the referenced files and keep only 1-2 sentence summaries in the main skill, since these sections duplicate what the references should contain.

Add an explicit workflow sequence for how Claude should approach a wizard design request: e.g., 1) Identify ah-ha moment → 2) Validate wizard vs contextual help decision → 3) Draft step architecture → 4) Define skip/resume mechanics → 5) Specify instrumentation → 6) Review against 12-consideration checklist.

DimensionReasoningScore

Conciseness

Extremely verbose for a skill file. The opening paragraphs explain concepts Claude already understands (what onboarding wizards are, why they fail), the closing section restates everything already covered, and there is significant repetition across sections (the tutorial-overload/skip-friendly-empty/earned-progressive-disclosure framing is explained at least three times). The 'what this skill covers' section with scope distinctions and audience definitions is unnecessary context for Claude. This could be cut by 50-60% without losing actionable content.

1 / 3

Actionability

The skill provides structured frameworks (12 considerations, step patterns, skip patterns) and diagnostic guidance for failure modes, which is reasonably concrete for a design/strategy skill. However, it lacks specific examples of actual wizard implementations, concrete deliverable templates, or sample outputs Claude should produce. The guidance stays at the pattern-description level rather than providing copy-paste-ready artifacts like wireframe specs, step copy templates, or measurement dashboards.

2 / 3

Workflow Clarity

The 12-consideration framework provides a clear checklist, and the failure modes section offers diagnostic sequences. However, there is no explicit workflow for how Claude should approach a wizard design task end-to-end — no 'first do X, then validate Y, then produce Z' sequence. The step architecture section describes patterns but doesn't sequence the design process itself. Missing validation checkpoints for the design process (e.g., validate ah-ha moment identification before proceeding to step architecture).

2 / 3

Progressive Disclosure

References to 9 external files are well-organized and clearly signaled at both inline points and in a consolidated reference section. However, no bundle files were provided, so the references are unverifiable. The main file itself is monolithic and overly long — much of the inline content (e.g., detailed skip patterns, progressive disclosure patterns, user-type variations) could have been moved to the reference files, with only summaries retained in the main skill.

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.

Validation10 / 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
rampstackco/claude-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.