CtrlK
BlogDocsLog inGet started
Tessl Logo

emcn-design-review

Review UI code for alignment with the emcn design system — components, tokens, patterns, and conventions

61

Quality

72%

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/emcn-design-review/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

87%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is concise, highly actionable, and well-organized with concrete paths and token patterns. Its main weakness is the absence of a validation/verification checkpoint in the fix workflow, which is important since fix=true applies destructive edits.

Suggestions

Add a validation step after applying fixes, e.g. 'After applying fixes: run typecheck/build and confirm components render correctly before finishing.'

Clarify the analysis step with a brief checklist tying each anti-pattern back to the corresponding rule section.

State explicitly what to do when the barrel file or referenced source files are missing or out of date.

DimensionReasoningScore

Conciseness

The body is lean and token-efficient: dense tables, token lists, and terse rules with no explanation of concepts Claude already knows and no padding.

3 / 3

Actionability

Guidance is concrete and copy-paste ready — exact file paths (e.g. 'apps/sim/components/emcn/index.ts'), exact token patterns ('text-[var(--text-primary)]'), and a full intent-to-variant table; for an instruction-only review skill this is highly actionable.

3 / 3

Workflow Clarity

A clear numbered sequence exists (read barrel, read globals.css, analyze, apply/propose fixes), but applying fixes is a potentially destructive operation with no validation or verification checkpoint (e.g. typecheck, build, or visual check), which caps workflow clarity at 2.

2 / 3

Progressive Disclosure

Content is organized into well-signaled one-level-deep sections with no nested references; the few external pointers (e.g. '.claude/rules/emcn-components.md') are single-level, and the single-file structure is appropriate for a focused review skill.

3 / 3

Total

11

/

12

Passed

Description

57%

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 specific to its niche and clearly distinguishable, but it describes only one action and omits any explicit 'Use when...' trigger guidance. Adding concrete actions and an explicit usage-trigger clause would raise its score.

Suggestions

Add an explicit 'Use when...' clause listing natural triggers, e.g. 'Use when reviewing UI code against the emcn design system, or when the user mentions emcn components, tokens, or design patterns.'

Expand the action list from a single 'Review' to multiple concrete actions (e.g. 'Audit UI code for emcn compliance, flag non-emcn components and hardcoded tokens, apply or propose fixes').

Include common user phrasings like 'design system', 'emcn', 'tokens', and 'component variants' to improve trigger-term coverage.

DimensionReasoningScore

Specificity

Names the domain ('emcn design system') and enumerates review aspects ('components, tokens, patterns, and conventions'), but offers a single action verb ('Review UI code for alignment') rather than multiple distinct concrete actions.

2 / 3

Completeness

It states what the skill does (review UI code against the emcn design system) but provides no explicit 'when' guidance; per the guidelines a missing 'Use when...' clause caps completeness at 2.

2 / 3

Trigger Term Quality

Relevant keywords like 'design system', 'UI code', 'components', and 'tokens' are present, but common variations and an explicit 'Use when...' trigger clause are missing.

2 / 3

Distinctiveness Conflict Risk

The 'emcn design system' niche is highly specific and unlikely to trigger for unrelated skills, giving it a clear distinct trigger.

3 / 3

Total

9

/

12

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository
simstudioai/sim
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.