Content
65%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 well-structured and uses progressive disclosure effectively by deferring all code to a single real reference file. The main gaps are the absence of executable code and explicit validation checkpoints in the body itself.
Suggestions
Add one small inline code snippet (e.g. an aria-busy spinner) so the body is executable without forcing a reference hop for the common case.
Turn the Check/Fix flow into a short numbered sequence with an explicit 'verify in DevTools/Lighthouse → fix → re-measure' validation loop.
Remove the opening restatement of why loading indicators matter (or trim it), since it duplicates references/rule.md and explains a concept Claude already knows.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with well-organized sections and mostly assumes Claude's competence. It loses a point because the opening sentence restates a concept Claude already knows and is duplicated verbatim in references/rule.md. | 4 / 5 |
Actionability | The body names concrete specifics (aria-busy, aria-live, aria-valuenow, skeletons vs spinners) but contains no executable code itself — all code lives in the reference file. Guidance is actionable at a high level but incomplete for direct execution in the body. | 3 / 5 |
Workflow Clarity | Check/Fix/Explain/Code Review provide a rough sequence, but there are no numbered steps or explicit validation checkpoints. The Code Review section hints at measurement but lacks a validate→fix→retry loop, so it does not reach 4. | 3 / 5 |
Progressive Disclosure | The body is a concise overview with a single, clearly signaled one-level-deep reference to a real references/rule.md file. Navigation is easy and content is appropriately split, matching the top anchor. | 5 / 5 |
Total | 15 / 20 Passed |