CtrlK
BlogDocsLog inGet started
Tessl Logo

form-cro

When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," or "contact form." For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro.

62

Quality

53%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./config/claude/skills/form-cro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.

This description excels at defining when to use the skill, with outstanding trigger terms and explicit boundary conditions that distinguish it from related skills. Its main weakness is the near-complete absence of concrete capability descriptions — it tells Claude when to select it but not what it actually does (e.g., analyze field count, suggest multi-step layouts, recommend field removal). Adding specific actions would significantly improve it.

Suggestions

Add concrete actions the skill performs, e.g., 'Analyzes form fields for friction, recommends field reduction, suggests multi-step layouts, and optimizes CTAs to improve completion rates.'

Reframe the opening to lead with capabilities before the trigger conditions, e.g., 'Optimizes non-signup forms by reducing friction, restructuring fields, and improving conversion rates. Use when...'

DimensionReasoningScore

Specificity

The description names the domain (form optimization) and lists form types (lead capture, contact, demo request, application, survey, checkout), but it doesn't describe concrete actions the skill performs — it only says when to use it, not what it actually does (e.g., 'reduces form fields,' 'improves completion rates,' 'restructures multi-step flows').

2 / 3

Completeness

The 'when' is exceptionally well-defined with explicit triggers and boundary conditions (referencing related skills for signup and popup forms). However, the 'what does this do' is weak — it says 'optimize' but never specifies what concrete actions or outputs the skill produces.

2 / 3

Trigger Term Quality

Excellent coverage of natural trigger terms users would say: 'form optimization,' 'lead form conversions,' 'form friction,' 'form fields,' 'form completion rate,' 'contact form,' plus specific form types like 'lead capture forms,' 'demo request forms,' 'checkout forms.'

3 / 3

Distinctiveness Conflict Risk

Very clearly distinguished from related skills with explicit boundary statements ('For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro'), and the scope is well-defined to non-signup form optimization.

3 / 3

Total

10

/

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 is comprehensive in coverage but severely over-long, repeating general UX knowledge Claude already possesses. It provides useful structure (output format, form type guidance, experiment ideas) but would benefit enormously from aggressive trimming to focus only on non-obvious insights and decision frameworks. The experiment ideas section largely duplicates earlier recommendations, and many sections explain basics that don't need restating.

Suggestions

Cut the document by 50-60% by removing general UX knowledge Claude already knows (inline validation basics, error message best practices, mobile touch targets) and keeping only non-obvious insights like the field-count-to-completion-rate percentages and the progressive commitment pattern.

Move the experiment ideas, form type-specific guidance, and field-by-field optimization into separate referenced files to improve progressive disclosure and reduce the main skill's token footprint.

Add a clear numbered workflow connecting the phases: 1) Read context → 2) Assess current form → 3) Identify top issues → 4) Validate recommendations against business requirements → 5) Deliver structured output.

Add concrete implementation examples (HTML form snippets, analytics tracking code for field-level drop-off) to increase actionability beyond descriptive guidance.

DimensionReasoningScore

Conciseness

Extremely verbose at ~350+ lines. Much of the content is general UX/form design knowledge Claude already knows (e.g., what inline validation is, that single column is mobile-friendly, that error messages should be specific). Sections like 'Error Handling,' 'Mobile Optimization,' and 'Visual Design' explain basic concepts that don't need restating. The experiment ideas section largely restates recommendations already given earlier in the document.

1 / 3

Actionability

Provides specific recommendations (e.g., 44px touch targets, field count impact percentages, button copy examples) and a structured output format, but lacks executable code or implementation snippets. Guidance is concrete in places (good/bad label examples) but mostly descriptive rather than directly implementable — no HTML/CSS snippets, no analytics tracking code, no validation code examples.

2 / 3

Workflow Clarity

The Initial Assessment section provides a clear sequence for gathering information, and the Output Format section defines deliverables. However, there's no explicit workflow connecting assessment → analysis → recommendations → testing with validation checkpoints. The overall process is implicit rather than explicitly sequenced, and there are no verification steps to confirm recommendations are sound before delivery.

2 / 3

Progressive Disclosure

References related skills at the bottom (signup-flow-cro, popup-cro, etc.) which is good navigation. However, the document itself is monolithic — the experiment ideas section, form type-specific guidance, and field-by-field optimization could all be split into separate reference files. Everything is inline in one massive document rather than appropriately distributed.

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
freekmurze/dotfiles
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.