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".

81

Quality

77%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./data/02-designer-webguidelines/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Discovery

82%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a solid description with excellent trigger terms and completeness, clearly stating both what the skill does and when to use it. Its main weaknesses are the lack of specific concrete actions (what exactly does the review check?) and some potential overlap with other accessibility or UX review skills. Adding more detail about the specific checks performed would strengthen both specificity and distinctiveness.

Suggestions

Add specific concrete actions the skill performs, e.g., 'Checks color contrast, keyboard navigation, semantic HTML, responsive design, and ARIA usage against Web Interface Guidelines'

Differentiate from general accessibility or UX skills by emphasizing the specific 'Web Interface Guidelines' framework and what makes it distinct from WCAG audits or general design reviews

DimensionReasoningScore

Specificity

It names the domain (UI code review) and the framework (Web Interface Guidelines compliance), but doesn't list specific concrete actions like 'check color contrast ratios, validate ARIA labels, audit responsive breakpoints'. The description stays at a high level of 'review' without detailing what aspects are checked.

2 / 3

Completeness

Clearly answers both 'what' (review UI code for Web Interface Guidelines compliance) and 'when' (explicit 'Use when' clause with multiple trigger phrases). The when clause is explicit and well-defined.

3 / 3

Trigger Term Quality

Includes strong natural trigger terms that users would actually say: 'review my UI', 'check accessibility', 'audit design', 'review UX', 'check my site against best practices'. These cover multiple common phrasings users would naturally use.

3 / 3

Distinctiveness Conflict Risk

While 'Web Interface Guidelines compliance' is somewhat specific, terms like 'check accessibility' and 'review UX' could overlap with general accessibility audit skills or UX review skills. The specific framework reference helps but the trigger terms are broad enough to potentially conflict.

2 / 3

Total

10

/

12

Passed

Implementation

72%

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

This is a concise, well-structured skill that efficiently delegates the actual rule content to an external source. Its main weakness is the lack of concrete error handling for the external fetch dependency and the absence of any executable example showing how to invoke the fetch or format output. The workflow is clear but would benefit from a fallback strategy.

Suggestions

Add error handling guidance for when the WebFetch call fails (e.g., network error, URL changed), such as a fallback or user notification step.

Include a brief concrete example of the expected output format (e.g., `src/Button.tsx:42 — missing aria-label on interactive element`) so Claude knows the target format even before fetching the guidelines.

DimensionReasoningScore

Conciseness

The skill is lean and efficient. It doesn't explain what UI guidelines are or how web interfaces work. Every section serves a clear purpose with no padding.

3 / 3

Actionability

It provides a concrete URL to fetch and a clear process, but lacks executable code examples for fetching, parsing, or outputting results. The actual review logic is entirely delegated to the fetched content, making the skill itself somewhat vague on execution details.

2 / 3

Workflow Clarity

Steps are listed clearly (fetch, read, check, output), but there's no validation checkpoint—e.g., what to do if the fetch fails, if the URL is unreachable, or if the fetched content format has changed. For a workflow that depends on an external resource, error handling guidance is missing.

2 / 3

Progressive Disclosure

For a simple skill under 50 lines, the content is well-organized into clear sections (How It Works, Guidelines Source, Usage). The external reference to the guidelines source is one level deep and clearly signaled.

3 / 3

Total

10

/

12

Passed

Validation

90%

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

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
majiayu000/claude-skill-registry-data
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.