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.

47

Quality

49%

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 ./config/claude/skills/form-cro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

27%

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

This skill reads more like a comprehensive form optimization textbook than a concise, actionable skill file. While it covers the topic thoroughly with good examples (button copy, error messages, field recommendations), it is far too verbose — much of the content covers UX fundamentals Claude already knows. The lack of bundle files means all content is crammed into a single monolithic document, and the absence of explicit validation checkpoints weakens the workflow.

Suggestions

Cut the content by 50-60%: remove explanations of basic UX concepts (touch targets, inline validation, error handling patterns) and focus only on form-CRO-specific decision frameworks and non-obvious recommendations.

Extract the 'Experiment Ideas' section, 'Form Types: Specific Guidance' section, and 'Field-by-Field Optimization' section into separate bundle files (e.g., EXPERIMENTS.md, FORM-TYPES.md, FIELD-GUIDE.md) with clear references from the main skill.

Add an explicit workflow with validation checkpoints: e.g., 'Step 1: Audit current form → Step 2: Confirm field necessity with stakeholder → Step 3: Draft recommendations → Step 4: Validate against business requirements → Step 5: Propose A/B tests.'

Remove duplicate content — the experiment ideas section largely restates the recommendations already covered in earlier sections, adding token cost without new information.

DimensionReasoningScore

Conciseness

The skill is extremely verbose at ~350+ lines, with significant content Claude already knows (what inline validation is, how error messages work, basic UX principles like '44px touch targets'). Sections like 'Error Handling' and 'Visual Design' explain fundamental web design concepts. The experiment ideas section largely restates recommendations already made earlier in the document.

1 / 3

Actionability

The skill provides concrete guidance like specific button copy examples, field-by-field recommendations, and structured output formats. However, it lacks executable code, specific implementation snippets, or copy-paste ready solutions — it's mostly descriptive best practices and general rules of thumb rather than precise, executable instructions.

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 validation or feedback loop — no step to verify recommendations against data, no checkpoint to confirm field necessity with stakeholders before finalizing, and the overall flow from assessment to recommendation to testing is implicit rather than explicitly sequenced.

2 / 3

Progressive Disclosure

This is a monolithic wall of text with no bundle files to offload detailed content. The experiment ideas, form type-specific guidance, and field-by-field optimization sections could each be separate reference files. Related skills are mentioned at the end but the skill itself has no internal progressive disclosure structure — everything is dumped into one massive document.

1 / 3

Total

6

/

12

Passed

Description

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 and distinguishing it from related skills, with strong trigger terms and clear boundary conditions. Its main weakness is the absence of concrete capability descriptions — it never explains what the skill actually does (e.g., analyze form fields, recommend field reductions, improve conversion copy). Adding specific actions would significantly improve its utility for skill selection.

Suggestions

Add concrete actions describing what the skill does, e.g., 'Analyzes form structure, recommends field reductions, optimizes form copy, and improves completion rates for non-signup forms.'

Reframe the opening to lead with capabilities before the 'Use when' clause, e.g., 'Optimizes form layout, reduces friction, and improves conversion rates for lead capture, contact, demo request, application, survey, and checkout forms. 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,' 'analyzes form friction').

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' — what the skill actually does — is largely missing. It tells Claude when to select it but not what actions or outputs it provides.

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

Highly distinctive with explicit boundary-setting: it clearly excludes signup/registration forms (pointing to signup-flow-cro) and popup forms (pointing to popup-cro), making it very unlikely to conflict with related skills.

3 / 3

Total

10

/

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.