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

60

Quality

70%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

Fix and improve this skill with Tessl

tessl review fix ./prompts/web-design-guidelines/SKILL.md
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.

The body is short and well-organized with a clear sequence, but it carries redundant step lists and delegates its core logic to a fetched external document without validation or concrete output examples. Tightening the duplication and adding a fallback for the fetch would materially raise quality.

Suggestions

Merge the near-duplicate 'How It Works' and 'Usage' step lists into a single workflow to remove redundancy.

Add a concrete example of the `file:line` output format so the result shape is unambiguous without relying on the fetched document.

Include a validation/fallback checkpoint for the WebFetch step (e.g., what to do if the URL is unreachable or returns empty content).

DimensionReasoningScore

Conciseness

The body is lean and avoids explaining concepts Claude knows, but the 'How It Works' and 'Usage' sections repeat nearly identical four-step lists and the fetch instruction is stated twice, so it could be tightened.

2 / 3

Actionability

It gives a concrete source URL and names WebFetch, but the actual review logic is delegated to fetched content and no example of the expected `file:line` output is shown, leaving key details missing.

2 / 3

Workflow Clarity

Steps are clearly numbered (fetch, read, check, output) with an 'ask the user' fallback, but there is no validation or fallback for the network fetch, so checkpoints are implicit rather than explicit.

2 / 3

Progressive Disclosure

The skill is under 50 lines with no bundle files and is organized into clear sections (How It Works, Guidelines Source, Usage), satisfying the simple-skills allowance for a top score.

3 / 3

Total

9

/

12

Passed

Description

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.

The description is well-structured with explicit triggers and a clear what/when split, scoring strongly on completeness and trigger quality. It is held back by a single-action specificity profile and some trigger breadth that raises mild conflict risk.

Suggestions

Add one or two more concrete actions (e.g., 'flag accessibility violations, spot inconsistent spacing/typography, report interaction defects') to lift specificity toward the multi-action anchor.

Tie the broader triggers ('audit design', 'review UX') more tightly to the guidelines scope (e.g., 'review UX against Web Interface Guidelines') to reduce conflict with general design-review skills.

DimensionReasoningScore

Specificity

Names the domain ('UI code', 'Web Interface Guidelines compliance') and one core action ('Review'), but does not list multiple distinct concrete actions like the score-3 anchor requires.

2 / 3

Completeness

Explicitly answers both what ('Review UI code for Web Interface Guidelines compliance') and when via a clear 'Use when...' trigger clause, matching the top anchor.

3 / 3

Trigger Term Quality

Provides a strong set of natural phrases users would actually say — 'review my UI', 'check accessibility', 'audit design', 'review UX', 'check my site against best practices' — matching the good-coverage anchor.

3 / 3

Distinctiveness Conflict Risk

The named 'Web Interface Guidelines' niche is fairly specific, but broad triggers like 'audit design' and 'review UX' could plausibly fire for a general design-review skill, so overlap risk remains.

2 / 3

Total

10

/

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.