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 actionable, with a clean routing table, concrete install and cost commands, and a good MCP pre-flight check. Its weaknesses are time-sensitive version/date detail in the body that penalizes conciseness, and a batch cost-guardrail workflow missing validation checkpoints, which caps workflow clarity at 3.
Suggestions
Move the pinned version and "Package check (2026-07-10)" date-sensitive lines out of the body (they already exist in the compatibility frontmatter field) or into a clearly labeled section, instead of repeating them in the intro.
Add a validation checkpoint to the batch cost workflow, e.g. compare the estimate against a budget threshold and abort/confirm with the user before running, then verify actual cost against the estimate afterwards.
Trim the redundant restatement of the tested version ("via the tested @ahrefs/mcp@0.0.11 server") and the seo-dataforseo comparison line to tighten token usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean, but time-sensitive information penalizes conciseness per the guidelines: "Live Ahrefs data via the tested `@ahrefs/mcp@0.0.11` server" plus "Package check (2026-07-10): verify the current Ahrefs MCP package source before changing this tested version" repeat a pinned version and a specific date outside any 'old patterns'/'deprecated' section, and "This is the same workflow the seo-dataforseo skill uses" could be trimmed. This matches 'Mostly efficient but includes some unnecessary explanation or could be tightened' rather than 4, which requires only minor trimmable instances and no misplaced time-sensitive data. | 3 / 5 |
Actionability | Concrete, executable guidance dominates: install commands ("Run `extensions/ahrefs/install.sh` (Linux/macOS) or `install.ps1` (Windows)"), a specific cost-estimate command ("`${CLAUDE_PLUGIN_ROOT}/scripts/claude-seo` run dataforseo_costs.py"), and a routing table mapping exact commands to outputs. As an instruction-only skill this matches 'Mostly executable guidance; concrete code or commands with minor gaps' — not 5 because actual Ahrefs MCP tool invocation details and the batch command forms are only implied. | 4 / 5 |
Workflow Clarity | The MCP-availability pre-flight check is a good checkpoint, but the batch workflow ("Before running a batch (>= 50 URLs): 1. Estimate cost... 2. Surface the estimate... 3. Log actual cost") lacks any validation/verification step — no budget threshold to compare against, no abort/confirm decision point, and no actual-vs-estimate feedback loop. Per the guidelines, a batch operation without validation caps workflow clarity at 3, which takes precedence over the simple-skill exception; it stays at 3 rather than 2 because the sequence itself is clearly listed. | 3 / 5 |
Progressive Disclosure | The body is under 50 lines with no content that belongs in separate files: five well-organized sections (Prerequisites, Routing, Output conventions, Cross-skill delegation, Cost guardrails) each stay lean, and the few external pointers (install scripts, cost-tracker script, sibling skills) are one level deep and clearly signaled. Per the guidelines, a sub-50-line skill with no need for external references scores 5 with well-organized sections; nothing here is buried or nested. | 5 / 5 |
Total | 15 / 20 Passed |