CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

60

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./marketing-skill/skills/form-cro/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%Weight 40%Scale 1-5

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

A well-structured advisory skill with concrete thresholds, a working analysis script integrated into the workflow, and a clean one-level reference bundle. The main costs are an oversized generic experiment-idea catalog that pads the token budget and a tool-invocation example that disagrees with the script's actual CLI (HTML input, not JSON).

Suggestions

Move the Experiment Ideas catalog into references/form-cro-playbook.md (or trim to the top 5-8 ideas) — it is generic brainstorming that competes with the context window, and the playbook is the natural home for it.

Fix the tool invocation to match the script's actual CLI ('python3 scripts/form_field_analyzer.py form.html', with '--json' for pipeline output) instead of 'forms.json' as the input argument.

Merge the 'Task-Specific Questions' section into the Initial Assessment, since the two question lists duplicate each other nearly verbatim.

DimensionReasoningScore

Conciseness

Core Principles, Tools, and Output Format are dense and earn their tokens, but roughly 40% of the body (the 'Experiment Ideas' catalog — 'Button color and size testing,' 'Add testimonial near form,' 'Vertical vs. horizontal field alignment') is generic CRO brainstorming Claude could generate unprompted, and 'Task-Specific Questions' repeats the Initial Assessment questions almost verbatim. This matches anchor 3 (mostly efficient but could be tightened) rather than anchor 2, since there is no explanation of known concepts.

3 / 5

Actionability

Concrete, executable guidance dominates: a real tool invocation ('python3 scripts/form_field_analyzer.py forms.json'), numeric thresholds ('3-5 fields is the working ceiling; 7+ required fields is a high-priority finding'), example error copy ('Enter a work email' not 'Invalid input'), and a fully specified output structure. However, the documented invocation mismatches the script itself, whose usage is 'form_field_analyzer.py form.html' (it parses HTML; '--json' is an output flag), so 'forms.json' as input would fail — a minor but real gap that keeps this at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The sequence is clear and ordered: read product-marketing context if present, run the Initial Assessment, then 'Run it on the form definition first; its flags become the seed list for the Form Audit below,' flowing into the defined Output Artifacts. This is an advisory skill with no destructive or batch operations, so no validation cap applies; it sits at anchor 4 (clear sequence, minor gaps) because the ordering between asking the assessment questions and running the analyzer is implicit rather than an explicit numbered workflow.

4 / 5

Progressive Disclosure

The bundle is well structured for its size: one clearly signaled one-level-deep reference ('full treatment in references/form-cro-playbook.md', which exists) and one script that is actually present and wired into the workflow. Most content is appropriately placed in the body; the inlined ~75-line Experiment Ideas catalog is borderline content that could live in the playbook reference, which keeps this at anchor 4 rather than 5.

4 / 5

Total

15

/

20

Passed

Description

73%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit trigger phrases, an enumerated scope of form types, and explicit boundary routing to sibling skills. Its main weakness is that 'what the skill does' is compressed into the single generic verb 'optimize' without naming the concrete outputs (field audit, justified field set, test hypotheses).

Suggestions

Replace the generic 'optimize any form' lead with concrete actions, e.g., 'Audit form fields against friction thresholds, recommend a justified required/optional field set, and generate prioritized A/B test hypotheses' so the 'what' is as explicit as the 'when'.

Add one or two high-frequency natural trigger variants such as 'form conversion rate' or 'web form' to close the small keyword gap.

DimensionReasoningScore

Specificity

The description names the domain precisely and enumerates seven concrete form types ("lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms"), but the only action stated is the generic verb "optimize" — it never says what optimization actually involves (field audit, recommended field sets, A/B hypotheses). This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive) better than anchor 4, which requires several specific actions.

3 / 5

Completeness

Both 'what' and 'when' are explicitly present: "optimize any form that is NOT signup/registration" plus "Also use when the user mentions..." with concrete trigger phrases. The 'when' is excellent, but the 'what' is the single generic action 'optimize' without the concrete deliverables the skill produces, so it sits at anchor 4 rather than the fully concrete anchor 5.

4 / 5

Trigger Term Quality

Six quoted natural trigger phrases ("form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," "contact form") plus the enumerated form types give good keyword coverage a user would naturally say. A few common variants are missing (e.g., "form conversion rate," "web form," "inquiry form"), which keeps it at anchor 4 rather than the comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear niche (non-signup forms) and explicitly disambiguates the two closest sibling skills — "For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro" — matching anchor 5's clear niche with distinct triggers and minimal conflict risk.

5 / 5

Total

16

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

alirezarezvani/claude-skills

Path

marketing-skill/skills/form-cro/SKILL.md

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.