CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ux-principles

User research, usability heuristics, user psychology, accessibility, inclusive design, user testing, and UX metrics

Quality

53%

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 ./plugins/luxor-design-toolkit/skills/ux-principles/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a well-organized UX textbook, not a skill: nearly all of it restates knowledge Claude already has, with almost no project-specific or executable guidance. The internal structure and occasional concrete specifics (formulas, ratios, code snippets) are its strengths, but it needs radical trimming and offloading to reference files.

Suggestions

Cut the explanations of universally known concepts (Nielsen's heuristics, Gestalt, Fitts's/Hick's/Miller's Laws, WCAG basics, SUS/NPS/CSAT definitions) and keep only non-obvious, project-specific guidance or decision rules.

Split the body into one-level-deep reference files (e.g. references/heuristics.md, references/accessibility.md, references/metrics.md, references/examples.md) and reduce SKILL.md to a short overview that links to them.

Replace the 15 generic product case studies with a few concrete, actionable patterns or checklists Claude can apply directly when the skill is invoked.

DimensionReasoningScore

Conciseness

The ~1750-line body extensively explains standard concepts Claude already knows: Nielsen's 10 heuristics, Gestalt principles, Fitts's and Hick's Laws, Miller's Law, WCAG POUR, cognitive load theory, SUS/NPS/CSAT definitions, plus 15 product case studies with padded metrics. This matches anchor 1 ('Severely verbose; extensively explains concepts Claude already knows; heavily padded') and adds almost nothing Claude cannot already produce.

1 / 5

Actionability

There are genuinely concrete details scattered throughout — the 4.5:1 contrast ratio, 44×44/48×48 touch targets, the SUS scoring formula and questionnaire, the ARIA landmarks code block, and participant-count guidance — but the bulk is descriptive principle explanation rather than executable instruction. This sits between anchor 2 (minimal concrete guidance) and anchor 4 (mostly executable guidance), landing at 3: some concrete guidance but incomplete as a working reference.

3 / 5

Workflow Clarity

Several processes are clearly numbered (usability testing: planning → conducting → analysis → reporting; journey mapping's 8-step creation process; A/B testing best practices), giving a real sequence. However, checkpoints are implicit — e.g., tree testing says "test again until success rates acceptable" with no validate/fix/retry loop — matching anchor 3 ('Steps listed but validation gaps; checkpoints missing or implicit'). No destructive or batch operations are involved, so the cap does not apply.

3 / 5

Progressive Disclosure

The entire skill is one monolithic 1750-line file with no bundle files in references/, scripts/, or assets/, and the body points to nothing external. Content that clearly belongs in separate files — the full heuristics reference, the WCAG details, the 15 examples, the metrics catalog — is all inlined, matching anchor 2 ('content that clearly belongs in separate files is inlined'). It avoids anchor 1 only because section headers provide navigable structure.

2 / 5

Total

9

/

20

Passed

Description

56%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 identifies the UX domain clearly with good natural trigger keywords, but it is a topic list rather than a capability statement — no verbs, no 'what it does', and no 'Use when' guidance. Adding action verbs and an explicit trigger clause would raise both specificity and completeness.

Suggestions

Rewrite as concrete third-person actions, e.g. "Guides user research planning, heuristic evaluations, usability testing sessions, accessibility (WCAG) reviews, and UX metric selection (SUS, NPS, task success)."

Append an explicit trigger clause such as "Use when designing or evaluating interfaces, planning user research or usability tests, or applying accessibility standards."

Add natural synonyms like "user experience", "usability testing", and "personas" to broaden trigger coverage.

DimensionReasoningScore

Specificity

The description is a list of domain topic nouns — "User research, usability heuristics, user psychology, accessibility, inclusive design, user testing, and UX metrics" — with no action verbs describing what the skill actually does. It names the domain clearly but the actions are absent, matching anchor 2 ('Names the domain but actions are minimal or generic'); it does not reach anchor 3, which requires 1-2 concrete actions.

2 / 5

Completeness

The 'what' is conveyed through the topic list, but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. It fits anchor 3 ('Has a clear what but when is missing or only weakly implied') rather than anchor 4, which requires both what and when.

3 / 5

Trigger Term Quality

Terms like "user research", "usability", "user testing", "accessibility", and "UX metrics" are natural phrases users would say, giving good keyword coverage across the domain. It falls short of anchor 5 because common variations such as "user experience", "usability testing", "personas", or "wireframes" are missing.

4 / 5

Distinctiveness Conflict Risk

The UX focus (user research, usability heuristics, UX metrics) is a fairly distinct niche with low conflict risk against unrelated skills. It is not a 5 because broad terms like "accessibility" and "user testing" could also trigger front-end development or QA/testing skills.

4 / 5

Total

13

/

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 (1755 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

manutej/luxor-claude-marketplace

Path

plugins/luxor-design-toolkit/skills/ux-principles/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.