CtrlK
BlogDocsLog inGet started
Tessl Logo

ui-ux-pro-max

UI/UX design intelligence with searchable database

50

Quality

63%

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 ./.opencode/skills/ui-ux-pro-max/SKILL.md
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.

The body is a strong operational manual: fully executable commands, an explicit required workflow with a persistence pattern, deterministic override-resolution rules, and a pre-delivery checklist for validation. Its main weaknesses are a padded Prerequisites section teaching Python installation, an Example Workflow that duplicates the main workflow verbatim, and reference-style rules/checklists inlined in SKILL.md that would fit better as a separate file.

Suggestions

Delete or compress the OS-by-OS Python installation instructions in Prerequisites — Claude already knows how to check for and install Python; a one-line check suffices.

Trim the Example Workflow to only what it adds (a concrete query string and the default-stack decision) instead of re-listing all four steps with repeated commands.

Move 'Common Rules for Professional UI' and the 'Pre-Delivery Checklist' into a reference file (e.g. references/checklist.md) and point to it, keeping SKILL.md lean; much of this content is also retrievable via the script's `ux` domain search.

DimensionReasoningScore

Conciseness

Most of the body is dense, skill-specific value (command reference, domain/stack tables, do/don't rules, checklists) that Claude does not already know. But roughly a fifth of the file could be trimmed: the ~25-line Prerequisites section explains how to install Python per OS, which Claude already knows, and the Example Workflow section re-derives Steps 1-4 and repeats verbatim commands already shown in 'How to Use This Skill'. This matches anchor 3: 'Mostly efficient but includes some unnecessary explanation or could be tightened'. Not 2 because the padding is confined to two sections and the rest earns its tokens; not 4 because the redundant example workflow and OS-specific install instructions are more than 'minor instances'.

3 / 5

Actionability

Every command is copy-paste ready with concrete flags and arguments, e.g. `python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"`, and the script (scripts/search.py) exists in the bundle with matching flags (--domain, --stack, --persist, --page, -f markdown). The 'When to use detailed searches' table maps each need to a domain with example keywords, and the Example Workflow covers a full common case end-to-end. This matches anchor 5: 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. Not 4 because there is no meaningful gap — commands, flags, domains, and stacks are all fully specified.

5 / 5

Workflow Clarity

The sequence is explicit and well-ordered: analyze requirements → Step 2 (REQUIRED design-system generation) → Step 2b (persist with Master + page overrides, including the override-resolution logic) → Step 3 supplemental domain searches → Step 4 stack guidelines, followed by a Pre-Delivery Checklist that serves as an explicit validation gate before delivery. Tips #6 ('If first search doesn't match, try different keywords') provides a retry loop, and the hierarchical retrieval rules give deterministic page-vs-Master resolution. This matches anchor 5: 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'. The operations are read-only searches (nothing destructive/batch), so the destructive-operation cap does not apply. Not 4 because both validation (checklist) and error recovery (iterate on keywords) are present.

5 / 5

Progressive Disclosure

The bundle structure is sound: SKILL.md is an overview/workflow document, the 67 styles / 96 palettes / UX guideline data live behind scripts/ (search.py, core.py, design_system.py exist as referenced), so bulk data is never inlined — a good use of script-mediated disclosure with one-level-deep, clearly-signaled references and easy navigation via section headers. However, the ~75-line 'Common Rules for Professional UI' and 'Pre-Delivery Checklist' sections are reference material inlined in the always-loaded SKILL.md that could live in a separate reference file (they are also partially redundant with the `ux` domain data searchable via the script). This matches anchor 4: 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps'. Not 5 because those inline reference sections keep the main file heavier than a true lean overview; not 3 because nothing is deeply nested or buried and the split is otherwise appropriate.

4 / 5

Total

17

/

20

Passed

Description

28%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 too terse for its own good: it names the UI/UX domain and hints at a search mechanism, but states no concrete capabilities, includes no 'use when' trigger guidance, and misses the natural keywords (palette, fonts, design system, landing page) that would let a user or Claude reliably select this skill. The body is far richer than the description suggests, so the fix is low-effort and high-impact.

Suggestions

List the concrete capabilities in the description, e.g.: 'Generate design systems with styles, 96 color palettes, 57 font pairings, UX guidelines, and chart recommendations for web and mobile apps via a searchable database.'

Add an explicit trigger clause: 'Use when the user asks to design, build, review, or restyle a UI — e.g., landing pages, dashboards, or app screens — or asks for color palettes, font pairings, or design-system recommendations.'

Include natural trigger terms users actually say: 'design system', 'color palette', 'font pairing', 'landing page', 'UI styles', 'dark mode' — these distinguish the skill from generic frontend or dataviz skills.

DimensionReasoningScore

Specificity

"UI/UX design intelligence with searchable database" names the domain (UI/UX design) but states no concrete actions — nothing about generating design systems, recommending color palettes, font pairings, chart types, or UX guidelines, all of which the body actually delivers. "Design intelligence" is abstract marketing language, matching the anchor 'Names the domain but actions are minimal or generic' (cf. 'Processes PDF files'). Not 1 because the domain is named and 'searchable database' hints at a concrete mechanism; not 3 because not even 1-2 concrete actions are stated.

2 / 5

Completeness

The description has only a vague 'what' ("design intelligence with searchable database" — a domain label plus a buzzword, not a stated capability) and no 'when' clause at all — no 'Use when...' or equivalent explicit trigger guidance, which per the judging guidelines caps completeness at 3. This matches anchor 2: 'Has a vague what and no when'. Not 3 because the 'what' is not clearly stated in terms of actions or deliverables; not 1 because the domain and mechanism are at least named rather than both being extremely vague.

2 / 5

Trigger Term Quality

"UI/UX design" is a natural phrase users say, but the description misses the terms users would actually use when they need this skill: "color palette", "font pairing", "design system", "landing page", "styling", "theme colors". With only one or two generic keywords and no synonyms, this matches the anchor 'One or two generic keywords; missing the natural phrases users say'. Not 1 because 'UI/UX design' is a genuine natural phrase, not pure technical jargon; not 3 because there is no coverage of variations or the skill's many sub-capabilities.

2 / 5

Distinctiveness Conflict Risk

"UI/UX design" is a real niche but a broad one — this description would compete with any frontend/design/styling skill (e.g., a dataviz or brand-guidelines skill) since no specific capability or trigger distinguishes it. This matches anchor 3: 'Somewhat specific but could still overlap with similar skills' (cf. 'Works with document files'). Not 4 because without concrete actions or triggers there is more than minor overlap risk with closely related skills; not 2 because 'UI/UX design' is not so broad as to overlap with virtually any skill.

3 / 5

Total

9

/

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
trackdubllc/Babel-Player-Alpha
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.