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".
Install with Tessl CLI
npx tessl i github:tibelf/ai_project_init --skill web-design-guidelines84
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation for skill structure
Discovery
89%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 well-structured skill description with excellent trigger term coverage and clear completeness. The main weakness is the specificity dimension - while it identifies the domain well, it could benefit from listing concrete review actions (e.g., 'checks accessibility, validates responsive design, audits color contrast'). Overall, this description would perform well in skill selection scenarios.
Suggestions
Add 2-3 specific concrete actions to improve specificity, e.g., 'Reviews accessibility compliance, validates responsive layouts, checks color contrast and typography'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (UI code, Web Interface Guidelines) and implies the action (review/compliance checking), but doesn't list multiple specific concrete actions like 'check color contrast, validate ARIA labels, audit navigation patterns'. | 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). The structure follows the recommended pattern. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural user phrases: 'review my UI', 'check accessibility', 'audit design', 'review UX', 'check my site against best practices' - these are terms users would naturally say when needing this skill. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focusing specifically on Web Interface Guidelines compliance and UI/UX review. The combination of 'UI code', 'accessibility', 'design audit', and 'best practices' creates a distinct profile unlikely to conflict with general code review or other skills. | 3 / 3 |
Total | 11 / 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 skill is concise and well-structured for its simple purpose, appropriately delegating rule details to an external source. However, it lacks concrete examples of the WebFetch tool usage and output format, and missing error handling for fetch failures reduces workflow robustness.
Suggestions
Add a concrete example showing WebFetch tool invocation syntax (e.g., `WebFetch(url="https://...")`)
Include a brief example of the expected output format rather than fully delegating to fetched content
Add guidance for handling fetch failures (e.g., 'If fetch fails, inform user and ask to retry or provide cached guidelines')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, avoiding unnecessary explanations. It assumes Claude knows how to fetch URLs and read files, providing only the essential workflow and source URL. | 3 / 3 |
Actionability | The skill provides a clear workflow but lacks concrete executable examples. It references 'WebFetch' without showing exact usage, and the output format is delegated entirely to the fetched guidelines rather than providing a concrete example. | 2 / 3 |
Workflow Clarity | Steps are listed clearly (fetch, read, check, output), but there's no validation checkpoint or error handling guidance. What happens if the fetch fails or guidelines are unavailable is not addressed. | 2 / 3 |
Progressive Disclosure | For a simple skill under 50 lines, the structure is appropriate. It provides a clear overview with the essential information inline, and appropriately delegates detailed rules to the external source URL. | 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.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- 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.