CtrlK
BlogDocsLog inGet started
Tessl Logo

web-design-guidelines

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

63

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

57%

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

A compact, single-purpose skill with a clear fetch-then-apply workflow and good organization. It is weakened by a duplicated workflow section, fully externalized rules/output format, and a missing checkpoint for the network-fetch step.

Suggestions

Collapse the redundant "How It Works" and "Usage" workflows into one sequenced procedure to remove the duplicated steps.

Add a validation/error-recovery checkpoint for the WebFetch step (e.g., confirm the fetch succeeded and content looks like the guidelines before proceeding, with a fallback if it fails).

Inline a brief summary of the core rule categories or the expected output format so the skill is actionable even if the remote fetch is unavailable.

DimensionReasoningScore

Conciseness

The body is lean and avoids explaining concepts Claude already knows, but the "How It Works" and "Usage" sections repeat nearly identical four-step workflows, so it could be tightened.

2 / 3

Actionability

It provides a concrete fetch URL and names WebFetch, but defers all actual rules and the output format to the remotely fetched content, leaving key details absent from the skill itself.

2 / 3

Workflow Clarity

A clear numbered sequence is present, but there is no validation or error-recovery checkpoint for the fragile network-fetch step (e.g., what to do if WebFetch fails or returns stale content).

2 / 3

Progressive Disclosure

Under 50 lines, single-purpose, no bundle files, with well-organized sections (How It Works, Guidelines Source, Usage); per the simple-skills note this earns the top score.

3 / 3

Total

9

/

12

Passed

Description

90%

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, third-person description with explicit natural-language triggers and a clear niche. Its only weakness is specificity: it names a single review action rather than enumerating several concrete capabilities.

Suggestions

Expand the capability clause to list concrete actions (e.g., 'flag accessibility violations, check color contrast, verify semantic markup') to lift specificity to the top anchor.

DimensionReasoningScore

Specificity

Names the domain ("Review UI code for Web Interface Guidelines compliance") and a single concrete action, but does not list multiple specific concrete actions like the score-3 anchor requires.

2 / 3

Completeness

Explicitly answers what it does ("Review UI code for Web Interface Guidelines compliance") and when to use it ("Use when asked to..."), satisfying both halves of the completeness criterion.

3 / 3

Trigger Term Quality

Includes natural phrases a user would actually say ("review my UI", "check accessibility", "audit design", "review UX", "check my site against best practices"), giving good coverage of common variations.

3 / 3

Distinctiveness Conflict Risk

Targets a clear niche (Web Interface Guidelines / accessibility / UX audits) with distinct triggers unlikely to overlap with other skills.

3 / 3

Total

11

/

12

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
jdrhyne/agent-skills
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.