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.
A well-written routing and operations manual: concise, actionable, with a clear setup sequence and an explicit bounded verification loop. Its one real defect is that the progressive-disclosure layer it depends on — the reference/ directory of per-command playbooks, craft-floor, native, and routing files cited throughout the body and scripts — is not present in the bundle, breaking navigation in practice.
Suggestions
Ship the missing reference/ directory: the body cites 31 reference/*.md files (craft-floor.md, new-work.md, routing.md, operate.md, every per-command playbook, and the .native.md variants) but no reference/ or references/ directory exists in the bundle, so every 'See reference/X.md' link is broken and the skill's actual execution guidance is unavailable.
Verify referenced paths resolve at runtime: context.mjs loads reference/<platform>.md via SKILL_REFERENCE_DIR (safeRead silently returns null on missing files), so with the directory absent the native-platform guidance for ios/android/adaptive silently no-ops rather than failing loudly.
Trim the motivational intro paragraph ('Whereas before, your design work would have been safe, timid and measured...') to lift conciseness — it is rhetorical framing rather than operational guidance Claude needs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense operational prose that does not explain concepts Claude already knows (no 'what is a landing page' padding) and packs a lot of routing guidance per line. It is not a 5 because the rhetorical intro ('Whereas before, your design work would have been safe, timid and measured, you now approach every design task as a award-winning design director...') and a few wordy sentences are motivational padding that could be trimmed. | 4 / 5 |
Actionability | Concrete, executable commands are present ('node <skill-base-dir>/scripts/context.mjs', 'node .trae/skills/impeccable/scripts/pin.mjs <pin|unpin> <command>', '/impeccable hooks <on|off|status|...>', '/impeccable doctor') and the Commands table maps each verb to a reference. As an instruction-only skill the absence of code blocks is not penalized; it stops short of 5 because copy-paste-ready depth for each command is delegated to the reference files rather than carried inline. | 4 / 5 |
Workflow Clarity | Setup is a clean 3-step sequence and the body carries an explicit bounded verification loop ('Build fully, inspect once with a batched round (desktop and mobile together...), fix everything it shows in one batch, confirm with at most one more round, and stop polishing'), so validation is present rather than absent. It does not reach 5 because the detailed per-command checklists and feedback loops live in the reference files, so the body's own workflow detail is routing-level. | 4 / 5 |
Progressive Disclosure | The body is well structured as an overview pointing one level deep to reference/*.md files via a Commands table and inline links, with clearly signaled (not buried) navigation — which alone would read as a 4-5. But scored against the actual bundle structure per the rubric guideline, the referenced disclosure layer is missing: there is no reference/ directory, and none of the 31 cited reference/*.md playbooks exist in the bundle, so every navigation link is dangling and the disclosed content the skill needs to function is absent. | 3 / 5 |
Total | 15 / 20 Passed |