CtrlK
BlogDocsLog inGet started
Tessl Logo

search-input

Use when reviewing templates, rendered HTML, or shared components related to Make search inputs accessible. Validate the final browser-facing markup, not just the source framework abstraction.

62

Quality

74%

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 ./skills/search-input/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 compact, well-structured rule skill: the body works as a genuine overview with concrete attribute-level checks and a correctly signaled one-level-deep reference file. Its main weaknesses are mild redundancy between the intro, 'Explain', and 'Check'/'Fix' sections, and two accessibility requirements that are named in the Quick Reference but never given any implementation detail in the body.

Suggestions

Deduplicate the body: the opening sentence and the 'Explain' section repeat the same sentence about search being a primary navigation method — merge them or cut one.

Add one line of implementation guidance (or a snippet link) for the two under-specified Quick Reference items — keyboard-navigable autocomplete suggestions and announcing result counts to screen readers (e.g., an aria-live region pattern) — since references/rule.md is the only place they are detailed.

Differentiate the 'Code Review' section from the frontmatter description by adding what to flag (exact elements, attributes, routes are mentioned, but tie them to the Check criteria) instead of restating the skill's scope.

DimensionReasoningScore

Conciseness

The body is lean (~45 lines) with short sections like 'Quick Reference' and 'Check' that name specific attributes (type='search', role='search') without explaining basics Claude already knows. Minor redundancy remains: the intro sentence is repeated verbatim in the 'Explain' section, and 'Check'/'Fix' restate the Quick Reference bullets, keeping it below the 'every token earns its place' anchor.

4 / 5

Actionability

Concrete, attribute-level instructions are given for the main checks ("Use type='search' and role='search' on the form", "visible or aria-label"), and full executable code is one level deep in references/rule.md. Two items ('Make autocomplete suggestions keyboard navigable', 'Announce result counts to screen readers') are named without any implementation detail in the body, which are minor gaps rather than missing key steps.

4 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections form a clear, coherent sequence for a simple single-purpose rule skill, and no destructive/batch validation is required so no feedback loop cap applies. It sits below the top anchor because the sections are not explicitly linked as a sequence and 'Code Review' partially repeats the description's scope rather than adding a distinct step.

4 / 5

Progressive Disclosure

The body is a concise overview and the single detail reference (`references/rule.md`) is clearly signaled at the end ("For full implementation details, code examples, and framework-specific guidance, see references/rule.md"), is exactly one level deep, and the file exists with the promised code examples. Content is appropriately split between the 45-line overview and the 405-line rule file, matching the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

17

/

20

Passed

Description

70%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 solid description with an explicit 'Use when...' trigger clause, decent natural trigger terms, and a distinctive niche around validating rendered search markup rather than framework abstractions. Its weaknesses are thin capability coverage (only review/validate actions are stated, and awkwardly — "related to Make search inputs accessible") and missing common accessibility vocabulary such as 'screen reader', 'ARIA', or 'a11y'.

Suggestions

State the concrete capabilities instead of one validation stance, e.g., "Checks rendered search markup for type='search', role='search', accessible labels, and keyboard-navigable autocomplete, and flags violations with fixes."

Fix the awkward phrasing "related to Make search inputs accessible" — use "related to making search inputs accessible" or simply "search input accessibility".

Add natural trigger synonyms users would actually say: "accessibility", "a11y", "screen reader", "ARIA", or "search form", to improve both trigger quality and distinctiveness from generic component-review skills.

DimensionReasoningScore

Specificity

The description names the domain (search input accessibility in rendered markup) and 1-2 concrete actions — "reviewing templates, rendered HTML, or shared components" and "Validate the final browser-facing markup" — but the actions are generic review/validate verbs rather than a list of specific capabilities, matching the 'names domain and 1-2 concrete actions, but not comprehensive' anchor. It is not a 4 because it never enumerates what the skill actually does (check, fix, explain, code review of specific attributes).

3 / 5

Completeness

Both what and when are present: an explicit "Use when reviewing templates, rendered HTML, or shared components..." trigger clause, and a what in "Validate the final browser-facing markup, not just the source framework abstraction". It is not a 5 because the 'what' is a single validation stance rather than concrete statements of the skill's capabilities, and the 'when' clause is scoped to code-review contexts only.

4 / 5

Trigger Term Quality

Good keyword coverage with natural terms users would say when needing this skill: "templates", "rendered HTML", "shared components", "search inputs", "accessible". It falls short of the top anchor because common variations are missing — "accessibility", "a11y", "screen reader", "ARIA", and "search form" — which a user would plausibly say when asking for this check.

4 / 5

Distinctiveness Conflict Risk

The niche is mostly distinct — search input accessibility validated in final rendered markup — with natural triggers unlikely to hijack unrelated skills. Minor overlap risk remains with closely related HTML accessibility rules from the same family (e.g., form labels, landmark roles), which share trigger vocabulary like 'rendered HTML' and 'accessible', matching the 'mostly distinct; minor overlap risk with closely related skills' anchor.

4 / 5

Total

15

/

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

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.