Content
71%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 highly actionable with concrete commands, a clear four-step workflow, and a useful pre-delivery checklist. Its weaknesses are an over-explanatory Python-install prerequisite section, a missing in-workflow validation loop, and a missing data directory that the scripts depend on.
Suggestions
Trim or remove the OS-by-OS Python installation instructions; assume Claude can install Python if missing, and reduce this to a single version check.
Add an explicit validation/feedback step within the generation workflow (e.g. verify the generated design-system output covers the requested product type before proceeding) rather than relying solely on the post-hoc checklist.
Ship the referenced `data/` CSVs (including `ui-reasoning.csv`) in the bundle or document where they live, since `core.py` resolves them relative to the script and they are required for the commands to run.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient with well-organized command examples, but the Prerequisites section walks through installing Python on macOS/Ubuntu/Windows — a concept Claude already knows — which is unnecessary padding, matching the score-3 anchor of mostly efficient with some unnecessary explanation. | 3 / 5 |
Actionability | It provides copy-paste-ready bash commands with concrete flags and a fully worked example query (e.g. `python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"`), covering the common cases per the score-5 anchor. | 5 / 5 |
Workflow Clarity | Steps 1-4 are clearly sequenced and the Pre-Delivery Checklist supplies a validation checkpoint, but the design-generation steps themselves lack an explicit validate-then-retry feedback loop, fitting the score-4 anchor of a clear sequence with most checkpoints present and minor validation gaps. | 4 / 5 |
Progressive Disclosure | Sections and tables are organized, but all reference content (domain/stack tables, common-rules tables, checklist) is inlined in a single ~310-line SKILL.md with no separate reference docs, and the CSV data files referenced by the scripts (e.g. `ui-reasoning.csv`, the `data/` directory) are absent from the bundle, matching the score-3 anchor of some structure with content that should be separate kept inline. | 3 / 5 |
Total | 15 / 20 Passed |