CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

theme

Deep theme system knowledge: createMuiTheme factory, dark/light palette tokens, typography scale, ThemeProvider color-scheme application, and tss-react/mui styling conventions.

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

Quality

Content

75%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 well-structured, concise reference that gives concrete file paths, executable styling conventions, and a clear color-scheme workflow. Its main weaknesses are minor redundancy between the Layout and Core Files sections and a placeholder in the createMuiTheme example.

Suggestions

Merge the Layout tree and Core Files table into a single structure — they list the same four files with overlapping roles.

Show one concrete component override example (from components/) instead of the '/* MUI overrides */' placeholder in the createMuiTheme snippet.

DimensionReasoningScore

Conciseness

The body is lean and assumes Claude's competence (e.g. 'Treat palette.ts / typography.ts as the source of truth... Read them directly rather than hardcoding'), with no explanation of known concepts. Not 5 because the Layout tree and the Core Files table redundantly list the same four files with overlapping role descriptions.

4 / 5

Actionability

Concrete file paths, an executable makeStyles() example, a firm convention ('not @emotion/styled, MUI styled(), Box, or the sx prop'), and a numbered color-scheme flow give mostly executable guidance. Not 5 because the createMuiTheme snippet contains a placeholder ('components: { /* MUI overrides */ }') and the component-override contents are left unspecified.

4 / 5

Workflow Clarity

The 'How a Color Scheme is Applied' section gives a clear 4-step sequence from user preference to ThemeProvider wrapping, and the styling guidance is unambiguous for a single-purpose reference skill. Not 5 because the workflow has no checkpoint (e.g. how to verify a new token is actually consumed), though nothing here is destructive or batch-oriented so the 3-cap does not apply.

4 / 5

Progressive Disclosure

Sections are well-organized and the only cross-reference ('load panel-extension-api skill') is clearly signaled and one level deep, with detail correctly deferred to palette.ts/typography.ts. Not 5 because the Layout tree and Core Files table could be consolidated and the components/ directory contents are described nowhere.

4 / 5

Total

16

/

20

Passed

Description

61%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 clearly communicates the skill's scope with specific MUI/tss-react terminology, but it is a knowledge inventory rather than an action-oriented statement, and it lacks any 'Use when...' trigger guidance, which caps completeness. Adding explicit trigger phrases would substantially improve it.

Suggestions

Add an explicit trigger clause, e.g. 'Use when modifying colors, fonts, dark/light mode, or MUI theme tokens in this repo' — this would lift completeness from 3 to 4-5.

Rewrite the opening 'Deep theme system knowledge:' as concrete actions (e.g. 'Create and modify MUI themes...') to replace the vague capability-noun framing.

Include natural user phrasings such as 'dark mode' and 'colors' alongside the technical terms to broaden trigger coverage.

DimensionReasoningScore

Specificity

Lists concrete items ('createMuiTheme factory', 'dark/light palette tokens', 'tss-react/mui styling conventions') but they are capability nouns framed by the vague 'Deep theme system knowledge' rather than concrete actions, matching anchor 3 (domain named with some concrete actions, not comprehensive). It does not reach 4 because nothing is expressed as an action, and not 2 because the items are specific, not generic.

3 / 5

Completeness

The 'what' is clear (MUI theme factory, palettes, typography, color-scheme application, styling conventions), but there is no 'Use when...' or equivalent trigger clause; the rubric guideline caps completeness at 3 for a missing explicit 'when'. Not 4 because the 'when' is entirely absent, not weakly implied.

3 / 5

Trigger Term Quality

Good keyword coverage ('theme', 'palette', 'color-scheme', 'dark/light', 'typography', 'MUI', 'tss-react') that users would plausibly say, but common variations like 'dark mode' or 'colors' are missing. Not 5 because synonyms and looser natural phrasings are absent; not 3 because coverage goes beyond a single domain keyword.

4 / 5

Distinctiveness Conflict Risk

Naming 'createMuiTheme', 'ThemeProvider', and 'tss-react/mui' carves a clear niche unlikely to trigger a wrong skill, though it could overlap with a broader MUI/styling skill. Not 5 because the opening 'Deep theme system knowledge' is generic and 'typography scale' could collide with a general typography skill.

4 / 5

Total

14

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

lichtblick-suite/lichtblick

Path

.github/skills/theme/SKILL.md

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.