CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

emil-design-eng

This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.

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 ./.agents/skills/emil-design-eng/SKILL.md
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.

A dense, opinionated body of craft knowledge with strong concrete guidance — exact curves, durations, decision frameworks, and working code snippets. Its main weaknesses are token efficiency (duplicated checklists and repeated patterns, plus some CSS basics) and total lack of file-level structure, with everything inlined in one large SKILL.md.

Suggestions

Consolidate the duplicate review guidance: merge the opening "Review Format" table and the closing "Review Checklist" into a single section, and keep the scale-on-press button CSS in one place.

Split large cohesive topics into one-level-deep references — e.g. `references/clip-patterns.md`, `references/gestures.md`, `references/springs.md` — leaving SKILL.md as an overview with well-signaled links.

Trim sections that re-explain CSS fundamentals (translateY percentages, transform-origin default, scale affecting children) down to the non-obvious application guidance.

DimensionReasoningScore

Conciseness

Mostly efficient, opinionated guidance with exact values and code, but there is real tightening available: the opening Review Format table and the closing Review Checklist repeat the same rows, button scale-on-press CSS appears three times, the "Perceived performance" section restates points from "How fast should it be", and sections like "scale() scales children too" and "translateY with percentages" explain CSS basics Claude already knows. This matches anchor 3 rather than 4 — the duplication and basic-concept explanation are more than minor trims.

3 / 5

Actionability

Guidance is highly concrete: exact cubic-bezier curves, duration tables, decision trees, and mostly copy-paste-ready CSS/JS snippets covering the common cases (buttons, popovers, toasts, tooltips, drawers). It falls short of 5 because a few patterns are described without executable code — e.g. the tooltip instant-open logic relies on a `data-instant` attribute that nothing sets, and the comparison slider says "adjust the right inset value based on drag position" with no implementation.

4 / 5

Workflow Clarity

The Animation Decision Framework is explicitly ordered ("answer these questions in order": animate at all → purpose → easing → duration), and the Review Checklist plus debugging sections (slow motion, frame-by-frame, real-device testing) provide verification checkpoints. It is not 5 because there is no validate-and-retry loop around the review workflow, and the two overlapping checklists blur the entry point for executing a review. No destructive/batch operations, so no validation cap applies.

4 / 5

Progressive Disclosure

The file is well-sectioned with clear headers and navigable structure, but at ~660 lines everything is inline in a monolithic SKILL.md — clip-path patterns, gesture/drag details, and the Sonner component principles are each cohesive topics that clearly belong in separate reference files a level deep. This matches anchor 3 (good structure, but content that should be separate is inline) rather than 4, since there are no references or splits at all.

3 / 5

Total

14

/

20

Passed

Description

48%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 communicates a clear identity and topical niche but functions as a mission statement rather than a capability description. It lists no concrete actions and provides no trigger guidance for when the skill should activate, which limits both completeness and trigger-term quality.

Suggestions

Add an explicit trigger clause, e.g. "Use when reviewing or writing UI code involving animations, transitions, hover/press states, or component polish (CSS, Tailwind, framer-motion/Motion)."

State concrete actions instead of "encodes philosophy" — e.g. "Reviews UI code for animation duration, easing, and transition issues; provides easing curves, duration tables, and component patterns."

Include natural synonym keywords users would say — "animation", "motion", "easing", "transitions", "micro-interactions" — to improve trigger matching.

DimensionReasoningScore

Specificity

The description names the domain well ("UI polish, component design, animation decisions, and the invisible details") but the only action verb is "encodes Emil Kowalski's philosophy" — no concrete actions like reviewing UI code, choosing easings, or applying animation guidance are stated. It sits between anchor 1 (entirely vague) and anchor 3 (1-2 concrete actions): the domain is specific but the actions are generic.

2 / 5

Completeness

There is a clear "what" (encodes a design philosophy on UI polish, component design, and animation decisions) but no "when" clause at all — no "Use when..." or equivalent trigger guidance, which per the judging guidelines caps this at 3. It is not a 2 because the "what" is specific, and not a 4 because the "when" is entirely absent rather than weakly present.

3 / 5

Trigger Term Quality

Some relevant natural keywords are present ("UI polish", "animation", "component design") but common variations users would say are missing — no mention of "transitions", "easing", "micro-interactions", "hover states", or "motion". This matches anchor 3 (some relevant keywords, missing common variations/synonyms) rather than 4 (good coverage with only a few missing).

3 / 5

Distinctiveness Conflict Risk

The framing around Emil Kowalski's philosophy, UI polish, and animation decisions carves out a fairly distinct niche, with only minor overlap risk against generic frontend/design skills. It is not a 5 because terms like "component design" and "UI polish" are broad enough that a general design-guidelines skill could also fire on them.

4 / 5

Total

12

/

20

Passed

Validation

87%

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

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

skill_md_line_count

SKILL.md is long (663 lines); consider splitting into references/ and linking

Warning

frontmatter_unknown_keys

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

Warning

Total

14

/

16

Passed

Repository

simstudioai/sim

Path

.agents/skills/emil-design-eng/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.