Content
78%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.
A lean, well-structured instruction-only skill: concrete file paths, a clearly sequenced procedure with an input-confirmation checkpoint and a hard stop, and appropriately inline content with no bundle files needed. The main gaps are the confusing "template at ux_ui_map/pages/{page}.md" reference in step 3 and the absence of any handling for missing inputs or post-write verification.
Suggestions
Fix step 3's wording: either point to a real template file (e.g. ux_ui_map/templates/page.md) or say "write the page doc at ux_ui_map/pages/{page}.md with these sections: ..." — currently the output path is mislabeled as a template.
Add a one-line fallback for missing inputs, e.g. "If any screenshot or the request JSON is missing, note it in the doc's Screenshot table rather than skipping the page silently."
Trim the "Example prompt that should trigger this skill" section or the "When to use" section — they largely duplicate the frontmatter description.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and instructional throughout — crisp rules ("Descriptive only: do not judge, do not recommend, do not assign severity") and a tight 4-step procedure with no padding or explanation of concepts Claude already knows. It is not 5 because the "When to use" and "Example prompt that should trigger this skill" sections substantially duplicate the frontmatter description, and not 3 because there is no unnecessary explanation beyond that redundancy. | 4 / 5 |
Actionability | Concrete input paths (ux_ui_map/requests/{page}.json, screenshots/{page}/desktop|tablet|mobile.png), a specified output (ux_ui_map/pages/{page}.md), and an enumerated output structure (Overview, ASCII layout diagram, Screenshot table, Regions) make the guidance mostly executable. It is not 5 because step 3's "using the template at ux_ui_map/pages/{page}.md" confusingly names the output file as a template (no template file exists), and a short example doc snippet would remove ambiguity. | 4 / 5 |
Workflow Clarity | The procedure is a clearly sequenced 4-step workflow with an input checkpoint ("Load the request JSON to confirm route and expected screenshot paths"), an inspection order (desktop first, then tablet/mobile), and a hard stop ("Stop after writing this one page"). It is not 5 because there are no error-recovery steps (e.g. what to do if a screenshot or request JSON is missing) and no post-write verification, and not 3 because one explicit checkpoint and an unambiguous sequence are present. | 4 / 5 |
Progressive Disclosure | The skill is ~35 lines with no bundle files (no references/, scripts/, or assets/ directories exist) and no external references to verify; all content fits inline in well-organized, clearly headed sections (When to use, Inputs, Output, Rules, Procedure, Example). Per the rubric's simple-skill guideline, a sub-50-line skill with no need for external references scores 5 with well-organized sections alone. | 5 / 5 |
Total | 17 / 20 Passed |