Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-organized, concise overview that uses progressive disclosure effectively to hand off detail to references/rule.md. Its main gaps are that the body itself offers no example disclosure text or markup and no in-body verification checkpoint.
Suggestions
Include one short copy-paste disclosure snippet or example phrasing directly in the Fix section so the body is self-sufficient for the common case.
Add a brief in-body verification step (e.g., "Confirm the disclosure renders in the DOM before affiliate links via view-source or a crawl") rather than leaving all verification to the reference.
Tighten the "Explain" section from a meta-instruction ("Explain the legal and ethical importance...") into a concise ready-to-use rationale.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean with short purposeful sections (Quick Reference, Check, Fix, Explain, Code Review) and only a single brief contextual sentence; it assumes Claude's competence without over-explaining SEO basics. | 3 / 3 |
Actionability | It gives concrete placement directives ("Place the disclosure at the top of the page, before any affiliate links appear") but provides no example disclosure wording or markup in the body, deferring specifics to the reference. | 2 / 3 |
Workflow Clarity | The Check→Fix→Explain→Code Review sequence is clear, but the body lacks explicit validation/verification checkpoints, which are only present in the referenced file. | 2 / 3 |
Progressive Disclosure | A concise overview body cleanly signals a single one-level-deep reference ("see `references/rule.md`") that exists on disk, with the rule page URL also linked. | 3 / 3 |
Total | 10 / 12 Passed |