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.

54

Quality

68%

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 ./.gemini/skills/form-cro/SKILL.md

The canonical home for this skill is form-cro in alirezarezvani/claude-skills

SKILL.md
Quality
Evals
Security

Quality

Content

50%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.

The skill's editorial core — thresholds, audit contract, and output standards — is genuinely strong and specific. It is let down by bundle integrity (the referenced playbook and analyzer script do not exist), an unassembled implicit workflow, and a long generic experiment catalog plus duplicated sections that inflate the token budget without adding marginal guidance.

Suggestions

Ship the referenced bundle files: add references/form-cro-playbook.md and scripts/form_field_analyzer.py (or remove both pointers and the Tools table), and define the forms.json input format the analyzer expects.

Replace the section-implied workflow with a short numbered procedure (assess context → run analyzer → audit → recommend design → propose tests) so the sequence and its handoffs are explicit.

Move the ~90-line Experiment Ideas catalog into a reference file (or trim it to the highest-value per form type) and merge Task-Specific Questions into Initial Assessment to eliminate the duplicated questions.

DimensionReasoningScore

Conciseness

The core is tight and high-value — concrete thresholds ("3-5 fields is the working ceiling; 7+ required fields is a high-priority finding"), specific copy examples, and a defined output structure — but there is noticeable slack: the ~90-line Experiment Ideas section is a generic CRO idea catalog ("1-column vs. 2-column field layout," "Button color and size testing") Claude could generate unprompted, and Task-Specific Questions duplicates the Initial Assessment's Current State/Business Context questions almost verbatim (completion rate, fields used in follow-up, compliance, mobile/desktop split), as Output Artifacts partly duplicates Output Format. This sits at anchor 3 (mostly efficient, could be tightened) rather than 2, since there is no concept-explainer padding and the audit guidance earns its tokens.

3 / 5

Actionability

There is genuinely concrete guidance — an exact tool invocation ("python3 scripts/form_field_analyzer.py forms.json"), numeric thresholds, an Issue/Impact/Fix/Priority output contract, and example copy ("Enter a work email" not "Invalid input") — but the one executable command targets scripts/form_field_analyzer.py, which does not exist in the bundle, and the expected forms.json input format is never defined, so the tool-driven half of the workflow cannot actually run. That missing-key-detail state matches anchor 3 (concrete guidance but incomplete) better than anchor 4's 'minor gaps'; it is far above anchor 2's high-level-hints-only.

3 / 5

Workflow Clarity

The intended process is recoverable from section order (read marketing context → assess form type/current state/business context → run analyzer → produce audit → recommended design → test hypotheses) and one explicit sequencing link exists ("Run it on the form definition first; its flags become the seed list for the Form Audit below"), but the sequence is never assembled into an ordered procedure — the reader must infer it from section layout, and there are no checkpoints confirming when to move from audit to design. This is anchor 3 (steps present but implicit, checkpoints missing); the operations are advisory rather than destructive/batch, so the validation cap does not apply, and the single explicit sequencing link keeps it above anchor 2.

3 / 5

Progressive Disclosure

The body correctly gestures at progressive disclosure — "full treatment in references/form-cro-playbook.md" is clearly signaled and one level deep — but that file does not exist in the bundle (no references/ or scripts/ directories), so the pointer is broken, and the large Experiment Ideas catalog is exactly the content that should live in a reference file but is inlined. Anchor 3 fits (structure present, content that should be separate is inline, references problematic); it cannot reach anchor 4's 'most content appropriately placed, references mostly clear' while its two referenced paths are absent from the bundle, and it is clearly above anchor 2's undifferentiated inline wall thanks to its clean sectioning.

3 / 5

Total

12

/

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 well-crafted trigger-focused description with excellent when-guidance, boundary routing, and distinctiveness. Its main weakness is the thin 'what': it never states what the skill concretely does or delivers (field audit, redesign spec, test hypotheses), relying on the single generic verb "optimize."

Suggestions

Add one clause stating the concrete deliverables, e.g. 'Audits form fields and produces a prioritized Issue/Impact/Fix audit, a recommended field set, and A/B test hypotheses.'

Include a couple of additional natural trigger variations such as 'form conversion rate,' 'form abandonment,' or 'increase form submissions.'

DimensionReasoningScore

Specificity

The description enumerates a specific scope ("lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms") but states only one generic action — "optimize any form" — without naming concrete deliverables like the field audit, recommended field set, or A/B test hypotheses the skill actually produces. This matches anchor 3 (domain named with limited concrete actions) better than anchor 4, which expects several specific actions listed; it is clearly above anchor 2's bare single-verb example ("Processes PDF files") because of the rich scope enumeration.

3 / 5

Completeness

Both what ("optimize any form that is NOT signup/registration") and when (explicit "use when the user mentions..." triggers plus routing exclusions) are present. The when-clause is as explicit as anchor 5's example, but the what is a single generic verb without concrete actions, so it falls between anchor 4 (both present, one could be stronger) and anchor 5 (both fully concrete) — the weak 'what' side pulls it to 4.

4 / 5

Trigger Term Quality

Strong natural trigger phrases ("form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," "contact form") plus six named form types, so a user complaining about a form would naturally hit this. A few common variations are missing (e.g., "form conversion rate," "form abandonment," "increase form submissions"), which keeps it at anchor 4 rather than 5's comprehensive-coverage bar; it is well above anchor 3's "some relevant keywords but missing common variations".

4 / 5

Distinctiveness Conflict Risk

Clear niche with explicit de-confliction: "For signup/registration forms, see signup-flow-cro. For popups containing forms, see popup-cro." The NOT-signup/registration boundary and named sibling routing make accidental triggering of the wrong skill very unlikely, exactly matching anchor 5's minimal conflict risk.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

alirezarezvani/claude-skills

Path

.gemini/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.