CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ux-design-patterns

Read before adding or changing any front/ UI element - a control, layout, button, or interaction pattern. Covers the don't-invent-new-UX-without-a-PRD rule and the priority order for design tradeoffs (existing behavior > intuitiveness > information density > usability > utility > uniqueness > industry practices > generic UI).

68

Quality

85%

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

75%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.

Dense, highly actionable codebase-specific guidance: concrete greps, exact functions, file paths, and a validated checklist make it immediately executable. The main weakness is verbosity - three extended incident narratives repeat the same lesson - and no reference-file split despite the volume of example detail.

Suggestions

Condense each 'Real ... example' narrative to the essential references (files, classes, functions) plus a one-line moral - the grep-first lesson currently appears three times (core principle, the buildDT() example, and checklist step 1).

Move the three incident narratives into a references/ file (e.g. references/incidents.md) signaled from SKILL.md, keeping the main file to the rules, priority order, and checklist.

Add an explicit feedback loop to checklist step 5: when visual verification fails, re-grep the existing pattern, compare the rendered output against it, and fix before proceeding.

DimensionReasoningScore

Conciseness

All content is codebase-specific (no generic PDF-style concept explanations), but the three ~200-word incident narratives ("Real, recent example: a presence-page Prev/Next pager was first built with custom <button class="btn btn-xs"> elements...") each restate the same grep-first moral that also appears again in the checklist ("Grep front/js/, front/css/, front/php/ for an existing implementation"). More than minor over-explanation that could be trimmed, but every paragraph carries real file/function facts.

3 / 5

Actionability

Fully executable guidance throughout: copy-paste greps ("grep -rn 'pagination\|paginate_button' front/", "grep -rn '\.DataTable(' front/"), exact function names (resolveSpinnerTarget(), callAfterAppInitialized(), getStatusBadgeParts()), file paths, concrete markup patterns ("<span class="badge ${cssClass}">${iconHtml} ${label}</span>"), and a specific API prescription ("Use .finally(hideSkeleton) on the render promise, not .then(hideSkeleton)").

5 / 5

Workflow Clarity

The numbered "Practical checklist before building a new UI element" gives a clear sequence (grep -> reuse -> PRD check -> design via priority order -> "Verify visually in a real browser/devcontainer before calling it done") with an explicit validation checkpoint. Not 5 because there is no feedback loop for what to do when verification fails; not 3 because a concrete checkpoint is present and the sequence is well-defined.

4 / 5

Progressive Disclosure

Six clearly headed sections in a single SKILL.md with no bundle files, and in-text references point at real project paths (front/js/common.js, front/js/app-init.js, front/css/dark-patch.css) rather than nonexistent skill files. Not 5 because the three long example narratives are inlined content that could be split into a one-level-deep references file, leaving the main file as rules + checklist; not 3 because structure and navigation are good, not buried or monolithic.

4 / 5

Total

16

/

20

Passed

Description

87%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: explicit 'what' and 'when' with concrete trigger phrases, third-person/declarative style, and a clearly distinct niche. The only weakness is limited synonym coverage of natural trigger terms, which leaves a few user phrasings uncovered.

DimensionReasoningScore

Specificity

Lists several concrete coverage items - "a control, layout, button, or interaction pattern", "the don't-invent-new-UX-without-a-PRD rule", and "the priority order for design tradeoffs" with all eight levels spelled out. Not 5 because it scopes via examples and rules rather than comprehensively covering what the body teaches (skeleton/spinner mechanics, fetch-once/filter-client-side are absent); not 3 because it names well more than 1-2 concrete things.

4 / 5

Completeness

Explicitly answers both parts: when - "Read before adding or changing any front/ UI element - a control, layout, button, or interaction pattern"; what - "Covers the don't-invent-new-UX-without-a-PRD rule and the priority order for design tradeoffs". Not 4 because the 'when' is specific and concrete with trigger phrases, not merely present-but-imprecise.

5 / 5

Trigger Term Quality

Natural phrases users would say: "adding or changing any front/ UI element", "a control, layout, button", "interaction pattern", "design tradeoffs". Not 5 because common variations like "design", "style", "CSS", "modal", or "form" are missing; not 3 because coverage is good and specific rather than partial.

4 / 5

Distinctiveness Conflict Risk

Clear niche with distinct triggers: a codebase-specific UX reuse rule set (front/ UI elements, PRD gating, an explicit 8-level priority chain) that no generic skill would claim. Minimal conflict risk with other skills; not 4 because there is no meaningful overlap with a neighboring skill's triggers.

5 / 5

Total

18

/

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

netalertx/NetAlertX

Path

.claude/skills/ux-design-patterns/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.