CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ui-design

Use when users need visual direction, interface hierarchy, layout decisions, design specifications, or prototypes before implementing a Web or mini program UI.

54

Quality

68%

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 ./config/source/skills/ui-design/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 highly actionable with concrete commands, code examples, and an auditable design workflow, but it is noticeably padded: the same prohibitions are repeated 4-5 times, use-case guidance is duplicated across two sections, and motivational role-play text adds cost. The single-file structure leaves no working progressive-disclosure layer, and the one file it does reference (checklist.md) is absent from the bundle.

Suggestions

Consolidate the repeated forbidden color/font/icon/emoji prohibitions into one canonical section (e.g., a single 'Forbidden defaults' table) and delete the duplicate mentions in the Activation Contract, trigger-word detector, and both audit sections — this alone would cut the body roughly in half.

Merge the 'When to use this skill' section into the Activation Contract, which already covers the same use-first/do-not-use ground, and remove the role-play and motivational padding lines.

Split the detailed material (aesthetic option catalog, anti-pattern code examples, self-audit grep commands, asset-download instructions) into references/ files (e.g., aesthetics.md, anti-patterns.md, audit.md) linked one level deep, and either ship checklist.md or remove the reference to it.

DimensionReasoningScore

Conciseness

The same prohibitions are repeated extensively — the emoji-icon ban appears five times ("Never use emoji as icons", "Emoji characters (🚀, ⭐, ❤️, etc.) as icons", "❌ FORBIDDEN: Emoji Icons", "Emoji icons: Never use emoji characters", Icon Audit) and the forbidden color/font lists four times ("FORBIDDEN COLORS: purple...", "FORBIDDEN FONTS: Inter, Roboto...", "Avoid Generic Fonts", "System fonts" audit). The "When to use this skill" section duplicates the Activation Contract, and role-play padding ("You are a professional frontend engineer specializing in...", "Remember: You are capable of extraordinary creative work. Don't hold back") adds tokens without guidance value. Not a 1 because most content is skill-specific rather than explaining concepts Claude already knows.

2 / 5

Actionability

Concrete, executable guidance throughout: copy-paste grep audit commands ("grep -iE \"(violet|purple|indigo|fuchsia)\" [your-file]"), curl/PowerShell download commands with flags ("curl -L --fail -o assets/images/logo.png ..."), exact Tailwind good/bad class examples ("bg-gradient-to-br from-amber-50 via-orange-50 to-rose-50"), and a fill-in DESIGN SPECIFICATION template with hex ranges. Not a 5 because audit commands require [your-file] substitution and several directives remain abstract ("Use animations for effects and micro-interactions").

4 / 5

Workflow Clarity

A clear sequence exists (User Experience Analysis → ... → Frontend Prototype Implementation → Realism Enhancement) with explicit validation checkpoints in the SELF-AUDIT CHECKLIST and a feedback loop ("If any audit fails → Re-design with correct approach"). Not a 5 because two overlapping process descriptions compete (the "How to use this skill" numbered list vs. the "Design Process" section) and the required "Read [UI Design Activation Checklist](checklist.md) before interface generation" gate references a file not present in the bundle.

4 / 5

Progressive Disclosure

Section headers (Design Thinking, Frontend Aesthetics Guidelines, Implementation Requirements) keep the ~340-line body navigable, but everything — detailed rules, code examples, audit commands, asset-download instructions — is inlined in one monolithic SKILL.md with no references/, scripts/, or assets/ directories, and the sole referenced file (checklist.md) is missing from the bundle. The sibling-skill pointers (../web-development/SKILL.md) do include explicit missing-file handling, which prevents a lower score.

3 / 5

Total

13

/

20

Passed

Description

70%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 solid trigger-focused description with an explicit 'Use when' clause, natural keywords, and reasonable distinctiveness. Its main weakness is that the skill's capabilities are implied through a list of user needs rather than stated directly, and it lacks common trigger synonyms like 'look and feel' or 'styling'.

Suggestions

Add an explicit capability statement, e.g., "Produces a design specification (aesthetic direction, color palette, typography, layout strategy) and high-fidelity prototypes" before the 'Use when' clause so the 'what' is stated, not implied.

Include common trigger synonyms such as "look and feel", "styling", or "UI design" to broaden the natural keyword coverage.

DimensionReasoningScore

Specificity

The description names the domain and concrete deliverables ("visual direction, interface hierarchy, layout decisions, design specifications, or prototypes") but never states an explicit action the skill performs — the capability is only implied through the list of things users need. Not a 4 because no action verbs or capability statement appear; not a 2 because the deliverables and domain ("Web or mini program UI") are specific rather than generic.

3 / 5

Completeness

The 'when' is explicit and concrete ("Use when users need visual direction, interface hierarchy, layout decisions, design specifications, or prototypes before implementing a Web or mini program UI"), while the 'what' is implied through those deliverables rather than directly stated. Not a 5 because there is no explicit capability statement (e.g., "Produces design specifications and high-fidelity prototypes") — the skill's actions must be inferred.

4 / 5

Trigger Term Quality

Good natural keyword coverage: "visual direction", "layout decisions", "design specifications", "prototypes", and "Web or mini program UI" are phrases users would plausibly say. Not a 5 because common synonyms like "look and feel", "styling", "UI design", or "aesthetic" are missing; coverage exceeds the "some relevant keywords" of a 3.

4 / 5

Distinctiveness Conflict Risk

The design-before-implementation framing ("before implementing a Web or mini program UI") and mini-program specificity distinguish it from backend skills and from straight implementation skills. Not a 5 because it could still overlap with general frontend/web development or theming skills given no negative boundary is stated in the description; well above the generic overlap of a 3.

4 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

relative_links

Relative link issues: 1 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing, 2 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

TencentCloudBase/CloudBase-AI-Toolkit

Path

config/source/skills/ui-design/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.