CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

theming

Visual customization and branding for Luzmo surfaces. Use for custom colors, white-labeling, dark/light modes, and per-tenant themes. Triggers on: "change colors", "brand styling", "dark mode", "white-label", "custom theme", "IQ Chat styling", "ACK theming". Routes to the correct mechanism per surface: Theme API for dashboards, CSS variables for IQ Answer, IQChatOptions for IQ Chat, Flex runtime theme. Not for chart data or slots (use data-visualization) or data security (use multitenancy).

73

Quality

92%

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

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 well-structured routing skill: every claim is product-specific and non-obvious, the security checkpoint and mistake entries provide genuine validation and error-recovery structure, and reference files carry the bulk detail appropriately. The main weaknesses are repetition of the consult-docs and no-theme-prop warnings, a few placeholder-valued examples, and one orphaned bundle file.

Suggestions

Add references/lucero-tokens.md to the Bundled References section (or link it from the ACK section) — it exists in the bundle but is currently unreachable from SKILL.md.

State the 'consult component docs before claiming CSS variable names or theming props' rule once (e.g., in Doc Retrieval or Important Facts) instead of repeating it in sections 3, 4, 5, Important Facts, and Avoid.

Replace the '"#..."' placeholder and '{...}' stub bodies in the IQ Chat contrast and Theme API/token-override examples with concrete values so all code examples are copy-paste ready.

DimensionReasoningScore

Conciseness

The body is dense with product-specific, non-inferable facts (which Flex keys are silently ignored, built-in theme IDs, dark-container requirement) with no generic concept explanations, matching 'efficient; minor instances of over-explanation that could be trimmed'. It does not reach 5 because the 'consult docs before claiming names/props' rule is stated five separate times (sections 3–5, Important Facts, Avoid) and the standalone-Flex no-`theme`-prop warning is repeated in five places (security checkpoint, section 2, section 6, Common Mistakes, Avoid) — intentional emphasis, but trimmable.

4 / 5

Actionability

The Flex theming example is copy-paste ready with validated keys and comments, and every mechanism section carries exact doc URLs to fetch — 'mostly executable guidance; concrete code or commands with minor gaps'. It falls short of 5 because the IQ Chat contrast example uses a '"#..."' placeholder, the Theme-API/token-override examples use '{...}' stub bodies, and the IQ Answer/ACK sections provide no concrete props or variables at all (only doc pointers).

4 / 5

Workflow Clarity

The routing workflow is unambiguous: a surface→mechanism table, then one section per surface, each with its doc URLs. There is an explicit validation checkpoint — the security checklist with 'If ANY checkbox is unchecked, STOP and fix before proceeding' — and error-recovery feedback via Common Mistakes entries giving symptom → why → fix, plus a 'use troubleshooting FIRST' hand-off. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'; no destructive/batch cap applies.

5 / 5

Progressive Disclosure

Good structure: the overview routes by surface, inlines only the highest-value pitfall details, and defers bulk key tables to a clearly signaled 'Bundled References' section with one-line descriptions of each file; references are one level deep. It does not reach 5 because the bundle file references/lucero-tokens.md exists but is never listed or linked anywhere in the body — one of four reference files is undiscoverable from SKILL.md, a 'minor organization gap'.

4 / 5

Total

17

/

20

Passed

Description

100%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 is exemplary: it states what it does, when to use it with concrete trigger phrases, routes per surface to the named mechanism, and explicitly excludes adjacent territories handled by sibling skills. Voice is third-person/imperative per convention with no first- or second-person phrasing.

DimensionReasoningScore

Specificity

Multiple concrete mechanisms are named per surface — 'Theme API for dashboards, CSS variables for IQ Answer, IQChatOptions for IQ Chat, Flex runtime theme' — alongside concrete capability nouns ('custom colors, white-labeling, dark/light modes, and per-tenant themes'). This matches the anchor 'lists multiple specific concrete actions; comprehensive coverage' within its domain; it is not the level below because no capability is left at generic 'helps with styling' abstraction.

5 / 5

Completeness

Both questions are answered explicitly: what ('Visual customization and branding for Luzmo surfaces' plus a per-surface mechanism routing map) and when ('Use for custom colors, white-labeling, dark/light modes, and per-tenant themes' plus a concrete 'Triggers on:' phrase list). This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'; the when-clause is explicit, so the cap of 3 for a missing 'Use when' clause does not apply.

5 / 5

Trigger Term Quality

An explicit 'Triggers on:' list gives natural user phrases — 'change colors', 'brand styling', 'dark mode', 'white-label', 'custom theme', 'IQ Chat styling', 'ACK theming' — covering synonyms and product-specific variations, with 'dark/light modes' also in the Use-for clause. This is comprehensive natural-term coverage; it does not fall to 4 because the common phrasings users would actually say are present, not merely 'good coverage with natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The description carves a clear niche (Luzmo visual theming only) and actively disambiguates from sibling skills: 'Not for chart data or slots (use data-visualization) or data security (use multitenancy)'. Triggers include component-specific terms ('IQ Chat styling', 'ACK theming') unlikely to fire for the wrong skill, matching the anchor 'clear niche with distinct triggers; minimal conflict risk'.

5 / 5

Total

20

/

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

luzmo-official/agent-skills

Path

skills/theming/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.