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.
59
49%
Does it follow best practices?
Impact
Pending
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 significantly lacks specificity about what the skill actually does — it never describes the concrete actions or optimizations it performs, which is a notable gap. Adding a brief 'what it does' clause would elevate this from good to excellent.
Suggestions
Add a leading clause describing concrete actions, e.g., 'Analyzes and optimizes non-signup forms by reducing field count, improving field labels, adding smart defaults, and minimizing friction to increase completion rates.'
Reframe the opening to start with capabilities before the 'Use when...' trigger guidance, so Claude understands both what the skill does and when to apply it.
| 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 describes when to use it, not what it actually does (e.g., 'reduces form fields', 'adds progressive disclosure', 'optimizes field order'). | 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 never states what actions or optimizations the skill actually performs, only when it should be selected. | 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 (directing to signup-flow-cro) and popup forms (directing to popup-cro), making it very unlikely to conflict with related 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 is comprehensive in coverage but severely over-engineered for a SKILL.md file. It reads more like a complete textbook on form optimization than a concise skill instruction, with much of the content being standard UX knowledge Claude already possesses. The lack of progressive disclosure means all ~350 lines load into context every time, and the content would benefit greatly from being split into a concise overview with references to detailed sub-files.
Suggestions
Reduce the main SKILL.md to ~80-100 lines covering core principles, the assessment workflow, and output format, then move field-by-field optimization, form type-specific guidance, and experiment ideas into separate referenced files (e.g., FIELD-OPTIMIZATION.md, FORM-TYPES.md, EXPERIMENTS.md).
Remove content Claude already knows (basic UX principles like 'error messages should be specific,' 'single column is mobile-friendly,' 'use inline validation') and focus only on domain-specific insights or non-obvious recommendations.
Add an explicit end-to-end workflow with numbered steps: assess current form → identify issues → prioritize fixes → generate recommendations → define A/B tests, with clear validation checkpoints between stages.
Include a concrete output template or example (e.g., a sample form audit for a demo request form) so Claude knows exactly what the deliverable should look like.
| Dimension | Reasoning | Score |
|---|---|---|
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' are standard UX principles that don't need to be spelled out at this length. | 1 / 3 |
Actionability | Provides concrete guidance like specific field recommendations, button copy examples, and measurement metrics, but lacks executable code or implementation snippets. The advice is specific enough to act on (e.g., '44px minimum height') but is mostly descriptive best practices rather than copy-paste ready implementations or templates. | 2 / 3 |
Workflow Clarity | The 'Initial Assessment' section provides a clear starting sequence, and the 'Output Format' section defines deliverables. However, there's no explicit end-to-end workflow tying assessment → recommendations → testing together with validation checkpoints. The process is implied but not explicitly sequenced with feedback loops. | 2 / 3 |
Progressive Disclosure | This is a monolithic wall of text with no references to external files for detailed content. The experiment ideas, field-by-field optimization, and form type-specific guidance could easily be split into separate reference files. Everything is inlined in one massive document, making it hard to navigate and consuming excessive context window. | 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 | |
2c6f6e8
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.