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.

60

Quality

70%

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

72%

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 well-organized, token-efficient overview that correctly defers detail to a real one-level-deep reference file. Its main weakness is actionability — the body itself contains no executable code or examples, and the workflow lacks an explicit validation checkpoint despite a verify-before-fix theme.

Suggestions

Add one small executable code snippet to the body (e.g. a minimal :root definition and var() usage) so the core action is copy-paste-ready before readers open the reference.

Make the workflow's validation explicit by adding a step such as 'After replacing, verify the rendered layout across breakpoints and interaction states before finalizing', turning the implicit checkpoint into a real feedback loop.

DimensionReasoningScore

Conciseness

The body is lean: a one-line problem statement plus short Quick Reference bullets and terse Check/Fix/Explain/Code Review imperatives, with details deferred to references/rule.md. It assumes Claude's competence and does not pad with concepts Claude already knows, matching the 'every token earns its place' anchor.

3 / 3

Actionability

The Check/Fix/Explain sections give clear direction ('Find hard-coded color values... that should be replaced', 'Extract repeated and meaningful values into CSS custom properties on :root and replace all usages with var()'), but there is no executable code or copy-paste-ready example in the body — those live only in the reference — so it stops at 'some concrete guidance but incomplete'.

2 / 3

Workflow Clarity

The sections imply a sequence (Check → Fix → Explain → Code Review) and the description mandates verifying rendered layout across breakpoints before proposing a fix, but the body itself lists steps without an explicit validation checkpoint or feedback loop tying the verify-before-fix instruction into the workflow, so checkpoints are only implicit.

2 / 3

Progressive Disclosure

The body is a concise overview with a single, clearly signaled one-level-deep reference ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'), and the referenced file exists and holds the detailed material; content is appropriately split and easy to navigate, matching the 3-anchor example.

3 / 3

Total

10

/

12

Passed

Description

67%

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...' trigger and answers both what and when, but its capability list is narrow and the verbatim rule title embedded mid-sentence reads awkwardly and crowds out natural trigger terms. Tightening the phrasing and adding user-natural keywords like 'CSS variables' and 'design tokens' would lift specificity and trigger quality.

Suggestions

Reword the embedded rule title into natural phrasing, e.g. 'related to CSS custom properties (CSS variables) used as design tokens' instead of 'related to Use CSS custom properties for design tokens'.

Add common natural trigger terms users would actually say, such as 'CSS variables', 'design tokens', 'theming', or 'dark mode'.

List a couple more concrete actions (e.g. 'extract hard-coded values into variables, verify theming across breakpoints') to reach full specificity.

DimensionReasoningScore

Specificity

It names a domain (stylesheets, component styles, responsive behavior) and a concrete action ('Check the rendered layout across breakpoints and interaction states before proposing a fix'), but the capability list is narrow and the awkward embedded rule title ('related to Use CSS custom properties for design tokens') is not a described action, so it does not reach the 'multiple specific concrete actions' level of 3.

2 / 3

Completeness

It explicitly answers both 'what' (review stylesheets/component styles/responsive behavior, check rendered layout across breakpoints and interaction states before proposing a fix) and 'when' via an explicit 'Use when...' clause, matching the 3-anchor example with an explicit trigger.

3 / 3

Trigger Term Quality

It opens with a natural trigger ('Use when reviewing stylesheets, component styles, and responsive behavior') a user might say, and mentions 'breakpoints' and 'interaction states', but it is missing common natural variations a user would actually say (e.g. 'CSS variables', 'design tokens', 'theming', 'dark mode'), and the literal rule-title phrasing is not a natural keyword.

2 / 3

Distinctiveness Conflict Risk

It is scoped to CSS custom properties / design tokens, which gives it a niche, but the leading framing ('reviewing stylesheets, component styles, and responsive behavior') is broad enough to overlap with other general CSS/review skills, so it could still trigger for similar skills rather than being a clearly distinct niche.

2 / 3

Total

9

/

12

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.

Validation15 / 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.