CtrlK
BlogDocsLog inGet started
Tessl Logo

css-custom-properties

Use when reviewing stylesheets, component styles, and responsive behavior related to Use CSS custom properties for design tokens. Check the rendered layout across breakpoints and interaction states before proposing a fix.

58

Quality

67%

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/css-custom-properties/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

65%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 compact, well-disclosed overview with genuinely actionable Check/Fix guidance and an appropriately split one-level reference file. Its weaknesses are the CSS-basics padding (Quick Reference bullets and a verbatim-duplicated intro paragraph) and an implicit, under-sequenced workflow with no validation checkpoint connecting check to fix.

Suggestions

Delete the Quick Reference bullets and the opening 'Why It Matters' paragraph (both CSS basics and both duplicated in references/rule.md), or reduce them to a single line.

Make the workflow explicit — e.g., number the steps '1. Check: find hard-coded values → 2. Fix: extract to :root and replace with var() → 3. Verify the rendered layout across breakpoints before proposing the change' — and state when the Explain/Code Review sections apply.

Define what counts as a tokenizable value (repeated 2+ times, or semantically meaningful like brand colors and spacing-scale steps) so the Fix step is fully deterministic.

DimensionReasoningScore

Conciseness

The body is short (~30 lines) but includes content Claude already knows: the Quick Reference bullets ("Custom properties cascade and inherit — they can be overridden at any scope", "Use var(--name, fallback) to provide fallback values") are CSS basics, and the opening paragraph duplicates the "Why It Matters" text in references/rule.md verbatim. This is more than 'minor instances of over-explanation' (score 4), but the padding is limited, so it sits at 'mostly efficient but includes some unnecessary explanation'.

3 / 5

Actionability

The Check and Fix sections give concrete, specific instruction: "Find hard-coded color values, spacing values, and font sizes" and "Extract repeated and meaningful values into CSS custom properties on :root and replace all usages with var() references" — actionable without inline code, which per the scoring notes is acceptable for an instruction-only skill. It falls short of score 5 because criteria like what counts as a 'meaningful' value and fallback usage are left implicit, and the executable code examples only live in the reference file.

4 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections imply a sequence, but it is never made explicit, there is no ordering guidance among the four modes, and validation checkpoints are absent (the description's "check the rendered layout across breakpoints... before proposing a fix" step is not operationalized in the body). This matches 'sequence present but checkpoints missing or implicit' rather than the simple-skill exception at 5, since the skill presents four parallel modes rather than one unambiguous action.

3 / 5

Progressive Disclosure

The body is a concise overview that clearly signals a single one-level-deep reference: "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and references/rule.md exists and contains those details without further nested references. Content is appropriately split between the short overview and the detailed rule file, matching the clear-overview anchor.

5 / 5

Total

15

/

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.

The description has a solid explicit trigger clause and good domain-specific keywords, but it stitches a raw rule title into the sentence instead of stating the capability in its own words, weakening both specificity and the 'what' half of completeness. It also misses the common synonym "CSS variables". Overall a serviceable description with notable phrasing problems.

Suggestions

Rewrite the capability in natural third-person language (e.g., "Extract hard-coded colors, spacing, and font sizes into CSS custom properties on :root") instead of embedding the raw rule title 'related to Use CSS custom properties for design tokens'.

Add the common synonym "CSS variables" and the ".css" file extension to the trigger terms to improve keyword coverage.

Lead with the 'what' (define design tokens as custom properties, replace hard-coded values with var() references) and keep the 'Use when...' clause as a separate, explicit sentence.

DimensionReasoningScore

Specificity

The description names the domain ("stylesheets, component styles, and responsive behavior") and a couple of concrete actions ("Check the rendered layout across breakpoints and interaction states before proposing a fix"), but the core capability is obscured by embedding the raw rule title ("related to Use CSS custom properties for design tokens") mid-sentence, so coverage of what the skill actually does is not comprehensive. It fits the 'names domain and 1-2 concrete actions' anchor better than score 4's 'several specific actions', since the token-extraction capability itself is never stated as an action.

3 / 5

Completeness

An explicit 'when' is present ("Use when reviewing stylesheets, component styles, and responsive behavior related to...") and a partial 'what' exists ("Check the rendered layout across breakpoints and interaction states before proposing a fix"), so it clears the score-3 cap concern. It is not score 5 because the primary 'what' — extracting hard-coded values into custom properties — is only conveyed through the awkwardly embedded rule title rather than a clear capability statement.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "reviewing stylesheets", "component styles", "responsive behavior", "CSS custom properties", "design tokens", "breakpoints", "interaction states" are phrases users would naturally say. It falls short of score 5 because the most common synonym "CSS variables" and file extensions like ".css" are missing, and it is not merely 'some relevant keywords' (score 3).

4 / 5

Distinctiveness Conflict Risk

The niche is fairly distinct — "CSS custom properties", "design tokens", and "breakpoints" are specific triggers that would not fire for unrelated skills. Minor overlap risk remains with general CSS/layout review or theming skills, matching 'mostly distinct; minor overlap risk with closely related skills' rather than the clear-niche anchor at 5.

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.