Content
92%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 well-engineered instruction-only skill: a gated 7-phase workflow with mode detection, validation, feedback loops, and concrete paths/commands throughout, with formats correctly delegated to five real one-level-deep reference files. The only trim opportunity is minor duplication around the mechanical-CRUD referral and small inline templates.
Suggestions
State the `nicolify-ux-designer` referral once (e.g., in Mode Detection) and drop the repeats in the role section and Common Mistakes to save tokens.
Compress the persona_summary and problem_statement code blocks into one-line descriptions of the fields, since the reference templates already cover format details.
Add one tiny inline HTML preview skeleton (doctype + CDN script + one Shadcn-style card) so the Phase 5 preview step is copy-paste ready without consulting a reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational content (paths, gates, mode tables) with essentially no explanation of concepts Claude already knows, fitting 'efficient; minor instances of over-explanation that could be trimmed'. The recommendation to defer mechanical CRUDs to `nicolify-ux-designer` appears three times (role section, Mode Detection table, Common Mistakes), and the persona_summary/problem_statement blocks are slightly padded. Not score 5 because of these minor redundancies; not score 3 since nothing is unnecessary explanation, just light duplication. | 4 / 5 |
Actionability | Every phase carries concrete, executable guidance: literal glob patterns ('frontend/src/features/{domain}/components/**/*.tsx', 'frontend/src/components/ui/*.tsx'), copy-paste Spanish question scripts, an exact HTML preview recipe ('/tmp/ux-preview-{timestamp}.html', 'https://cdn.tailwindcss.com', 'xdg-open'), and specified output formats deferred to real reference files. This is an instruction-only skill and the guidance is fully actionable with common cases covered, matching the score-5 anchor. | 5 / 5 |
Workflow Clarity | The 7 phases are explicitly sequenced with a Quick Reference table, mode detection before entry, hard gates ('Do NOT proceed to Phase 2 without answers to at least questions 1 and 2'), a Phase 7 verification step (globbing real component names before writing the spec), back-navigation feedback loops ('volvamos a las propuestas'), and a Common Mistakes checklist — matching the score-5 anchor of clear sequence, explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | The body is a workflow overview that loads five real, one-level-deep reference files on demand at specific phases ('Load `references/proposal-format.md` and `references/ascii-mockup-guide.md` with `Read`'), all of which exist in the bundle; cross-references inside the reference files point only to sibling files, so there is no 2+ level nesting. Bulk formats (proposal format, ASCII conventions, UI-SPEC template, tokens) are appropriately split out, matching the score-5 anchor. | 5 / 5 |
Total | 19 / 20 Passed |