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.

49

Quality

62%

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/.claude/skills/ui-design/SKILL.md

The canonical home for this skill is ui-design in TencentCloudBase/CloudBase-AI-Toolkit

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 skill body is highly actionable with executable audit commands and concrete good/bad examples, and its workflow has genuine validation feedback loops. Its main weaknesses are heavy redundancy (core prohibitions repeated four to five times) and a broken reference to a missing checklist.md file.

Suggestions

Consolidate the repeated prohibitions (forbidden colors, fonts, emoji icons, layout rules appear in 4-5 sections) into a single reference table or one section, cutting the body substantially.

Fix or remove the checklist.md link — the file is absent from the bundle, so the mandatory pre-generation gate cannot actually be followed; either ship the file or inline its essential checks.

Move the aesthetic-direction catalog and the ANTI-PATTERNS code gallery into a reference file (e.g., references/aesthetics.md) linked from SKILL.md to reduce token load.

DimensionReasoningScore

Conciseness

The body is noticeably verbose through repetition rather than explanation of known concepts: the forbidden font/color lists appear in at least four places ("How to use this skill", the Design Specification template, "Typography"/"Color & Theme", the ANTI-PATTERNS block, and the Self-Audit), the emoji-icon prohibition is stated roughly five times, the design process is listed twice ("How to use this skill" step 2 and the "Design Process" section), and "When to use this skill" duplicates the Activation Contract. This matches anchor 2 ('several unnecessary explanations or padded sections'); it is above 1 because the material is domain guidance rather than textbook explanation of concepts Claude already knows.

2 / 5

Actionability

The guidance is fully executable: a fill-in DESIGN SPECIFICATION template, copy-paste grep commands for the color/font/icon audits, exact curl/wget/PowerShell download commands with flag explanations, concrete Tailwind class-level good/bad examples, and hex ranges for forbidden colors. Specific examples cover the common cases (styling, layout, icons, asset downloads).

5 / 5

Workflow Clarity

A clear sequence is present (mandatory design specification → six-step design process → implementation → self-audit before submitting) with an explicit feedback loop ("If any audit fails → Re-design with correct approach") and per-audit remediation steps. It falls short of 5 because the referenced activation gate "Read [UI Design Activation Checklist](checklist.md) before interface generation" points to a file that is not in the bundle, and the process is stated twice in slightly different forms, leaving minor validation/sequencing gaps.

4 / 5

Progressive Disclosure

The body has real section structure, but it is a ~335-line monolith: content that clearly belongs in separate reference files (the aesthetic-direction catalog, the ANTI-PATTERNS code gallery, the remote-asset download guidance) is inlined, and the only in-bundle file reference, checklist.md, does not exist in the skill directory. This matches anchor 3 ('some structure but could be better organized... content that should be separate is inline').

3 / 5

Total

14

/

20

Passed

Description

47%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 has a strong, explicit trigger clause with good natural keywords, but it is missing the capability half entirely — it never states what the skill does. Adding a leading 'what' clause naming its concrete outputs would substantially raise completeness and specificity.

Suggestions

Add a 'what' clause before the trigger, e.g., "Produces design specifications (aesthetic direction, color palette, typography, layout strategy) and high-fidelity UI prototypes for Web and mini program interfaces. Use when...".

Include additional natural trigger synonyms such as "styling", "look and feel", "theme", or "mockups/wireframes" to broaden the natural phrases users say.

DimensionReasoningScore

Specificity

The description names the domain ("visual direction, interface hierarchy, layout decisions, design specifications, or prototypes before implementing a Web or mini program UI") but contains no action verbs describing what the skill actually does — the nouns are user needs, not capabilities. This matches anchor 2 ('names the domain but actions are minimal or generic'); it is above 1 because the domain and context are specifically framed, and below 3 because no concrete skill actions (e.g., 'produces design specifications', 'builds prototypes') are stated.

2 / 5

Completeness

Only the 'when' half is present ("Use when users need visual direction... before implementing a Web or mini program UI"); the 'what' — what the skill does or produces — is entirely absent. This matches anchor 2 ('only when is present without what'); it is not 3 because anchor 3 requires a clear 'what', and not 1 because the 'when' clause is explicit and detailed.

2 / 5

Trigger Term Quality

Good natural-phrase coverage: "visual direction", "layout decisions", "design specifications", "prototypes", "Web or mini program UI" are terms users would naturally say. It falls short of anchor 5 because common synonyms like "styling", "look and feel", "theme", "mockups", or "wireframes" are missing, and above 3 because coverage goes beyond a couple of generic keywords.

4 / 5

Distinctiveness Conflict Risk

The pre-implementation framing ("before implementing a Web or mini program UI") carves a distinct design-phase niche with concrete triggers, distinguishable from general frontend implementation skills. It is not 5 because broad phrases like "visual direction" and "design specifications" could still overlap with styling or brand/design-system skills.

4 / 5

Total

12

/

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/.claude/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.