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

78

Quality

73%

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 ./skills/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 a clear 'Use when' clause containing multiple natural trigger phrases, which is its strongest aspect. The main weakness is that the 'what' portion is somewhat high-level—it says it reviews for compliance but doesn't enumerate the specific checks or actions performed. There's also moderate overlap risk with other accessibility or UX review skills due to the breadth of trigger terms.

Suggestions

Add 2-3 specific concrete actions to the 'what' portion, e.g., 'Checks color contrast, validates semantic HTML, audits keyboard navigation, and reviews responsive design patterns against Web Interface Guidelines.'

Consider narrowing or qualifying the broader trigger terms like 'check accessibility' to reduce conflict risk with other accessibility-focused skills, e.g., 'check accessibility against Web Interface Guidelines'.

DimensionReasoningScore

Specificity

It names the domain (UI code review) and the standard (Web Interface Guidelines compliance), but doesn't list specific concrete actions like 'check color contrast', 'validate ARIA labels', 'audit navigation patterns', etc.

2 / 3

Completeness

Clearly answers both 'what' (review UI code for Web Interface Guidelines compliance) and 'when' (explicit 'Use when' clause with multiple trigger scenarios).

3 / 3

Trigger Term Quality

Includes multiple natural trigger phrases users would actually say: 'review my UI', 'check accessibility', 'audit design', 'review UX', 'check my site against best practices'. These cover a good range of natural user language.

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 standard name helps but the trigger terms are broad enough to cause potential conflicts.

2 / 3

Total

10

/

12

Passed

Implementation

64%

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 to an external guidelines source. Its main weakness is that it's almost entirely dependent on a successful external fetch with no fallback content, validation of the fetch, or error recovery steps. The actionability is moderate since the skill itself contains no concrete review logic or examples of expected output.

Suggestions

Add a fallback: include a brief inline summary of the top 5-10 most important guidelines rules so the skill remains useful if the fetch fails.

Add an error handling step: specify what to do if the WebFetch call fails (e.g., retry, use cached version, inform user).

Include a concrete example of expected output format (e.g., a sample `file:line` finding) so Claude knows exactly what to produce even before fetching.

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 or parsing the guidelines. The actual review logic is entirely deferred to the fetched content, making the skill itself somewhat abstract.

2 / 3

Workflow Clarity

Steps are listed and sequenced, 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 is unexpected. For a workflow that depends on an external fetch, error handling/fallback is important.

2 / 3

Progressive Disclosure

The skill is short and well-organized with clear sections, but it delegates nearly all substance to an external URL without any fallback summary of key rules. If the fetch fails, there's zero actionable content remaining. A brief inline summary of top rules or a cached reference would improve this.

2 / 3

Total

9

/

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