CtrlK
BlogDocsLog inGet started
Tessl Logo

ui-ux-pro-max

This skill should be used when the user asks to design or review a UI, create a landing page or dashboard, choose colors or typography, improve accessibility, or implement polished frontend interfaces with a clear design system.

63

Quality

75%

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/ui-ux-pro-max/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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, lean instructional skill body with concrete executable commands and a clearly sequenced workflow. The two real weaknesses are the missing feedback/validation guidance in the workflow and a dangling bundle reference (`data/ui-reasoning.csv` is cited and loaded by `search.py` but absent), which also breaks every documented command at runtime.

Suggestions

Fix the dangling reference: ship `data/ui-reasoning.csv` in the bundle or remove it from the References section — as written, every `search.py` invocation in the skill fails at `load_rules`.

Consolidate the two near-duplicate `--persist` examples in step 2, and show a short sample of the script's output so the step-5 synthesis has a concrete input to work from.

Add error-recovery guidance to the workflow, e.g. what to do when a domain/stack search returns no matches (fall back to `--design-system` output, ask the user, or proceed with defaults).

DimensionReasoningScore

Conciseness

The body is efficient — no explanations of concepts Claude already knows, and domains/stacks are given as terse enumerations. Minor trims exist: the two `--persist` example commands near-duplicate each other, and the Role/"not a replacement" framing slightly restates the opening. This fits "efficient; minor instances of over-explanation that could be trimmed" rather than the lean-every-token-earns-its-place 5.

4 / 5

Actionability

Guidance is concrete and mostly executable: full `python3 .../search.py` invocations with literal example queries ("glassmorphism dark", "real-time dashboard") and verified flags. It falls short of fully copy-paste-ready because step 2's primary command uses placeholder arguments ("<product_type> <industry> <keywords>", "Project Name") and no sample output of the script is shown, leaving minor gaps per the 4 anchor.

4 / 5

Workflow Clarity

A clear five-step numbered sequence with the concrete command at each step, plus an explicit fallback default ("If the user does not specify a stack, default to `html-tailwind`") and a post-gathering synthesis step. However, there are no validation checkpoints or error-recovery loops (e.g., what to do if a search returns nothing), which caps it at the 4 anchor rather than 5. The operations are non-destructive lookups, so the destructive-operation cap at 3 does not apply.

4 / 5

Progressive Disclosure

The structure is good — a short overview with a References section signaling what to load when, and one-level-deep references — but scored against the actual bundle, the referenced `data/ui-reasoning.csv` does not exist in the bundle (only `references/USAGE.md` and `scripts/search.py` are present, and `search.py` loads that CSV at runtime), so a advertised reference is dangling. This places it at the 3 anchor: structure present with real organization gaps, below the 4 anchor's "references mostly clear" with only minor issues.

3 / 5

Total

15

/

20

Passed

Description

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

A strong description: it uses an explicit "should be used when" trigger clause with concrete, natural trigger phrases, and it enumerates specific capabilities rather than vague claims. The main gaps are a few missing natural trigger variations and an only-implied statement of what the skill actually produces.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — "design or review a UI, create a landing page or dashboard, choose colors or typography, improve accessibility, or implement polished frontend interfaces" — covering the skill's full scope. It matches the top anchor ("multiple specific concrete actions; comprehensive coverage") and not the 4 anchor, which is reserved for coverage with minor gaps.

5 / 5

Completeness

The "when" is explicit and strong ("This skill should be used when the user asks to...") with concrete trigger phrases, while the "what" is implicit — derivable from the enumerated actions (design, review, choose colors/typography, implement) rather than stated as what the skill produces (a design system plus implementation guidance). Both are present but the what could be more explicit, matching the 4 anchor rather than the 5.

4 / 5

Trigger Term Quality

Natural phrases users would say are well covered ("design or review a UI", "create a landing page or dashboard", "choose colors or typography", "improve accessibility"), but a few common variations are missing (e.g. "design system", "redesign", "make my site look professional", "mockup/wireframe"). Good coverage with a few natural terms missing fits the 4 anchor; it falls short of the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The UI-design niche is mostly distinct, but triggers like "create a landing page or dashboard" and "choose colors" overlap with visualization/design-adjacent skills, so there is minor overlap risk with closely related skills — the 4 anchor. It is not the 5 anchor's "clear niche with minimal conflict risk" given the dashboard/colors territory is contested.

4 / 5

Total

17

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
Galaxy-Dawn/claude-scholar
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.