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
49%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./config/claude/skills/form-cro/SKILL.mdQuality
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. However, it critically lacks any description of what the skill actually does — no concrete actions, outputs, or capabilities are mentioned. Adding a 'what it does' clause would significantly improve it.
Suggestions
Add a leading sentence describing concrete actions the skill performs, e.g., 'Analyzes and optimizes non-signup forms to reduce friction, improve completion rates, and increase conversions by recommending field reduction, layout changes, and progressive disclosure techniques.'
Reframe the description to lead with capabilities before the 'Use when...' clause, following the pattern: '[What it does]. Use when [triggers].'
| Dimension | Reasoning | Score |
|---|---|---|
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 does this do' is essentially missing — it never states what actions or outputs the skill provides, only when to invoke it. | 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.'), making it highly unlikely to conflict with adjacent skills. | 3 / 3 |
Total | 10 / 12 Passed |
Implementation
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 and provides useful frameworks (output format, experiment ideas, field-by-field guidance), it is far too verbose — explaining many concepts Claude already understands — and fails to leverage progressive disclosure by keeping everything in a single massive file. The lack of executable code or concrete templates limits its actionability.
Suggestions
Cut the content by 50-60%: remove explanations of basic UX concepts (inline validation, touch targets, error handling patterns) that Claude already knows, and focus only on form-CRO-specific decision frameworks and non-obvious recommendations.
Split into multiple files: move 'Experiment Ideas' to EXPERIMENTS.md, 'Form Types: Specific Guidance' to FORM-TYPES.md, and 'Field-by-Field Optimization' to FIELD-GUIDE.md, with clear one-level references from the main SKILL.md.
Add a concrete, copy-paste-ready template for the audit output format — e.g., a markdown table or structured example showing a completed form audit with real field names, issues, and fixes.
Add an explicit workflow with validation checkpoints: e.g., 'After identifying removable fields, verify each against compliance requirements and downstream data usage before recommending removal.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is extremely verbose at ~400+ 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. Much of this could be condensed to a fraction of its size. | 1 / 3 |
Actionability | The skill provides specific recommendations (e.g., button copy examples, field-by-field guidance, specific metrics to track) and a structured output format, but lacks executable code, concrete implementation snippets, or copy-paste ready templates. It's more of a consulting framework than executable guidance. | 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 like 'verify recommendations against business constraints' or 'check that removed fields aren't legally required before finalizing.' 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 references to supporting files despite its massive length. Sections like the detailed experiment ideas, form type-specific guidance, and field-by-field optimization could easily be split into separate reference files. The related skills section at the end is good but doesn't compensate for the lack of content organization across files. | 1 / 3 |
Total | 6 / 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
3974caa
Table of Contents
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.