Content
81%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a strong operational manual: fully executable commands, an explicit required workflow with a persistence pattern, deterministic override-resolution rules, and a pre-delivery checklist for validation. Its main weaknesses are a padded Prerequisites section teaching Python installation, an Example Workflow that duplicates the main workflow verbatim, and reference-style rules/checklists inlined in SKILL.md that would fit better as a separate file.
Suggestions
Delete or compress the OS-by-OS Python installation instructions in Prerequisites — Claude already knows how to check for and install Python; a one-line check suffices.
Trim the Example Workflow to only what it adds (a concrete query string and the default-stack decision) instead of re-listing all four steps with repeated commands.
Move 'Common Rules for Professional UI' and the 'Pre-Delivery Checklist' into a reference file (e.g. references/checklist.md) and point to it, keeping SKILL.md lean; much of this content is also retrievable via the script's `ux` domain search.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Most of the body is dense, skill-specific value (command reference, domain/stack tables, do/don't rules, checklists) that Claude does not already know. But roughly a fifth of the file could be trimmed: the ~25-line Prerequisites section explains how to install Python per OS, which Claude already knows, and the Example Workflow section re-derives Steps 1-4 and repeats verbatim commands already shown in 'How to Use This Skill'. This matches anchor 3: 'Mostly efficient but includes some unnecessary explanation or could be tightened'. Not 2 because the padding is confined to two sections and the rest earns its tokens; not 4 because the redundant example workflow and OS-specific install instructions are more than 'minor instances'. | 3 / 5 |
Actionability | Every command is copy-paste ready with concrete flags and arguments, e.g. `python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"`, and the script (scripts/search.py) exists in the bundle with matching flags (--domain, --stack, --persist, --page, -f markdown). The 'When to use detailed searches' table maps each need to a domain with example keywords, and the Example Workflow covers a full common case end-to-end. This matches anchor 5: 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. Not 4 because there is no meaningful gap — commands, flags, domains, and stacks are all fully specified. | 5 / 5 |
Workflow Clarity | The sequence is explicit and well-ordered: analyze requirements → Step 2 (REQUIRED design-system generation) → Step 2b (persist with Master + page overrides, including the override-resolution logic) → Step 3 supplemental domain searches → Step 4 stack guidelines, followed by a Pre-Delivery Checklist that serves as an explicit validation gate before delivery. Tips #6 ('If first search doesn't match, try different keywords') provides a retry loop, and the hierarchical retrieval rules give deterministic page-vs-Master resolution. This matches anchor 5: 'Clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'. The operations are read-only searches (nothing destructive/batch), so the destructive-operation cap does not apply. Not 4 because both validation (checklist) and error recovery (iterate on keywords) are present. | 5 / 5 |
Progressive Disclosure | The bundle structure is sound: SKILL.md is an overview/workflow document, the 67 styles / 96 palettes / UX guideline data live behind scripts/ (search.py, core.py, design_system.py exist as referenced), so bulk data is never inlined — a good use of script-mediated disclosure with one-level-deep, clearly-signaled references and easy navigation via section headers. However, the ~75-line 'Common Rules for Professional UI' and 'Pre-Delivery Checklist' sections are reference material inlined in the always-loaded SKILL.md that could live in a separate reference file (they are also partially redundant with the `ux` domain data searchable via the script). This matches anchor 4: 'Good structure; most content is appropriately placed; references mostly clear; minor organization gaps'. Not 5 because those inline reference sections keep the main file heavier than a true lean overview; not 3 because nothing is deeply nested or buried and the split is otherwise appropriate. | 4 / 5 |
Total | 17 / 20 Passed |