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 well-structured and token-efficient with excellent progressive disclosure, pointing cleanly to a real reference file. Its gaps are actionability and workflow clarity: no executable code in the body and no explicit validation checkpoint for verifying the schema output.
Suggestions
Include a minimal copy-paste-ready Organization JSON-LD snippet with a sameAs array directly in the body so the core action is executable without opening the reference.
Add an explicit validation checkpoint, e.g. "Validate with Google's Rich Results Test before deploying" as a final Fix/Verify step.
State how to confirm profile links resolve to active official accounts (e.g. check for non-404, recent activity) to close the verification gap noted in the Check section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — a one-line intro, four Quick Reference bullets, and short Check/Fix/Explain/Code Review sections — with no padding about what schema or E-E-A-T is, matching the every-token-earns-its-place anchor at 3 rather than the could-be-tightened anchor at 2. | 3 / 3 |
Actionability | Guidance names concrete specifics ("Organization / Person schema with a sameAs array containing ... LinkedIn, Twitter/X, Facebook") but the body itself contains no executable code, deferring all examples to references/rule.md, which fits the some-concrete-guidance-but-incomplete anchor at 2 rather than copy-paste-ready at 3. | 2 / 3 |
Workflow Clarity | The Check → Fix → Explain → Code Review structure gives a clear sequence, but there is no explicit validation checkpoint (e.g. run a structured-data validator), so it matches the steps-present-but-checkpoints-implicit anchor at 2 rather than the explicit-validation anchor at 3. | 2 / 3 |
Progressive Disclosure | The body is a concise overview with well-organized sections and a single clearly signaled one-level-deep pointer — "see references/rule.md" (a file that exists) — matching the clear-overview-with-one-level-references anchor at 3. | 3 / 3 |
Total | 10 / 12 Passed |