CtrlK
BlogDocsLog inGet started
Tessl Logo

table-headers

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Define proper table headers. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

61

Quality

72%

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/table-headers/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.

The body is a lean, well-structured instruction skill: concrete fix directives, a clear Check/Fix/Explain sequence, and an exemplary one-level-deep pointer to a real reference file that carries the examples and verification detail. The only meaningful improvements are minor — trimming the why-it-matters intro and adding one explicit inline verification step.

DimensionReasoningScore

Conciseness

The body is lean and well-sectioned, with only minor trimmable padding: the intro sentence "Properly defined headers allow screen readers to announce the context for each data cell" recaps accessibility knowledge Claude already has, and Quick Reference bullets like "often the clearest first fix" are mildly hedged filler. This matches anchor 4 (efficient with minor instances of over-explanation) rather than anchor 5's every-token-earns-its-place standard.

4 / 5

Actionability

Concrete, executable directives are present — "Convert header cells to <th> and add the correct scope attribute", "Use <th> for all table headers, not <td>", "Apply scope=\"col\" or scope=\"row\"" — and code absence is not penalized for an instruction-only skill with actionable guidance. Minor gaps (no inline correct-markup example, no col-vs-row selection guidance, deferred to the reference file) keep it at anchor 4 rather than 5.

4 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections give a clear, unambiguous sequence for this simple single-purpose skill, and verification is addressed ("note how to verify the fix with browser accessibility tooling or assistive tech"). It matches anchor 4 (clear sequence, most checkpoints present) rather than 5 because the body lacks an explicit inline validation step such as running an accessibility checker or inspecting the accessibility tree.

4 / 5

Progressive Disclosure

A short, well-organized body with a clearly signaled, one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see references/rule.md" — and the referenced file exists and delivers exactly what is promised (a full code example, why-it-matters, exceptions, and verification steps). This matches anchor 5 and the simple-skill exception for clean structure with well-signaled references.

5 / 5

Total

17

/

20

Passed

Description

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

The description has an explicit Use-when clause and a concrete inspection procedure, but the skill's core capability is buried in an awkward verb-less phrase ("related to Define proper table headers") and the broad boilerplate trigger language creates overlap risk with sibling accessibility skills. It is functional but below the quality of the good examples, which lead with concrete capabilities and natural trigger terms.

Suggestions

State the capability as a leading action, e.g. "Identify and fix missing <th> headers and scope attributes in HTML data tables" instead of the verb-less "patterns related to Define proper table headers".

Add natural trigger terms users would actually say — "data tables", "th elements", "scope attribute", "a11y" — alongside the existing "table headers" and "screen-reader output".

Lead the Use-when clause with the table-header niche rather than the generic "rendered HTML, interactive components, or design-system patterns" boilerplate, so it cannot be confused with sibling accessibility skills sharing that template.

DimensionReasoningScore

Specificity

The description lists several concrete inspection actions ("Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output") but never states the skill's core capability as an action — "patterns related to Define proper table headers" is a verb-less noun phrase. It names the domain and concrete actions yet is not comprehensive, matching anchor 3 rather than 4 because the actual deliverable (identify/fix header markup) is unstated.

3 / 5

Completeness

Both halves are explicit: an explicit "Use when reviewing rendered HTML, interactive components, or design-system patterns related to..." trigger clause plus a stated check-then-inspect procedure for the "what". It falls short of anchor 5 because the trigger phrase "related to Define proper table headers" is awkward rather than a concrete natural phrase, and the "what" never states the outcome; it is above anchor 3 because both what and when are present and reasonably explicit.

4 / 5

Trigger Term Quality

Good natural keyword coverage — "rendered HTML", "table headers", "keyboard behavior", "focus flow", "screen-reader output" — but common variations users would say ("data tables", "th elements", "scope attribute", "a11y") are missing, matching anchor 4 rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

"table headers" names a specific niche, but the broad boilerplate "rendered HTML, interactive components, or design-system patterns" plus the generic inspection procedure would overlap heavily with any sibling accessibility skill sharing the same template, with the differentiator appearing only once in an awkward phrase. This matches anchor 3 (somewhat specific but could still overlap with similar skills) rather than anchor 4's mostly-distinct profile.

3 / 5

Total

14

/

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.