Content
75%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.
A well-structured, actionable analytical skill body with a clear framework, scoring formula, sequenced workflow, and appropriate external reference. Main improvements are naming the specific Ahrefs MCP tool calls and de-duplicating the scoring formula between the body and the reference file.
Suggestions
Specify the exact Ahrefs MCP tool names and key parameters used to pull organic keywords, top pages, and traffic estimates, so Claude can execute the data-pulling step without guessing.
Remove the duplicated opportunity-score formula and action-banding table from the body, keeping only a brief summary and pointing to references/opportunity-scoring-rubric.md for the full detail.
Add an explicit validate->fix->retry feedback loop for the batch scoring step (e.g., re-score when intent matching drops keywords or when KD is overridden by SERP inspection).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and table-driven, assuming SEO competence without explaining basics; the only trimming opportunity is the generic "If required data is unavailable" boilerplate paragraph, which is otherwise efficient. | 4 / 5 |
Actionability | Concrete actionable guidance via an explicit scoring formula, weights, normalization bands, a 10-step workflow, and an output spec; the notable gap is that Ahrefs MCP usage is named but the specific MCP tool calls and parameters are not specified. | 4 / 5 |
Workflow Clarity | A clearly sequenced 10-step workflow with embedded validation checkpoints (confirm competitor SERP overlap, validate intent) and a sanctioned-gap handling section; lacks explicit validate->fix->retry feedback loops for the batch scoring operation, a minor gap. | 4 / 5 |
Progressive Disclosure | Well-organized body with section headers and a single well-signaled one-level-deep reference (references/opportunity-scoring-rubric.md, which exists); minor organization gap is that the opportunity formula and banding table are duplicated between the body and the reference file. | 4 / 5 |
Total | 16 / 20 Passed |