Content
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-organized, token-efficient overview that structures a complex analysis into a clear framework, scoring model, sequenced workflow, and failure patterns, with scoring detail correctly pushed to a single one-level-deep reference. Its main weakness is actionability and workflow rigor: the data-gathering and intent-validation steps stay abstract, and the workflow lacks explicit output-validation checkpoints.
Suggestions
Add concrete Ahrefs MCP tool calls (or the specific endpoints/fields) for the data-pulling step — e.g., which keyword report and top-pages calls to run per property — so the workflow is executable rather than descriptive.
Insert an explicit validation/checkpoint step in the workflow that verifies the output spreadsheet contains all nine output-format sections before hand-off, with a fix-and-retry loop for missing sections.
Specify how intent is validated concretely (e.g., classify the top-10 SERP result types using the rubric's intent table) inside the workflow rather than leaving step 5 as 'confirm the SERP intent matches'.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence — no explanations of what SEO or search volume are — and uses token-efficient tables for the gap matrix, scoring weights, and banding. Every section (framework, scoring, workflow, failure patterns, output) earns its place, fitting the 'every token earns its place' anchor rather than the padded level-2 case. | 3 / 3 |
Actionability | The scoring formula and banding tables are concrete and the referenced rubric adds worked examples, but the workflow steps are high-level ('Pull keyword data', 'Validate intent') with no Ahrefs MCP tool names or specific data-pulling procedure, leaving key execution details unspecified. This matches 'some concrete guidance but incomplete; missing key details' rather than fully executable level 3. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced with a defined deliverable, but it lacks explicit validation checkpoints or feedback loops on outputs (e.g., verifying the spreadsheet contains all nine output sections or re-validating the scored list). Per the batch-operation guidance this caps at level 2 despite the clear sequence. | 2 / 3 |
Progressive Disclosure | The body is an overview that offloads the detailed scoring rubric to a real one-level-deep reference file (references/opportunity-scoring-rubric.md, confirmed present), signaled both inline in workflow step 6 and in a dedicated 'Reference files' section. Content is appropriately split with easy navigation, matching the level-3 anchor. | 3 / 3 |
Total | 10 / 12 Passed |