CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ui-polish

Refina detalhes visuais e interacoes de interfaces existentes. Trigger em: "polish", "deixar mais refinado", "parece meio off", "acabamento", "border radius", "alinhamento optico", "font smoothing", "tabular numbers", "shadow em vez de border", "sombra pra dar profundidade", "stagger na animacao de entrada", "animacao de saida", "scale on press", "stagger animation", "hit area", "image outline", "revisar detalhes visuais".

Quality

87%

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

82%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 high-quality, prescriptive body: every principle carries an exact value, exception, or copy-paste snippet, boundaries against sibling skills are explicit, and visual verification is enforced as a checkpoint before completion. Remaining gaps are minor — a little inferred- context padding and an implicit rather than explicitly ordered review sequence.

DimensionReasoningScore

Conciseness

The body is dense and prescriptive — rules with exact values, exceptions, and zero filler per principle — and defers extensive examples to `docs/skill-guides/ui-polish.md`. Minor trimming is possible: the opening rationale ("Grandes interfaces raramente vêm de uma coisa só...") and the pipeline-integration section restate context Claude could infer. Not 5 because of those few padding passages; not 3 because there is no real over-explanation of known concepts.

4 / 5

Actionability

Fully executable throughout: a formula (`outerRadius = innerRadius + padding`), copy-paste CSS (`--shadow-border` layers, ring for dark mode), a ready Tailwind class string (`outline outline-1 -outline-offset-1 outline-black/10`), exact motion values (`scale 0.25 -> 1`, `blur(4px)`, spring `duration 0.3, bounce 0`, exit `translateY -12px`, 150ms vs 300ms), and a worked output-format example. Common cases are covered with concrete prescriptions including a no-motion-library fallback.

5 / 5

Workflow Clarity

The process is well scaffolded: expected inputs, expected outputs, a fixed Before/After output format, a handoff section defining entry/exit conditions, and a genuine validation checkpoint ("marcar um item nesta checklist exige ter visto o resultado no browser", "validar com screenshot/preview"). It falls short of 5 because the review sequence itself (review principles -> apply changes -> verify visually -> report) is implicit rather than an explicit ordered workflow.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, assets/), and the body is well-sectioned with a clearly signaled, one-level-deep pointer to extended examples (`docs/skill-guides/ui-polish.md` "apenas quando necessario") plus a copy-paste `templates/transitions.css`. It is not 5 because the 16 inline principles with code snippets carry detail that could partly live in the referenced guide, keeping SKILL.md closer to a full manual than a lean overview.

4 / 5

Total

17

/

20

Passed

Description

86%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: correct third-person voice, a clear if brief capability statement, and an unusually thorough natural-language trigger list covering both user phrasing and technical terms. Its main gap is that the capability sentence stays generic while the concrete actions (concentric radii, shadow-over-border, exit animations, tabular numbers) are only implied through the trigger terms.

Suggestions

Expand the capability sentence from "Refina detalhes visuais e interacoes" to list 3-5 concrete actions, e.g. "Refina detalhes visuais de interfaces existentes: border radius concentrico, sombras em vez de bordas, alinhamento optico, animacoes de entrada/saida e stagger, tabular numbers e font smoothing".

Clarify scope in the description to strengthen distinctiveness, e.g. appending "entra depois que o componente ja esta implementado" so it does not trigger for motion-system or layout tasks.

DimensionReasoningScore

Specificity

The capability statement is a single sentence — "Refina detalhes visuais e interacoes de interfaces existentes" — which names the domain with 1-2 actions but does not enumerate the specific refinements it performs (border radius, shadows, stagger, tabular numbers, etc.); those specifics appear only as trigger terms. Not 4 because no several distinct actions are stated as capabilities; not 2 because "refina detalhes visuais e interacoes" is more concrete than a bare domain label.

3 / 5

Completeness

Explicitly answers both: what ("Refina detalhes visuais e interacoes de interfaces existentes") and when ("Trigger em: ..." with 16 concrete trigger phrases). This matches the anchor that clearly and explicitly answers both what AND when with concrete trigger phrases; the missing-Use-when cap at 3 does not apply since an equivalent explicit trigger clause is present.

5 / 5

Trigger Term Quality

The trigger list comprehensively covers natural user phrasing ("polish", "deixar mais refinado", "parece meio off", "acabamento", "revisar detalhes visuais") alongside technical synonyms ("border radius", "alinhamento optico", "font smoothing", "tabular numbers", "scale on press", "hit area", "image outline"). Matches the comprehensive-coverage-with-synonyms anchor; nothing common is missing.

5 / 5

Distinctiveness Conflict Risk

The niche is clear — finish-level refinement of already-built interfaces — and most triggers ("border radius", "tabular numbers", "image outline") are distinct to it. Minor overlap remains with sibling skills: "stagger na animacao de entrada" and "animacao de saida" also naturally occur when a motion-design skill is needed. Mostly distinct with minor overlap risk, so 4 rather than 5.

4 / 5

Total

17

/

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

felvieira/claude-skills-fv

Path

skills/52-ui-polish/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.