Content
93%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 an exemplar of progressive enhancement instruction: a tight 8-step workflow, an explicit validation section with a runnable verify script and a static-state checklist, and all deep detail correctly deferred to a real, well-organized one-level-deep bundle. The only meaningful gap is the absence of an explicit fix-and-retry feedback loop for failed validation, which keeps workflow clarity at 4 rather than 5.
Suggestions
In the Validate section, add one line closing the feedback loop, e.g. 'If the verify script or build fails, fix the reported issue and re-run before reporting results.'
State the expected outcome of scripts/verify-cursor-trail.mjs (pass conditions or exit behavior) so a failure is immediately recognizable as a validation checkpoint rather than informational output.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is lean and imperative throughout: "Inspect the framework, rendering mode, existing motion stack, layer order, reduced-motion rules...", "Keep the six shader nodes, their order, both invisible drivers, and both ID linkages exact", "Unmount when the section leaves view so GPU work stops." Every line is a directive carrying information Claude could not infer; there is no explanation of concepts Claude already knows. This matches the anchor 'Lean and efficient; assumes Claude's competence; every token earns its place'. It is not a 4 because there is no identifiable over-explanation or padding to trim. | 5 / 5 |
Actionability | Guidance is concrete and executable: exact install subpaths ("shaders/react", "shaders/vue", "shaders/svelte", "shaders/solid"), copyable templates in assets/react/ (verified present: CursorTrailShader.tsx, CursorTrailGate.tsx, cursor-trail.css), and a fully-specified verify command with all three file arguments. This matches the anchor 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases'. It is not a 4 because no key execution detail is left to the reader beyond the obvious path substitution. | 5 / 5 |
Workflow Clarity | The 8-step workflow is clearly sequenced (inspect → install → read reference → copy templates → place layer → gate loading → preserve fallback → adapt) and the Validate section adds explicit checkpoints: lint, typecheck/tests, production build, the verify script, and a checklist of static-state conditions ("JavaScript unavailable, keyboard access..., reduced motion, unsupported WebGPU, focus/visibility cleanup"). This sits between anchors: stronger than 4's 'most checkpoints present; minor validation gaps' because the checkpoints are explicit and checklist-form, but short of 5's 'feedback loops for error recovery' — the body never states what to do when the verify script or build fails (fix-and-retry is only implicit in the detailed reference). Per the boundary guidance this is an above-midpoint fit, so 4. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview that pushes all implementation detail into well-signaled, one-level-deep bundle files: "Read [references/implementation.md](references/implementation.md) before implementation" (verified: a 92-line contract covering graph, layering, gates, validation), "copy and adapt the files in assets/react/", and the scripts/verify-cursor-trail.mjs invocation. All referenced paths exist exactly as named. This matches the anchor 'Clear overview with well-signaled one-level-deep references; content appropriately split; easy navigation'. It is not a 4 because no implementation content that belongs in the bundle is inlined and every reference is explicit and linked. | 5 / 5 |
Total | 19 / 20 Passed |